MLDS (version 0.5.1)

runQuadExperiment: 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)

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.

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.

Author

Kenneth Knoblauch and Laurence T. Maloney

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.

Examples

##This will start a 330 trial interactive experiment
##  of quadruples
if (FALSE) {
	runQuadExperiment("DisplayOneQuad", "DefineMyScale")
	}
##This will run 10 trials of an interactive experiment
##  of triads
if (FALSE) {
	runTriadExperiment("DisplayOneTriad", 
		"DefineMyScale", NumTrials = 10)
	}