Trial Conditions

There are many conditions that define the behaviour of a set of trials. All time values are in seconds, and all distance values are fractions of the screen height (i.e. a line of length 1.0 in these units would extend from the bottom to the top of the screen).

  • Repetitions
    • The number of times the trial should be repeated

    • The trial will be repeated this many times (unless the maximum time is exceeded)

    • Default: 1

  • Maximum time, 0=unlimited (secs)
    • The maximum time allowed to complete all repeats of these trial conditions

    • If zero, there is no time limit

    • If a trial is in progress when time runs out it is stopped early and no data is recorded for this trial

    • Default: 0

  • Number of targets
    • The number of outer targets to display

    • Default: 8

  • Target order
    • The order in which targets should be activated

    • Can be clockwise, anti-clockwise, random, or fixed

    • If fixed, the order is determined by the supplied “Target indices” (see next item)

    • Default: clockwise

  • Target indices
    • An ordered list of target ids to display, separated by spaces

    • Target ids go clockwise starting from 0 at the top of the circle

    • This is only used if fixed is chosen for “Target order”

    • Default: 0 1 2 3 4 5 6 7

  • Add a central target
    • Enable to show a central target between each outer target

    • Default: enabled

  • Hide target when reached
    • Enable to hide a target once the cursor has reached it

    • Default: enabled

  • Turn target green when reached
    • Enable to paint the target green once the cursor has reached it

    • Default: disabled

  • Display target labels
    • Enable to show a label inside each target

    • The labels are taken from “Target labels” (see below)

    • Default: disabled

  • Target labels
    • The label to display in each target, separated by spaces

    • Default: 0 1 2 3 4 5 6 7

  • Fixed target display intervals
    • Enable to display a new target at fixed intervals

    • The interval is given by “Target display duration” below

    • The interval is not affected by the cursor reaching the target or not

    • If enabled, “Central target display duration” and “Delay between targets” are ignored

    • Default: disabled

  • Target display duration (secs)
    • How long each outer target should be displayed for

    • Default: 5.0

  • Central target display duration (secs)
    • How long each central target should be displayed for

    • Default: 5.0

  • Delay before outer target display (secs)
    • The delay before each outer target is displayed

    • Default: 0.0

  • Delay before central target display (secs)
    • The delay before each central target is displayed

    • Default: 0.0

  • Extra delay before first outer target of condition (secs)
    • An additional delay before the first outer target is displayed for this set of conditions

    • Default: 0.0

  • Distance to targets (screen height fraction)
    • The distance from the centre of the screen to the outer targets

    • Default: 0.4

  • Target size (screen height fraction)
    • Diameter of outer targets

    • Default: 0.04

  • Central target size (screen height fraction)
    • Diameter of central targets

    • Default: 0.02

  • Show inactive targets
    • Enable to make inactive targets visible (but greyed out)

    • Default: enabled

  • Ignore cursor hitting incorrect target
    • Enable to ignore when a cursor reaches an incorrect/inactive target

    • If disabled, when the cursor reaches any target the task will proceed to the next target

    • Default: enabled

  • Play a sound on target display
    • Enable to play an audible sound when a target is displayed

    • Default: enabled

  • Control the cursor using a joystick
    • Enable to use a joystick to control the cursor

    • If disabled, the mouse will be used instead

    • Default: disabled

  • Maximum joystick speed (screen height fraction per frame)
    • The maximum distance the cursor can move in a single frame

    • Multiply by the monitor refresh rate (fps) to get the speed in screen height fraction per second

    • The refresh rate is often 60fps, but some gaming monitors can have much higher refresh rates.

    • Default: 0.02

  • Show cursor
    • Enable to display a cursor at the current cursor location

    • Default: enabled

  • Cursor size (screen height fraction)
    • The size of the cursor

    • Default: 0.02

  • Show cursor path
    • Enable to display the path the cursor took

    • Default: enabled

  • Automatically move cursor to center
    • Enable to automatically move the cursor to the center after reaching an outer target

    • Default: disabled

  • Freeze cursor until target is displayed
    • Enable to freeze the cursor until a target is displayed

    • Default: disabled

  • Cursor rotation (degrees)
    • Rotate the cursor direction anticlockwise by this number of degrees

    • Default: 0.0

  • Delay between trials (secs)
    • How long to wait after each trial

    • Default: 0.0

  • Display results after each trial
    • Enable to display results for the trial after each trial

    • Default: disabled

  • Delay after last trial (secs)
    • How long to wait after the last trial with these trial conditions

    • Default: 10.0

  • Display combined results after last trial
    • Enable to display combined results for these trial conditions after the last trial

    • Default: enabled

  • Display a countdown during delays
    • Enable to display a countdown in seconds while waiting between trials

    • Default: enabled

  • Skip delay by pressing enter key
    • Enable to allow the user to skip a delay between trials by pressing the enter key

    • Default: enabled