README.md

In fsotoc/grtools: General Recognition Theory tools for the analysis of perceptual independence

grtools

R package for the analysis of perceptual independence using general recognition theory.

grtools provides functions for the following analyses:

1. Model-based analyses of separability and independence with GRT-wIND (Soto et al., 2015) for the 2x2 identification experiment.
2. Model-based analyses of separability and independence with traditional GRT models for the 2x2 identification experiment (Ashby & Soto, 2015).
3. Summary statistics analysis (i.e. Kadlec's MSDA; see Kadlec & Townsend, 1992) for the 2x2 identification experiment.
4. Summary statistics analysis for the 2x2 Garner filtering task (Ashby & Maddox, 1994).

A tutorial introduction to GRT analyses using grtools can be found in this Frontiers In Psychology paper. Please use the following reference when you report analyses performed using grtools:

Soto, F. A., Zheng, E., & Ashby, F. G. (2017). Testing separability and independence of perceptual dimensions with general recognition theory: A tutorial and new R package (grtools). Frontiers in Psychology, 8:696.

Note that this package is still under development. We welcome your comments, feature requests, bug reports, etc.

Installation

Of course, you will need R, which you can download here. It is also a good idea to install RStudio, which you can download here.

1. Installing pre-requisites

grtools requires Rcpp to work, which in turn requires a development environment with a suitable compiler. If you already have this, go to step 2.

If you do not have a C++ compiler installed, see the Rcpp FAQ, particularly points 1.2 and 1.3. More detailed instructions on how to install the compiler can be found here for Mac OS X, and here for Windows.

2. Installing grtools

The easiest way to install grtools and its dependencies is using devtools. Open RStudio or R, and in the console type:

install.packages("devtools")
devtools::install_github("fsotoc/grtools", dependencies="Imports")

After installation, type the following in the R console:

library(grtools)
?grtools

This will open a document that includes links to help documentation for each of the main analyses included in grtools (including examples). Sometimes the command ?grtools produces an error instead of displaying the documentation. Simply quitting and re-opening R typically solves this problem.

References

Ashby, F. G., & Maddox, W. T. (1994). A response time theory of separability and integrality in speeded classification. Journal of Mathematical Psychology, 38(4), 423-466.

Ashby, F. G., & Soto, F. A. (2015). Multidimensional signal detection theory. In J. R. Busemeyer, J. T. Townsend, Z. J. Wang, & A. Eidels (Eds.), Oxford handbook of computational and mathematical psychology (pp. 13-34). Oxford University Press: New York, NY.

Kadlec, H., & Townsend, J. T. (1992). Signal detection analyses of multidimensional interactions. In F. G. Ashby (Ed.), Multidimensional models of perception and cognition (pp. 181–231). Hillsdale, NJ: Erlbaum.

Soto, F. A., Musgrave, R., Vucovich, L., & Ashby, F. G. (2015). General recognition theory with individual differences: A new method for examining perceptual and decisional interactions with an application to face perception. Psychonomic Bulletin & Review, 22(1), 88-111.

Soto, F. A., Zheng, E., & Ashby, F. G. (2017). Testing separability and independence of perceptual dimensions with general recognition theory: A tutorial and new R package (grtools). Frontiers in Psychology, 8:696.

fsotoc/grtools documentation built on Nov. 15, 2020, 5:14 a.m.