opiStaticStimulus: Stimulus parameter list

View source: R/opiStaticStimulus.r

opiStaticStimulusR Documentation

Stimulus parameter list

Description

List containing stimulus parameters with an S3 class attribute of opiStaticStimulus

Usage

"See details"

Details

The list should be of class opiStaticStimulus and contain the following elements.

  • x coordinate of the center of stimulus in degrees relative to fixation

  • y coordinate of the center of stimulus in degrees relative to fixation

  • image an image to display in a machine specific format

  • level stimulus level in cd/\mbox{m}^2 (ignored if !is.na(image))

  • size diameter of target in degrees, or scaling factor for image if specified

  • color machine specific stimulus color settings (ignored if !is.na(image))

  • duration total stimulus duration in milliseconds maximum responseWindow time (>= 0) in milliseconds to wait for a response from the onset of the stimulus presentation

  • ... machine-specific parameters

SimHenson and SimGaussian

Only level is used.

Duration and location are ignored, color is assumed "white" and size is assumed to be 26/60 (Goldmann III).

Octopus 900

x and y are in degrees, with precision to one decimal place recognised.

image is not possible on an Octopus 900.

level is in cd/\mbox{m}^2, and is rounded to the nearest one tenth of a dB for display.

color is ignored. Use opiSetBackground() to alter stimulus color

checkFixationOK is a function that takes the return value from opiPresent and returns either TRUE, indicating that fixation was good for the presentation; or FALSE, indicating that fixation was not good for the presentation.

Octopus 900 F310 Controller

As for the Octopus 900, but a responseWindow of -1 means that the Octopus 900 server will wait until either the L and R button is pressed in the controller until returning.

Kowa AP7000

x and y are in degrees. (precision?)

image is not possible on an Kowa AP 7000.

level are in cd/\mbox{m}^2 in the range 0.03 to 3183, nearest one tenth of a dB for display.

size is in degrees, but is rounded to the nearest Goldmann Size I..V for display.

color one of .OpiEnv$KowaAP7000$COLOR_WHITE, .OpiEnv$KowaAP7000$COLOR_GREEN, .OpiEnv$KowaAP7000$COLOR_BLUE, and .OpiEnv$KowaAP7000$COLOR_RED.

imo

x, y, level, size, and color are not used.

image is a list of two matrices: the first for the right eye, the second for the left. Each image is a 1080x1080 matrix with each element in the range 0 to 80, which maps onto 0dB to 40dB in steps of 0.5dB. Thus 0 is 0dB, 3283.048 cd/\mbox{m}^2; 1 is 0.5dB; and 80 is 40dB, 10 cd/\mbox{m}^2.

tracking is TRUE if auto image placement to keep pupil centred is used, or FALSE to turn off imo auto-image placement to keep centred on pupil.

Compass

x and y are in degrees (floating point) (range -30 to 30 inclusive).

level is in cd/\mbox{m}^2, and is rounded to the nearest whole dB for display (range 0 to 50). 0dB is 10000aps.

responseWindow is in millliseconds (range 0 to 2680). Parameter duration is assumed to be 200ms, size is assumed to be Goldmann III (0.43), and color is assumed to be white.

See Also

opiSetBackground, opiKineticStimulus, opiTemporalStimulus

Examples

stim <- list(x=9, y=9, image=NA, 314, size=0.43, color="white",
             duration=200, responseWindow=1500)
class(stim) <- "opiStaticStimulus"

OPI documentation built on Nov. 7, 2023, 9:06 a.m.