rtplots: Creates a 'rtplots' Object

In rettopnivek/rtplots: Plotting functions for simple choice and response time data.

Description

Creates a 'rtplots' object from a data frame of response time and choice/accuracy data, allowing for subsequent plotting.

Usage

rtplots(df, label = NULL, keep = NULL, type = "CDF", level = NULL, ...)

is.rtplots(x)

Arguments

df	a data frame that includes (at a minimum) a column of response times.
label	a character string giving the column name for the response time variable, and optionally the choice/accuracy variable, a grouping factor variable (e.g., subjects), and finally an additional covariate (e.g., conditions). If NULL, the algorithm will attempt to locate response time and choice/accuracy variables via a set of default names.
keep	a logical vector, indicating which rows should be kept when extracting the variables.
type	the type of function to compute. Options are CDF: the cumulative distribution function. QPE: the quantile function. PDF: the probability density function. PVT: probability versus time.
level	an optional index indicating the specific level of the grouping factor to consider. This allows, for instance, selecting a single subject.
...	additional parameters for the density, distribution, and quantile functions.

Details

Forthcoming

Value

An object of class 'rtplots', a list consisting of...

• pd; a data frame with the x and y values to plot and their associated choice/accuracy value.

• xm; If relevant, a matrix whose columns contain the individual x-axis values of the function which were collapsed over the grouping factor.

• ym; If relevant, a matrix whose columns contain the individual y-axis values of the function which were collapsed over the grouping factor.

• npfd; a data frame with the number of observations, proportions, and frequencies based on the choice/accuracy values.

• type; the type of function that was applied.

• x; the range of x-axis values.

• y; the range of y-axis values.

References

Forthcoming

Examples

# Load in example dataset
data("priming_data")
lbl = c( 'RT', 'Accuracy', 'Subjects' )
keep = priming_data$Condition == 0
obj = rtplots( priming_data, label = lbl, keep = keep )

rettopnivek/rtplots documentation built on May 27, 2019, 5:55 a.m.