View source for Contributions:ANTTask

==Synopsis==
The main purpose of this task is to present sequential visual stimuli to the user of the BCI system. The subject will be shown an arrow on the screen pointing either to the left or to the right. On some trials, the arrow will be flanked by two arrows to the left and two arrows to the right. The subject's task is to respond to the direction of the CENTRAL arrow, press the left mouse button with the left thumb if the central arrow points to the left, or press the right mouse button with the right thumb if the central arrow points to the right.

In some trials, there will be asterisk cues indicating when or where the arrow will occur. If the cue is at the center or both above and below fixation it indicates that the arrow will appear shortly. If the cue is only above or below fixation it indicates both that the trial will occur shortly and where it will occur. 

==Timeline==
<gallery mode="packed" widths=500px heights=400px>
File:ANT_wiki_1.jpg|Figure 1: ANT task timeline.
</gallery>

==Versioning==
===Authors===
Huiling Huang (huiling@neurotechcenter.org)

===Version History===
*2022-05-04: Initial public release by Huiling Huang (huiling@neurotechcenter.org)

==Parameters==
===EyeOpenTextDuration, EyeCloseTextDuration===
Duration of introduction of eyes open/close.

===TimerValueOpen, TimerValueClose===
Duration of eyes open/close.

===TrialDuration===
Duration of one trial.

===FirstFixationDurationMin, FirstFixationDurationMax===
Minimum/Maximum duration of First Fixation phase.

===CueDuration===
Duration of cue.

===MiddleFixationDuration===
Duration of Middle Fixation phase.

===ReactionTimeMin, ReactionTimeMax===
Minimum/Maximum duration of reaction time.

===CueIconList===
List of cue images path.

===TargetMatrix===
Matrix of target images path.

===BlockSequence===
The sequence of the number of trials in each experiment block.

===PracticeBlockSize===
The number of trials in practice block.

===EnableEyeOpenOrClose===
Enable or disable the countdown timer at the beginning of the experiment.

===CrossToCueDistance===
The distance between fixation cross and cue in relative coordinates (between 0 and 1).

===CrossToTargetDistance===
The distance between fixation cross and target in relative coordinates (between 0 and 1).

===CrossWidth, CrossHeight===
The width/height of fixation cross in relative coordinates (between 0 and 1).

===CueWidth, CueHeight===
The width/height of cue in relative coordinates (between 0 and 1).

===TargetWidth, TargetHeight===
The width/height of target in relative coordinates (between 0 and 1).

===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==
===PhaseNumber===
The index of phase in each trial. (8 bits)
1: First fixation; 2: Cue; 3: Middle Fixation; 4: Target; 5: Last fixation.

===TrialNumber===
Index of trials. (16 bits)

===FirstFixationDuration===
List of the duration of first fixation phase in each trial. (32 bits)

===ReactionTime===
List of reaction time in each trial.(32 bit)

===LastFixationDuration===
List of the duration of last fixation phase in each trial. (32 bits)

===BlockNum===
Index of experiment block.

===TargetDirection===
1: pointing left; 2: pointing right.

===FlankerDirection===
1: pointing left; 2: pointing right.

===TargetLocation===
1: low; 2: high.

===CueLocation===
1: low; 2: high; 3: middle; 4 = there was/is/will be no cue on this trial.

===CueVisible===
0: cue is not visible right now; 1 = cue is visible right now.

===TargetVisible===
0: cue is not visible right now; 1: cue is visible right now.

==See also==
[[Contributions:Applications]]
[[Category:Contributions]][[Category:User Application]]