Elo-ratings for pairwise comparisons of visual stimuli
elochoice(winner, loser, kval = 100, startvalue = 0, runs = 1, normprob = FALSE)
eloint(winner, loser, allids, kval, startvalues, runs)
elointnorm(winner, loser, allids, kval, startvalues, runs)
character, vector with the IDs of the winning (preferred) and losing (not preferred) stimuli
character, vector with the IDs of the winning (preferred) and losing (not preferred) stimuli
numeric, k-value, which determines the maximum number of points a stimulus' rating can change after a single rating event, by default 100
numeric, start value around which ratings are centered, by default 0
numeric, number of randomizations
logical, by default FALSE
, which indicates that a logistic approach is taken for calculating winning probabilities (see Elo 1978). Alternatively (TRUE
), such that winning probabilities are calculated from a normal distribution
numeric, start value around which ratings are centered, by default 0
internal, character of all stimulus IDs in the data set
an object of class elochoice
, i.e. a list with the following items
numeric matrix with final ratings for each stimulus, one row per randomization
logical matrix showing for each randomization (row) and each single rating event (column) whether or not there was an expectation for that trial, i.e. whether the two stimuli's ratings differed before the rating
logical matrix showing for each randomization (row) and each single rating event (column) whether or not the outcome of a trial was in the direction of the expectation, i.e. whether or not the higher rated stimulus won
numeric matrix showing for each randomization (row) and each single rating event (column) the absolute difference in ratings before the rating event
various information
data set overview, i.e. in how many trials was a stimulus involved and how many trials did each stimulus win and lose
character matrix, with the original sequence of rating events
elochoice()
is the workhorse function of the package, which wraps up all the calculations for obtaining Elo-ratings and the information for the reliability index
eloint()
and elointnorm()
are internal functions (which elochoice()
makes use of) that do most of the calculations, but are usually not directly addressed by the user.
elo1978EloChoice
clark2018EloChoice
# NOT RUN {
data(physical)
set.seed(123)
res <- elochoice(winner = physical$Winner, loser = physical$Loser, runs = 100)
summary(res)
ratings(res, show = NULL, drawplot = TRUE)
# }
Run the code above in your browser using DataLab