ratings: indiviual stimulus ratings
In EloChoice: Preference Rating for Visual Stimuli Based on Elo Ratings

Description Usage Arguments Details Value Author(s) Examples

get stimulus ratings and/or a summary plot

1	ratings(x, show = "mean", drawplot = TRUE)

`x`	an object of class `"elochoice"`, usually the result of a call to `elochoice`
`show`	character, what values should be returned, see below
`drawplot`	logical, should a plot drawn

If show="original", show="mean" or show="var", a numeric vector is returned which contains either the ratings obtained from the initial/original sequence, the average ratings across all randomizations, or the total variance.

If show="range" or show="all", a matrix is returned that contains either the range of ratings across all randomizations, or all ratings of all randomizations.

If you simply want to create the plot without any rating output being generated, use show=NULL.

If drawplot=TRUE, a plot is created that depicts the values of the ratings obtained from the initial sequence (red), the mean ratings across all randomizations (black) and the range of ratings across all randomizations.

numeric vector or matrix, and/or a plot

Christof Neumann

xdata <- randompairs(nstim = 10, nint = 100)
x <- elochoice(xdata$winner, xdata$loser, runs = 10)

# ratings from the initial sequence
ratings(x, "original", drawplot = FALSE)

# range of ratings across all randomizations
ratings(x, "range", drawplot = FALSE)

# and producing plot
ratings(x, NULL, drawplot = TRUE)