runQuadExperiment: Start and run a Difference Scale Experiment

View source: R/runQuadExperiment.R

runQuadExperimentR Documentation

Start and run a Difference Scale Experiment

Description

Runs a difference scaling experiment displaying stimuli with the function DiplayTrial defined by the function DefineStimuli.

Usage

runQuadExperiment(DisplayTrial, DefineStimuli, NumTrials = NULL,
 	DisplaySize = 7.5, aspect = 1, ...)
runTriadExperiment(DisplayTrial, DefineStimuli, NumTrials = NULL,
 	DisplaySize = 3.5, aspect = 1, ...)
runSampleExperiment(DisplayTrial, DefineStimuli)

Arguments

DisplayTrial

character giving the name of a function to display a trial with triple or quadruple of stimuli.

DefineStimuli

character giving the name of a function that defines the set of stimuli from which triples or quadruples are drawn.

DisplaySize

numeric giving the overall size of the display on the screen.

NumTrials

integer giving the number of trials to display. If NULL (the default), the number is computed on the basis of the size of stimulus set designated by DefineStimuli.

...

currently unused

aspect

numeric giving the height/width ratio of the display on the screen.

Details

These functions are to demonstrate how to run a difference scaling experiment. Helper functions DisplayOneQuad or DisplayOneTriad and DefineMyScale permit running the perception of correlation experiment, sample data from which are provided as datasets, (see kk). runSampleExperiment is defunct and replaced by these functions.

Value

An object of class ‘mlds.df’ or ‘mlbs.df’, depending on the experiment run, is returned. Each inherits from ‘data.frame’ and has attributes ‘stimulus’ and ‘invord’. See kk for an example.

Author(s)

Kenneth Knoblauch and Laurence T. Maloney

Examples

##This will start a 330 trial interactive experiment
##  of quadruples
## Not run: 
	runQuadExperiment("DisplayOneQuad", "DefineMyScale")
	
## End(Not run)
##This will run 10 trials of an interactive experiment
##  of triads
## Not run: 
	runTriadExperiment("DisplayOneTriad", 
		"DefineMyScale", NumTrials = 10)
	
## End(Not run)

MLDS documentation built on Aug. 20, 2023, 9:06 a.m.