simulate_comparisons: Simulate contests from the Bradley-Terry Model

View source: R/simulate_contests.R

simulate_comparisonsR Documentation

Simulate contests from the Bradley–Terry Model

Description

This function simulates pair-wise contests according to the Bradley–Terry model. It require the true quality of the areas and the number of comparisons to be carried out. It can also include some judge noise or error. When including noise, each time a judge carries out a comparisons, we assume they use the true quality with some zero-mean normal noise added. The standard deviation must be specified.

Usage

simulate_comparisons(n.contests, true.quality, sigma.obs)

Arguments

n.contests

The number of contests to be carried out

true.quality

A vector with the level of deprivation in each object on the log scale.

sigma.obs

Standard deviation for the noise to be added to the level of deprivation in each object. If 0, no noise is used.

Value

A list containing a data.frame with each pair-wise contest, the outcome (a 1 for a win, a 0 for a loss), and a win matrix where the i,j^th element is the number of times i beat j

Examples


example.deprivation <- -2:2 #True level of deprivation in each object
example.comparisons <- simulate_comparisons(10, example.deprivation, 0)
#generate comparisons with judge noise.
example.comparisons <- simulate_comparisons(10, example.deprivation, 0.1)

BSBT documentation built on Aug. 9, 2022, 5:06 p.m.