Contest Data

From ICPC-Contest Control Standard

Contest Data

DRAFT

On this wiki there are several overlapping documents (e.g. CCS spec, event feed, and REST proposal) that have overlapping and sometimes conflicting ideas of what contest data is. They often have different names, different formats, or different data types. This page is an attempt to list all of the data in one place and create an ontology of contest data. Once we have a full list and agreement here, we'll need to go back and update any conflicting info in the other documents to match.

After which this header should be rewritten. :)

Contest

Notes:

- (ID) indicates a unique id field

Info

Name Description Type Example
name the name string 38th Annual World Finals of the ACM International Collegiate Programming Contest
short-name a shorter name string ACM-ICPC World Finals
start-time the start of the contest string (local time with UTC timezone offset) 2014-06-25 10:00+1
duration the length of contest string (HH:MM:SS) 05:00:00
scoreboard-freeze-length how long the scoreboard freezes before the end of the contest string (HH:MM:SS) 01:00:00
penalty the penalty time for an incorrect answer, in minutes integer 20

Info is a singleton (i.e. no id field)

Languages

Name Description Type Example
id (ID) a unique id integer 1
name language name string Java

Problems

Name Description Type Example
id (ID) a unique id integer 1
label a 1-2 char label string A
name problem name string The baggage problem
short-name a short name string baggage
color a color name string purple
rgb the color value in hex string (#FFFFFF) #60008C

Problem information is not available until the contest has started.

Groups

Name Description Type Example
id (ID) a unique id integer 7
external-id an external id for the group integer 7593
name the group name string Africa and the Middle East

Teams

Name Description Type Example
id (ID) a unique id integer 72
external-id an external id for the team integer 201433
name the team name string Shanghai Jiao Tong University
university the team's university string The University of Tokyo
group the team's group string Asia
nationality the team's nationality string, 3 letter ISO country code JPN

Judgements

Name Description Type Example
id (ID) a unique id integer 15
acronym a short acronym for the judgement string PE
name the judgement name string Presentation Error
penalty whether this judgement causes a penalty boolean true

Submissions

Name Description Type Example
id (ID) a unique id integer 187
language the language used in the submission string C++
problem the problem id integer 4
team the team id that made the submission integer 19
time the contest time of this submission double 5042.406224
timestamp the wall clock time of this submission double 1403673842.41

Submissions Judgements

Name Description Type Example
id (ID) a unique id that matches a submission integer 187
solved the language used in the submission boolean true
judgement the judgement id integer 4
time the contest time of this judgement double 5042.406224
timestamp the wall clock time of this judgement double 1403673842.41

Judgements are not visible outside of blue zone during the freeze. Judgements sent to balloons are currently different.

Clarifications

Name Description Type Example
id (ID) a unique id integer 5
question the question string Problem H: Does bouncing up means bounce to the grid above the current one?
team the team id that submitted the clarification integer 4
answer the judgement id integer 4
to-all true if the answer was sent to all teams boolean false
time the contest time of this submission double 5042.406224
timestamp the wall clock time of this submission double 1403673842.41

Testcases

To-do

  29
  <judged>True</judged>
  <judgement_id>118</judgement_id>
  <n>46</n>
  <result>AC</result>
  <run-id>118</run-id>
  <solved>True</solved>
  
  <timestamp>1403672764.95</timestamp>

Testcase information is not visible to contest floor