Contributions:EglyDriverTask

Synopsis

Timeline

Figure 1: Single trial timeline.

Figure 2: Trial types

Visual Representation

Versioning

Authors

Huiling Huang (huiling@neurotechcenter.org) implemented the paradigm into BCI2000.

titration rule

In titration task, we use 3-down-1-up to adjust the contrast: decrease the contrast by one degree if 3 consecutive correct responses happens. Increase the contrast by one degree if 1 incorrect response happens.
In the main task:
1. Start with the first 15 trials:

Record accuracy for the initial 15 match trials.
Calculate the average accuracy of these trials.
Adjust the contrast based on the computed average.

2. Ongoing updates with a sliding window:

After every set of 5 new trials:
Incorporate these 5 new trials into the dataset.
Remove the oldest 5 trials from the sequence.
Recalculate the average accuracy of the updated 15-trial window.
Adjust the contrast accordingly.

This process continues for every subsequent batch of 5 trials.

Parameters

PushButtonType

We provide 3 sources of pushbuttons: DC, analog, and keyboard.
DC and analog: the push button is directly connected to the amplifier; the delay is minor and can be ignored. Please confirm the variable name where the PushButtom is stored with the experimenter. The variable name varies with the channel that the push button connects to through the amplifier.
keyboard: usually has tens of milliseconds delay.

FixationColor, BarColor, CueColor, TargetColor

The color of the fixation, bar, cue, target.

BarThick

The thickness of the bar. range [0,1]

FixationWidth

The width of the fixation cross. range [0,1]

CueThick

The thickness of the cue. range [0,1]

TargetWidth

The width of the target. range [0,1]

FixationDurationMin, FixationDurationMax

Minimum/Maximum duration of the fixation phase.

BarDurationMin, BarDurationMax

Minimum/Maximum duration of the bar phase.

CueDuration

Duration of cue.

CueToTargetDurationMin, CueToTargetDurationMax

Minimum/Maximum interval time between cue and target.

TargetDuration

Duration of target.

PostTargetResponseTime

The maximum time allows the subject to respond after the target disappears.

FeedbackDuration

Duration of the feedback

TotalTrial

Number of the total trials.

CatchTrialPerctg

The percentage of the catch trial(no target)(%). range [0,100]

CueTgtMatchPerctg

The percentage of the cue matches the target trial(%). range [0,100]

CueTgtSmObjctPerctg

The percentage of the target mismatches the cue, on the same object(%). range [0,100]

CueTgtDifObjctPerctg

The percentage of the target mismatches the cue, on the different objects(%). Set as 0 when it is a simplified task. range [0,100]

ScreenWidth, ScreenHeight

Width/height of the monitor screen in cm.

EyeToSreenDistance

Distance from the subject's eyes to the screen in cm.

VisualAngle

The degrees of visual angle. range [0,360]

AdjustContrastBy

Adjust the contrast of the target color by: 0 overall accuracy, 1 match accuracy, 2 non-match accuracy.

AdjustContrastTrialNum

The number of trials needed to calculate the accuracy for adjusting the contrast.

AdjustContrastUpdateTrialNum

The number of update trials needed to calculate the accuracy for adjusting the contrast.

AccuracyUp

The up boundary of the accuracy. range [0,1]

AccuracyLow

The low boundary of the accuracy. range [0,1]

Simplified

Enable the simplified version, only has two squares rather than two bars.

SquareLength

The lenght of square in simplified version. range [0,1]

IsStairCase

Enable the Staircase.

DownCounts

Contrast decreases one step following the number of consecutive correct trials.

UpCounts

Contrast increases one step following the number of consecutive incorrect trials.

ProgressBar

Display progress bar.

ProgressBarHeight, ProgressBarWidth

Progress bar height/width in pixels.

ProgressBarBackgroundColor, ProgressBarForegroundColor

Color of progress bar background/foreground.

PhotoDiodePatch

Display a photo diode patch on the stimulus window. Recording from a photo diode located on that patch will allow triggering on actual stimulus delivery (see User_Reference:P3TemporalFilter#OnsetExpression).

PhotoDiodePatchHeight, PhotoDiodePatchWidth

Photo diode patch height/width in relative coordinates (between 0 and 1).

PhotoDiodePatchLeft, PhotoDiodePatchTop

Photo diode patch left/top position in relative coordinates (between 0 and 1).

PhotoDiodePatchShape

Photo diode patch shape: 0 rectangle, 1 ellipse.

PhotoDiodePatchActiveColor

Photo diode patch color when active (RGB color in format 0xrrggbb).

PhotoDiodePatchInactiveColor

Photo diode patch color when inactive, (RGB color in format 0xrrggbb, use 0xff000000 for transparent).

States

KeyDown, KeyUp, DCXX, PushButton

Recording when the subject is pushing or releasing the button.

We provide 3 sources of pushbuttons: DC, analog, and keyboard. DC and analog: The push button is directly connected to the amplifier, so the delay is minor and can be ignored. Please confirm the variable name where the PushButtom is stored with the experimenter. The variable name varies with the channel the push button connects to through the amplifier. Usually, the variable name begins with "DC"; for example, "DC02", the number "02" is the channel ID.
Keyboard: This usually has a tens of millisecond delay. When a key is pressed, "KeyDown" will be set to the key's virtual key code at the corresponding sample position. When a key is released, the key code will be written into the "KeyUp" state variable.

We also have a backup State called "PushButton." It registers when the software detects the keyboard or button push or release. There is a delay after the software detects the response, so the backup "PushButton" happens later than the actual keyboard or button response. You only need the backup "PushButton" when the "DCXX" or "KeyDown" is not available for some reason.

PhaseNumber

The index of phase in each trial. (8 bits) 0: none; 1: Beginning of the trial; 2: Fixation; 3: Bar; 4: Cue; 5: Cue to target; 6: Target; 7: Post target response; 8: Feedback.

TrialNumber

Index of trials. (16 bits)

BarDirection

Main task: 1: Vertical; 2: Horizontal.
Simplified task: 1: LeftTop; 2: RightTop; 3: RightBottom; 4: LeftBottom.

CuePosition, TargetPosition

1: LeftTop; 2: RightTop; 3: RightBottom; 4: LeftBottom.

TrialType

1: no target, catch trial;
2: cue target match;
3:cue target don't match, on the same object;
4: cue target don't match, on the different object;

FixationDuration

Duration of the phase Fixation by the number of blocks.

BarDuration

Duration of the phase Bar by the number of blocks.

CueToTargetDuration

Duration of the phase CueToTargetDuration by the number of blocks.

TargetColor

The color of the target. Represent in decimal numbers.

Response

1: correct.
2: incorrect

Photodiode

The Photodiode is stored in the .bat file, and the name begins with "DC". For example, "DC03", the number after "DC" represents the channel number, because the photodiode is directly connected to the amplifier, the name depends on the hardware connection. Please confirm the name of the Photodiode with the experimenter before starting the analysis.
We also have a backup State called "Photodiode". It registers when the software sends the command to hardware to present the stimulus or whenever we need to flash the photodiode. Between the software sending the command to the hardware actual response, there are roughly about 20 ms delays. So the backup "Photodiode" happens earlier than the actual photodiode flashes. You only need the backup Phtodiode when the "DCXX" is not available for some reason.

1: active;
2: non-active