The Competition Data Standard

Note: This is an experimental feature.

The data standard

The IRW competition data standard is meant to describe data derived from pairwise comparisons or competitions. Such data are widely analyzed using ELO or Bradley-Luce-Terry approaches; more information about these approaches is available here. The key distinction between these data and the conventional IRW data is that there are not id and item identifiers here but rather identifers of the two agents that are involved in a given competition.

  • agent_a name/id of first competitor
  • agent_b name/id of second competitor
  • date Time of the data point in UNIX format.
  • homefield Indicator of agent that had advantage based on game features (e.g., where game was played, who played first, etc).
  • score_a Score of agent_a.
  • score_b Score of agent_b.
  • winner Winner of the competition (typically based on a comparison of scores). Values will be agent_a, agent_b or draw.

Accessing the competition data

The competitions data can be easily accessed via the irw R package:

Code 
# Install and load the package
devtools::install_github("itemresponsewarehouse/Rpkg")
library(irw)

# View available competition data
irw::irw_list_tables(comp=TRUE)

# Fetch competition data
df <- irw::irw_fetch("collegefb_2021and2022", comp = TRUE)
head(df)

Documentation related to the tables (including table names as with collegefb_2021and2022) can be found here.