Procedures

In Psykinematix, procedures are events that specify the trial properties in terms of the subject’s task, response options, auditory feedback, etc. Procedure events also execute the stimulus events, wait for the subject’s responses in each trial, and sent back these responses to the calling Method event if this information is required to set up the next trial.

Psykinematix implements several standard procedures:

n-Forced Choice (nFC)
Yes/No
Discrimination
Adjustment

The procedure and trial properties can be customized through the:

Procedure Options
Trial Properties
Specifying Inputs

To create a new psychophysical procedure, create a new event in the Experiment Design Panel, set its category to "Procedure", and display its properties by clicking on the "Info" icon (or press ⌘I). Once a procedure has been selected, changing the procedure by clicking on other tabs is disabled unless the Control key is pressed simultaneously. This is to prevent accidental changes because procedure settings are then reset to default.

The properties panel for the procedure events is divided into three areas:

In the hierarchical representation of the experiment displayed in the "Design Panel", procedure events accept nodes of the following categories:

n-Forced Choice

In an n-forced choice procedure the subject is presented with n stimuli either simultaneously in a spatial arrangement for a n-alternative forced choice (nAFC) or sequentially in a temporal arrangement for a n-interval forced choice (nIFC). The subjects provide their response by indicating the position or interval of the target stimulus with the corresponding input via keyboard key or mouse button (see the Specifying Inputs section). A correct response is always associated with the detection of the stimulus with the highest value for the judged parameter (ie: the dependent variable).

The nFC procedure can be customized to specify:

The spatial presentation includes the spatial configuration (ie: the way the screen is split to display each stimulus alternative) and the distance of each alternative to the display center. For the spatial presentation, it is also possible to measure reaction times during a nAFC task. Note that stimuli kept as fixation (see Onset Settings) are excluded from the multiple instances of the same stimulus in a spatial nAFC. The available spatial configurations are:

Finally the system-defined variables [NFCINDEX] and [NFC] contain the index of each spatial or temporal stimulus instance and the index of the current target instance in the n-Forced Choice procedure, respectively. These could be used to customize the appearance of each instance or to report the procedure target position to an external device for example.

Note: You may refer to lesson 1 of the Orientation Discrimination tutorial as it uses a 2IFC procedure to specify the subject's task.

Yes/No

In a yes/no procedure, the subject is presented with a single stimulus; they then provide their response via keyboard key or mouse button (see the Specifying Inputs section) by indicating whether the stimulus corresponds to the specified criterion described in the table (ie: Yes correlated with...). The criterion is based on a logical combination of variables: the AND operator ("&") to indicate that all variables are different from 0, the OR operator ("|") to indicate that at least one variable is different from 0.

The yes/no procedure can be customized to specify:

If the expression table is left empty, the yes/no/ procedure does not rely on a correct/incorrect paradigm but on a subjective decision instead. Such a subjective yes/no procedure can then be used with a method of constant stimuli to estimate a point of subjective equivalence (PSE).

Note that it is also possible to measure reaction times during a yes/no task.

Discrimination

The discrimination procedure is a common variant of the n-alternative forced choice (nAFC), where the subject is presented with one stimulus per trial (instead of n) and where the alternatives are in the n responses the subject can choose from to indicate which type of trial was presented (for example, left/right directions in a motion discrimination task). The response is therefore either correct or not with a chance level for correctly guessing of 100/n %. Note, however, that the two procedures differ in that the subject does not directly judge the stimulus parameter whose threshold is measured in a discrimination task, contrarily to the nAFC.

The decision choice associated with each response is defined in the table (ie: Correlated with Expression) by indicating a set of expressions and their expected values. These expressions can be logically combined with the AND operator ("&") to indicate that all expressions should be equal to the specified values, and with the OR operator ("|") to indicate that at least one expression should be equal to the specified value. The subject provides their response via keyboard key or mouse button (see the Specifying Inputs section) by indicating one of the choice inputs that matches the stimulus properties.

The discrimination procedure can be customized to specify:

Multiple responses are supported in a discrimination task (for example when the subject has to indicate changes in the perception associated with stimuli rivalry in the same trial). Note that it is also possible to measure reaction times.

Note: You may refer to lessons 1 of some tutorials (Visual Acuity, Contrast Sensitivity) as they each use a discrimination procedure to specify the subject's task.

Adjustment

In Psykinematix paradigm the adjustment is not a procedure per se, but actually a method. It is presented here as a procedure because it is the subject who directly controls the value of the dependent variable (stimulus level). The method of adjustment requires the subject to alter the level of the stimulus until it is just barely detectable against the background noise in detection experiments, or until it is the same as the level of another stimulus in matching experiments. With their response via keyboard key or mouse button (see the Specifying Inputs section), the subject indicates whether the stimulus level should be increased ('+' input), decreased ('-' input), or whether the adjustment should be stopped ('!' input).

The adjustment method can be customized to specify:

Step sizes can be expressed either as a single value or as a list of values separated by a backslash \ (e.g., '50\25\12'). For a non-adaptive adjustment, the method starts with the first step size (e.g., 50%), then uses the next ones after each stop response (!) (e.g., 25% after 1st stop, and 12% after 2nd stop). The last step size is then used until the terminating stop response. If a single value specifies the step size, the first stop response simply terminates the non-adaptive procedure. For an adaptive adjustment, the method starts with the first step size (e.g., 50%), then uses the next ones after each reversal (e.g., 25% after 1st reversal, and 12% after 2nd reversal). The last step size is then used until all reversals have occurred.

Note that neither the reaction time measurement nor the pedestal is available during an adjustment task.

Procedure Options

For some procedures it is possible to apply a pedestal value to the judged stimulus parameter, or to specify a random pre-stimulus duration when measuring reaction times. These additional properties are specified in the bottom left-hand TabView.

Reaction Times: To measure the subject's reaction times, the "Collect RT" button box must be checked and the mean and range of the pre-stimulus duration must be specified as either a uniform or Gaussian distribution. Reaction time measurement is only available to the spatial nAFC, yes/no, and discrimination procedures.

Pedestal: A pedestal level can be applied (added) to the stimulus parameter the subject is judging, and can be specified as a uniform or Gaussian distribution with its mean and range. To date pedestal can only be applied to the spatial and temporal nAFC, and adjustment procedures. Note that both mean and range values can be specified using variables and mathematical expressions.

Multiple Responses: Multiple responses may be collected during a single trial. This is needed for example when the subject has to indicate changes in the perception associated with stimuli rivalry occurring during a trial. The total duration, number of changes and the swapping statistics in terms of mean and standard deviation of the duration can be reported for each response. One can also specify whether the change detection is based on a press/release cycle or simply on press events.

Intervals: It may be sometimes necessary to create explicitly two intervals in random order associated with standard and test stimuli rather than relying on Psykinematix' n-Forced Choice procedure. This setting is only available to the yes/no procedure with the option to add an inter-stimulus interval between the standard and test stimuli.

 

Trial Properties

Common to all procedures, the right-hand side of the panel specifies the settings for each trial of the procedure regarding:

  • what input device the subject uses to provide their response (only connected & enabled devices should appear in the popup menu, see the Response Devices & Input/Output Preferences)

  • whether the response should be provided in the post-stimulus period only

  • whether the response ends the stimulus presentation or trial

  • whether providing a response is limited in time and the duration of this response period

  • whether the response is considered as incorrect if none is provided

  • whether an auditory indicator is played before presenting each stimulus

  • whether auditory feedback is provided for the subject's response

  • whether a fixation mark is presented during the stimulus interval (See Control Settings in the Experiment Panel)

  • whether a temporal contrast modulation is applied to each stimulus during each interval of the trial with the duration for the flat and and on-off components

  • the duration for the inter-stimulus (ISI) and inter-trial (ITI) intervals

Several types of temporal modulation are available (Square, Gaussian, Triangle, Raised Cosine) and their shape is controlled by 2 parameters: one that specifies the duration of the on & off ramps, and another that specifies the duration of an optional flat zone between the on & off ramps. Total duration of the trial is equal to "flat+2*ramp" if a temporal modulation is applied, except for the Gaussian modulation for which the trial duration is equal to "flat+2*3*sigma" (where sigma defines a ramp with a 99.7% coverage). If you want your stimulus to be fully modulated, make sure its duration is similar to the trial duration.

Specifying Inputs

Each procedure includes a set of controls, highlighted in red below, that specify which response the subject should provide as a function of each decision. The stepper control between the decision indicator (Index for nFC or discrimination; 'Yes|No|Not Sure' for yes/no; '+|-|!' for adjustment) and the input text field allow the user to browse through the available decisions for the procedure.

The text field can either be edited to specify the response the subject should provide to indicate their decision, or automatically filled in by selecting one of the entries available through the attached pop-up menu. The pop-up menu either contains previously used inputs or gets filled in based on the device selection in the trial settings on the right-hand side of the panel. By separating them with a comma, several responses can be specified for the same decision. The table below provides a list of inputs available for each supported input device (for more details about the supported devices, see the Response Devices & Input/Output Preferences or the "Supported External Devices" chapter).

DEVICES INPUT CODES
KEYBOARD  
standard keys a-z, 0-9
arrow keys right_arrow, left_arrow, up_arrow, down_arrow
modifier keys left_shift, right_shift, left_control, right_control, left_option, right_option, left_apple, right_apple
special keys sb (SPACE BAR), esc (ESCAPE), del (DELETE), return
keypad keys 0-9_keypad, enter_keypad, period_keypad
KEYPAD  
standard keys 0-9_keypad, enter_keypad, period_keypad
MOUSE  
standard buttons 'Left Button', 'Right Button', 'Middle Button'
JOYSTICK/GAMEPAD  
buttons 'Button 1' to 'Button16'
BUTTON BOX
 
standard keys 'Key 1' to 'Key 8'
oriented buttons 'Left Button', 'Right Button', 'Middle Button', 'Top Button', 'Bottom Button'
special signals TTL, TA (Trial Alarm)

Note that keyboard and keypad inputs can be specified by using either lowercase or uppercase as they refer to the physical keyboard keys.

Examples:

Keyboard input: a,z,LEFT_ARROW, 1_KEYPAD, 4_KEYPAD, 7_KEYPAD

© 2006-2024 KyberVision Japan LLC. All rights reserved.