ratings: indiviual stimulus ratings

Description Usage Arguments Details Value Author(s) Examples

View source: R/ratings.R

Description

get stimulus ratings and/or a summary plot

Usage

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

Arguments

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

Details

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.

Value

numeric vector or matrix, and/or a plot

Author(s)

Christof Neumann

Examples

1
2
3
4
5
6
7
8
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)

EloChoice documentation built on May 30, 2017, 1:55 a.m.