Skip to contents

Build EloChoice comparison data from pairwise results

Source: R/elo_model.R
build_elo_data.Rd

This function converts pairwise comparison results into the two-column format used by the EloChoice package: one column for the winner and one for the loser of each trial.

Usage

build_elo_data(results)

Arguments

results

A data frame or tibble with either ID1/ID2/better_id or A_id/B_id/better_id.

Value

A tibble with two columns:

  • winner: ID of the winning sample

  • loser: ID of the losing sample

Rows with invalid or missing better_id are dropped.

Details

It accepts either:

  • legacy columns ID1, ID2, better_id, or

  • canonical columns A_id, B_id, better_id.

Rows where better_id does not match either side of the pair (including NA) are excluded.

Examples

results <- tibble::tibble(
  ID1       = c("S1", "S1", "S2", "S3"),
  ID2       = c("S2", "S3", "S3", "S4"),
  better_id = c("S1", "S3", "S2", "S4")
)

elo_data <- build_elo_data(results)
elo_data
#> # A tibble: 4 × 2
#>   winner loser
#>   <chr>  <chr>
#> 1 S1     S2   
#> 2 S3     S1   
#> 3 S2     S3   
#> 4 S4     S3