Jump to content

Contributions:Human Association Task (HAT): Difference between revisions

From BCI2000 Wiki
← Older edit
Jchuang (talk | contribs)
31 edits
Jchuang (talk | contribs)
31 edits
 
(23 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Synopsis ==
== Synopsis ==


HAT studies how the brain forms mental associations between things and adapts those associations when the environment changes. It combines uncertain sensory evidence, a brief memory delay and learning from feedback, allowing these processes to be studied during iEEG recording.
HAT studies how the brain forms mental associations between things, and adapts those associations when the uncertain environment changes. It combines uncertain sensory evidence, a brief memory delay and learning from feedback, allowing these processes to be studied during iEEG recording.


Participants judge whether a moving dot cloud contains more red or blue dots. After a delay, they choose a car, dog or tree image using the current color-category association; feedback helps them discover when that association has changed.
Participants judge whether a moving dot cloud contains more red or blue dots. After a delay, they choose a car, dog or tree image using the current color-category association; feedback helps them discover when that association has changed.
Documentation scope: Behavior and screen examples follow the available protocol 6.0 reference. Parameter values come from a recorded protocol 6.2 configuration, not the defaults of every installed build.


=== The association, not the individual picture ===
=== The association, not the individual picture ===
Line 22: Line 20:


== Session Flow ==
== Session Flow ==
 
<div style="clear: both; height: 24px;"></div>
[[File:HAT_Session_Flow.png|thumb|center|900px|alt=Guided session in order: Video 1 then basic association practice; Video 2 then switch practice with an announcement and then without one; Video 3 then the main task with scheduled breaks, followed by completion.|Figure 1. Guided preparation in the reference task. Basic practice can be repeated. In the main task, association changes are not announced.]]
[[File:HAT_Session_Flow.png|thumb|center|600px|alt=Guided session in order: Video 1 then basic association practice; Video 2 then switch practice with an announcement and then without one; Video 3 then the main task with scheduled breaks, followed by completion.|Figure 1. Guided session flow. Basic practice can be repeated. In the main task, association changes are not announced.]]
<div style="clear: both; height: 24px;"></div>


An on-screen association hint supports the start of unannounced practice and the main task, then fades. Participants continue using feedback to guide their choices.
An on-screen association hint supports the start of unannounced practice and the main task, then fades. Participants continue using feedback to guide their choices.
Line 31: Line 30:
Participants view a gray screen with stimuli near the center. At choice onset, one image from each category appears; the Up, Left and Right arrow keys select the corresponding screen position.
Participants view a gray screen with stimuli near the center. At choice onset, one image from each category appears; the Up, Left and Right arrow keys select the corresponding screen position.


[[File:HAT_Reference_Task_Display.png|thumb|center|900px|alt=Full reference task frame at choice onset. Tree is above, car is lower left and dog is lower right near screen center. A photodiode patch is at the left edge and the Shift pause label is at bottom right.|Figure 2. Full task canvas, uniformly reduced. Figures 2-3 use the protocol 6.0 C++ task with the standalone renderer and supplied 256 x 256-pixel images. The white edge patch is a timing marker.]]
[[File:HAT_Reference_Task_Display.png|thumb|center|700px|alt=Full task frame at choice onset. Tree is above, car is lower left and dog is lower right near screen center. A photodiode patch is at the left edge and the Shift pause label is at bottom right.|Figure 2. Full task display, uniformly reduced. Figures 2 and 3 were captured from the standalone C++ task using the supplied 256 x 256-pixel images. The white edge patch is a timing marker.]]


[[File:HAT_Reference_Stimulus_Details.png|thumb|center|900px|alt=Three equal central crops from the same trial: a red-majority dot cloud, three category choices, and an enlarged car image while the left response is held.|Figure 3. Enlarged views from one trial, using identical central crop bounds and magnification. Dots disappear before choices appear. Holding a response key enlarges that image; no elements have been repositioned.]]
<div style="clear: both; height: 24px;"></div>


Recorded display settings: 452 dots; red RGB [199, 72, 50], blue RGB [77, 123, 161]. ImageSizePixels = 70 and SelectedImageScale = 1.5 give a 70-pixel base image and a 105-pixel selected image. Source-image resolution is separate from on-screen size.
[[File:HAT_Reference_Stimulus_Details.png|thumb|center|500px|alt=Three equal central crops from the same trial: a red-majority dot cloud, three category choices, and an enlarged car image while the left response is held.|Figure 3. Enlarged views from one trial, using identical central crop bounds and magnification. Dots disappear before choices appear. Holding a response key enlarges that image; no elements have been repositioned.]]
<div style="clear: both; height: 24px;"></div>
 
Display settings in the documented configuration: 452 dots; red RGB [199, 72, 50], blue RGB [77, 123, 161]. ImageSizePixels = 70 and SelectedImageScale = 1.5 give a 70-pixel base image and a 105-pixel selected image. Source-image resolution is separate from on-screen size.


== Single-Trial Timeline ==
== Single-Trial Timeline ==
<div style="clear: both; height: 24px;"></div>
[[File:HAT_Trial_Timeline.png|thumb|center|600px|alt=Trial order and requested timings: fixation 500 ms; moving dots 500 ms; delay 1600 ms; choice up to 5000 ms; confirmed choice 150 ms; intertrial interval 900 to 1100 ms. A 100 ms response hold occurs inside the choice window.|Figure 4. Single-trial sequence and requested timings for the listed configuration; boxes are not to time scale. The 100 ms key hold occurs within the choice window.]]
<div style="clear: both; height: 24px;"></div>


[[File:HAT_Trial_Timeline.png|thumb|center|900px|alt=Trial order and requested timings: fixation 500 ms; moving dots 500 ms; delay 1600 ms; choice up to 5000 ms; confirmed choice 150 ms; intertrial interval 900 to 1100 ms. A 100 ms response hold occurs inside the choice window.|Figure 4. Requested timings in the recorded protocol 6.2 profile; boxes are not to time scale. The 100 ms key hold occurs within the choice window.]]
The fixation marker remains during the delay. With the listed settings, a confirmed choice stays visible for 150 ms, followed by the intertrial interval (ITI). Correct and incorrect responses request distinct feedback sounds at ITI entry; a timeout skips confirmation and receives no feedback sound.
 
In the reference task, the fixation marker remains during the delay. With the listed settings, a confirmed choice stays visible for 150 ms, followed by the intertrial interval (ITI). Correct and incorrect responses request distinct feedback sounds at ITI entry; a timeout skips confirmation and receives no feedback sound.


== Practice and Association Switching ==
== Practice and Association Switching ==
Line 48: Line 51:


{| class="wikitable"
{| class="wikitable"
! Reference practice !! Progression
! Practice stage !! Progression
|-
|-
| After Video 1 || Red-car / blue-dog; finish after 7 correct responses in total.
| After Video 1 || Red-car / blue-dog; finish after 7 correct responses in total.
Line 57: Line 60:
|}
|}


In the reference task, the initial hint begins fading during ITI after 2 consecutive correct responses in unannounced practice and the main task. Errors and timeouts reset streaks, but preserve total correct counts. Stage changes follow ITI. Practice does not count toward the main-task limit.
The initial hint begins fading during ITI after 2 consecutive correct responses in unannounced practice and the main task. Errors and timeouts reset streaks, but preserve total correct counts. Stage changes follow ITI. Practice does not count toward the main-task limit.


=== Main-task criterion ===
=== Main-task criterion ===


The recorded profile uses a 70% accuracy threshold over a rolling window of 15 trials, requiring at least 11 correct responses; they need not be consecutive. The reference task evaluates after each completed trial once 15 trials are available within the current association. Timeouts count as incorrect. If the criterion is met and the session continues, the next trial uses a new association and the window starts again.
With the listed settings, the accuracy threshold is 70% over a rolling window of 15 trials, requiring at least 11 correct responses; they need not be consecutive. Performance is evaluated after each completed trial once 15 trials are available within the current association. Timeouts count as incorrect. If the criterion is met and the session continues, the next trial uses a new association and the window starts again.


Color coherence is the percentage of dots in the more common color. Values near 50% are harder to judge, so an error can reflect color uncertainty as well as an association change. The reference task balances association exposure rather than following a fixed cycle.
Color coherence is the percentage of dots in the more common color. Values near 50% are harder to judge, so an error can reflect color uncertainty as well as an association change. Association selection balances exposure rather than following a fixed cycle.


=== Breaks, completion and controls ===
=== Breaks, completion and controls ===


The recorded profile specifies two scheduled breaks and a 450-main-trial cap. Its round target counts completed rounds after the initial association, not simply the number of switches. The task ends at the configured target or cap; staff may stop earlier.
A round comprises trials under one association and is completed when the accuracy criterion is met. The listed settings specify two scheduled breaks and a cap of 450 main-task trials. The round target counts completed rounds after the initial association, not simply the number of switches. The task ends at the configured target or cap; staff may stop earlier.


Reference controls: Space continues instruction and break pages; C repeats basic practice from its repeat page. Shift pauses the task. Release it, then press and release Shift again to resume. During dots, pausing waits until they disappear. In videos, Left / Right seeks by 5 seconds. Space or Enter acknowledges task completion.
Space continues instruction and break pages; C repeats basic practice from its repeat page. Shift pauses the task. Release it, then press and release Shift again to resume. During dots, pausing waits until they disappear. In videos, Left / Right seeks by 5 seconds. Space or Enter acknowledges task completion.


== Parameters ==
== Parameters ==


Values are from the recorded protocol 6.2 profile, not universal defaults. In Operator, open Config to inspect or edit parameters, then use SetConfig to apply them. Accepted values depend on the installed build.
The values below describe a recorded task configuration, not universal defaults. In Operator, open Config to inspect or edit parameters, then use SetConfig to apply them. Accepted values depend on the installed build.


=== GuidedMode ===
=== GuidedMode ===


Recorded value: 1. Enables guided videos and practice before the main task.
Value: 1. Enables guided videos and practice before the main task.


=== SwitchCriterionWindow ===
=== SwitchCriterionWindow ===


Recorded value: 15 trials. Number of trials in the rolling accuracy window. The reference task restarts the window after an association change.
Value: 15 trials. Number of trials in the rolling accuracy window, which restarts after an association change.


=== SwitchCriterionPercent ===
=== SwitchCriterionPercent ===


Recorded value: 70%. Accuracy threshold within SwitchCriterionWindow. At 70% over 15 trials, at least 11 responses must be correct; they need not be consecutive.
Value: 70%. Accuracy threshold within SwitchCriterionWindow. At 70% over 15 trials, at least 11 responses must be correct; they need not be consecutive.


=== CoherenceMin ===
=== CoherenceMin ===


Recorded value: 51%. Lower bound of main-task dominant-color percentage.
Value: 51%. Lower bound of main-task dominant-color percentage.


=== CoherenceMax ===
=== CoherenceMax ===


Recorded value: 100%. Upper bound of main-task dominant-color percentage.
Value: 100%. Upper bound of main-task dominant-color percentage.


=== CoherenceSigma ===
=== CoherenceSigma ===


Recorded value: 20 percentage points. In the reference sampler, the Gaussian scale around 50% before folding; not the observed standard deviation of presented coherences.
Value: 20 percentage points. Gaussian scale around 50% before folding; not the observed standard deviation of presented coherences.


=== GuidedPracticeCoherenceMin ===
=== GuidedPracticeCoherenceMin ===


Recorded value: 70%. Lower bound of practice dominant-color percentage.
Value: 70%. Lower bound of practice dominant-color percentage.


=== GuidedPracticeCoherenceMax ===
=== GuidedPracticeCoherenceMax ===


Recorded value: 85%. Upper bound of practice dominant-color percentage.
Value: 85%. Upper bound of practice dominant-color percentage.


=== StopRule ===
=== StopRule ===


Recorded value: 0. 0 selects a completed-round target; 1 selects trial count. The trial cap still applies.
Value: 0. 0 selects a completed-round target; 1 selects trial count. The trial cap still applies.


=== PostInitialMappingRounds ===
=== PostInitialMappingRounds ===


Recorded value: 21. Completed-round target excluding the initial round; not a guaranteed switch count.
Value: 21. Completed-round target excluding the initial round; not a guaranteed switch count.


=== TrialLimit ===
=== TrialLimit ===


Recorded value: 450. Maximum completed main-task trials; excludes practice.
Value: 450. Maximum completed main-task trials; excludes practice.


=== MidpointBreak ===
=== MidpointBreak ===


Recorded value: 2. Number of scheduled breaks in the recorded 6.2 profile.
Value: 2. Number of scheduled breaks in the documented configuration.


=== PreDotMinMs ===
=== PreDotMinMs ===


Recorded value: 500 ms. Minimum requested pre-dot fixation duration.
Value: 500 ms. Minimum requested pre-dot fixation duration.


=== PreDotMaxMs ===
=== PreDotMaxMs ===


Recorded value: 500 ms. Maximum requested pre-dot fixation duration. Equal bounds give a fixed duration.
Value: 500 ms. Maximum requested pre-dot fixation duration. Equal bounds give a fixed duration.


=== DotDurationMinMs ===
=== DotDurationMinMs ===


Recorded value: 500 ms. Minimum requested moving-dot display duration.
Value: 500 ms. Minimum requested moving-dot display duration.


=== DotDurationMaxMs ===
=== DotDurationMaxMs ===


Recorded value: 500 ms. Maximum requested moving-dot display duration.
Value: 500 ms. Maximum requested moving-dot display duration.


=== DelayMinMs ===
=== DelayMinMs ===


Recorded value: 1600 ms. Minimum requested post-dot delay.
Value: 1600 ms. Minimum requested post-dot delay.


=== DelayMaxMs ===
=== DelayMaxMs ===


Recorded value: 1600 ms. Maximum requested post-dot delay.
Value: 1600 ms. Maximum requested post-dot delay.


=== ResponseDuration ===
=== ResponseDuration ===


Recorded value: 5000 ms. Maximum choice-response window, including the required key hold.
Value: 5000 ms. Maximum choice-response window, including the required key hold.


=== ChoiceHoldDuration ===
=== ChoiceHoldDuration ===


Recorded value: 100 ms. Required response-key hold within the choice window.
Value: 100 ms. Required response-key hold within the choice window.


=== ChoiceConfirmedDuration ===
=== ChoiceConfirmedDuration ===


Recorded value: 150 ms. Confirmed-choice display duration after the required hold.
Value: 150 ms. Confirmed-choice display duration after the required hold.


=== ITIMinMs ===
=== ITIMinMs ===


Recorded value: 900 ms. Minimum requested intertrial interval.
Value: 900 ms. Minimum requested intertrial interval.


=== ITIMaxMs ===
=== ITIMaxMs ===


Recorded value: 1100 ms. Maximum requested intertrial interval; the interval varies within the two bounds.
Value: 1100 ms. Maximum requested intertrial interval; the interval varies within the two bounds.


=== DisplayRefreshRateHz ===
=== DisplayRefreshRateHz ===


Recorded value: 60 Hz. Configured display refresh rate, not a physical timing measurement.
Value: 60 Hz. Configured display refresh rate, not a physical timing measurement.


=== AutoDetectDisplayRefreshRate ===
=== AutoDetectDisplayRefreshRate ===


Recorded value: 0. Automatic refresh-rate detection is disabled in the recorded profile. Check requested durations against physical timing with the site photodiode.
Value: 0. Automatic refresh-rate detection is disabled. Check requested durations against physical timing with the site photodiode.


== BCI2000 Integration ==
== BCI2000 Integration ==
Line 181: Line 184:
=== Running the task and resources ===
=== Running the task and resources ===


Use the site launcher; load acquisition and task parameters, select SetConfig, then Start. The reference setup launches the Signal Source on the response-keyboard computer with <code>--LogKeyboard=1 --FileFormat=BCI2000</code>, supplying <code>KeyDown</code> / <code>KeyUp</code> and native recording. Do not also enable <code>KeyLogFilter</code>.
Use the site launcher; load acquisition and task parameters, select SetConfig, then Start. The documented setup launches the Signal Source on the response-keyboard computer with <code>--LogKeyboard=1 --FileFormat=BCI2000</code>, supplying <code>KeyDown</code> / <code>KeyUp</code> and native recording. Do not also enable <code>KeyLogFilter</code>.
 
The supplied package places resources under tasks/HumanAssociationTask_BCI2000/resources: The <code>cifar</code> folder contains BMP category images, <code>audio</code> contains feedback WAVs, and <code>guided</code> contains videos/instructions. Match resource paths to the loaded parameters. Task-specific category IDs are 2 = car, 6 = dog and 58 = tree, with 500 images each.


The reference resource location is tasks/HumanAssociationTask_BCI2000/resources: cifar contains BMP images, audio contains feedback WAVs, and guided contains videos/instructions. Match paths to the loaded parameters. Categories are 2 = car, 6 = dog and 58 = tree, with 500 images each.
For background on CIFAR, see the [https://www.cs.toronto.edu/~kriz/cifar.html CIFAR-10 and CIFAR-100 dataset page].


== States ==
== States ==


The native BCI2000 .dat file stores acquired signals, loaded parameters and task states. The following fields identify the main events and outcomes; they are a selected reference, not the full schema.
The native BCI2000 .dat file stores acquired signals, loaded parameters and task states. Selected states for identifying the main events and outcomes are listed below.


{| class="wikitable"
{| class="wikitable"
Line 213: Line 218:
== Versioning ==
== Versioning ==


Author: JCH. Recorded declarations: ProtocolVersion = 6.2-bci-hospital1500-flex; TaskReleaseID = 0.4.0-preintegration-hospital1500-flex; DataSchemaVersion = 2. Reference source and visual examples use protocol 6.0.
Author: Jiancao Huang. Behavior, controls and state meanings follow the inspected C++ source (protocol 6.0); Figures 2 and 3 use its standalone renderer. Parameter values come from a recorded configuration declaring ProtocolVersion = 6.2-bci-hospital1500-flex; TaskReleaseID = 0.4.0-preintegration-hospital1500-flex; DataSchemaVersion = 2.
 
== Location ==
 
Source (authorized access): [https://www.bci2000.org/svn/trunk/src/private/Application/HumanAssociationTask HumanAssociationTask in BCI2000 SVN]
 
== See Also ==
 
See also: [https://www.bci2000.org/mediawiki/index.php/User_Reference:Operator_Module BCI2000 Operator Module]
 
[[Category:Contributions]]
[[Category:User Application]]

Latest revision as of 22:18, 8 October 2026

Synopsis

HAT studies how the brain forms mental associations between things, and adapts those associations when the uncertain environment changes. It combines uncertain sensory evidence, a brief memory delay and learning from feedback, allowing these processes to be studied during iEEG recording.

Participants judge whether a moving dot cloud contains more red or blue dots. After a delay, they choose a car, dog or tree image using the current color-category association; feedback helps them discover when that association has changed.

The association, not the individual picture

The initial association is red-car / blue-dog: more red dots means choose the car; more blue dots means choose the dog. Images and their positions vary across trials. The three possible associations are:

Association Red Blue
Initial Car Dog
Alternative Dog Tree
Alternative Tree Car

Session Flow

Guided session in order: Video 1 then basic association practice; Video 2 then switch practice with an announcement and then without one; Video 3 then the main task with scheduled breaks, followed by completion.
Figure 1. Guided session flow. Basic practice can be repeated. In the main task, association changes are not announced.

An on-screen association hint supports the start of unannounced practice and the main task, then fades. Participants continue using feedback to guide their choices.

Visual Representation

Participants view a gray screen with stimuli near the center. At choice onset, one image from each category appears; the Up, Left and Right arrow keys select the corresponding screen position.

Full task frame at choice onset. Tree is above, car is lower left and dog is lower right near screen center. A photodiode patch is at the left edge and the Shift pause label is at bottom right.
Figure 2. Full task display, uniformly reduced. Figures 2 and 3 were captured from the standalone C++ task using the supplied 256 x 256-pixel images. The white edge patch is a timing marker.
Three equal central crops from the same trial: a red-majority dot cloud, three category choices, and an enlarged car image while the left response is held.
Figure 3. Enlarged views from one trial, using identical central crop bounds and magnification. Dots disappear before choices appear. Holding a response key enlarges that image; no elements have been repositioned.

Display settings in the documented configuration: 452 dots; red RGB [199, 72, 50], blue RGB [77, 123, 161]. ImageSizePixels = 70 and SelectedImageScale = 1.5 give a 70-pixel base image and a 105-pixel selected image. Source-image resolution is separate from on-screen size.

Single-Trial Timeline

Trial order and requested timings: fixation 500 ms; moving dots 500 ms; delay 1600 ms; choice up to 5000 ms; confirmed choice 150 ms; intertrial interval 900 to 1100 ms. A 100 ms response hold occurs inside the choice window.
Figure 4. Single-trial sequence and requested timings for the listed configuration; boxes are not to time scale. The 100 ms key hold occurs within the choice window.

The fixation marker remains during the delay. With the listed settings, a confirmed choice stays visible for 150 ms, followed by the intertrial interval (ITI). Correct and incorrect responses request distinct feedback sounds at ITI entry; a timeout skips confirmation and receives no feedback sound.

Practice and Association Switching

Both switch exercises start with red-car / blue-dog.

Practice stage Progression
After Video 1 Red-car / blue-dog; finish after 7 correct responses in total.
After Video 2: announced change 5 correct in total, then red-tree / blue-car with a New association notice; finish after 6 consecutive correct.
After Video 2: unannounced change 5 correct in total and initial hint fade complete, then red-tree / blue-car without a change notice; finish after 6 consecutive correct.

The initial hint begins fading during ITI after 2 consecutive correct responses in unannounced practice and the main task. Errors and timeouts reset streaks, but preserve total correct counts. Stage changes follow ITI. Practice does not count toward the main-task limit.

Main-task criterion

With the listed settings, the accuracy threshold is 70% over a rolling window of 15 trials, requiring at least 11 correct responses; they need not be consecutive. Performance is evaluated after each completed trial once 15 trials are available within the current association. Timeouts count as incorrect. If the criterion is met and the session continues, the next trial uses a new association and the window starts again.

Color coherence is the percentage of dots in the more common color. Values near 50% are harder to judge, so an error can reflect color uncertainty as well as an association change. Association selection balances exposure rather than following a fixed cycle.

Breaks, completion and controls

A round comprises trials under one association and is completed when the accuracy criterion is met. The listed settings specify two scheduled breaks and a cap of 450 main-task trials. The round target counts completed rounds after the initial association, not simply the number of switches. The task ends at the configured target or cap; staff may stop earlier.

Space continues instruction and break pages; C repeats basic practice from its repeat page. Shift pauses the task. Release it, then press and release Shift again to resume. During dots, pausing waits until they disappear. In videos, Left / Right seeks by 5 seconds. Space or Enter acknowledges task completion.

Parameters

The values below describe a recorded task configuration, not universal defaults. In Operator, open Config to inspect or edit parameters, then use SetConfig to apply them. Accepted values depend on the installed build.

GuidedMode

Value: 1. Enables guided videos and practice before the main task.

SwitchCriterionWindow

Value: 15 trials. Number of trials in the rolling accuracy window, which restarts after an association change.

SwitchCriterionPercent

Value: 70%. Accuracy threshold within SwitchCriterionWindow. At 70% over 15 trials, at least 11 responses must be correct; they need not be consecutive.

CoherenceMin

Value: 51%. Lower bound of main-task dominant-color percentage.

CoherenceMax

Value: 100%. Upper bound of main-task dominant-color percentage.

CoherenceSigma

Value: 20 percentage points. Gaussian scale around 50% before folding; not the observed standard deviation of presented coherences.

GuidedPracticeCoherenceMin

Value: 70%. Lower bound of practice dominant-color percentage.

GuidedPracticeCoherenceMax

Value: 85%. Upper bound of practice dominant-color percentage.

StopRule

Value: 0. 0 selects a completed-round target; 1 selects trial count. The trial cap still applies.

PostInitialMappingRounds

Value: 21. Completed-round target excluding the initial round; not a guaranteed switch count.

TrialLimit

Value: 450. Maximum completed main-task trials; excludes practice.

MidpointBreak

Value: 2. Number of scheduled breaks in the documented configuration.

PreDotMinMs

Value: 500 ms. Minimum requested pre-dot fixation duration.

PreDotMaxMs

Value: 500 ms. Maximum requested pre-dot fixation duration. Equal bounds give a fixed duration.

DotDurationMinMs

Value: 500 ms. Minimum requested moving-dot display duration.

DotDurationMaxMs

Value: 500 ms. Maximum requested moving-dot display duration.

DelayMinMs

Value: 1600 ms. Minimum requested post-dot delay.

DelayMaxMs

Value: 1600 ms. Maximum requested post-dot delay.

ResponseDuration

Value: 5000 ms. Maximum choice-response window, including the required key hold.

ChoiceHoldDuration

Value: 100 ms. Required response-key hold within the choice window.

ChoiceConfirmedDuration

Value: 150 ms. Confirmed-choice display duration after the required hold.

ITIMinMs

Value: 900 ms. Minimum requested intertrial interval.

ITIMaxMs

Value: 1100 ms. Maximum requested intertrial interval; the interval varies within the two bounds.

DisplayRefreshRateHz

Value: 60 Hz. Configured display refresh rate, not a physical timing measurement.

AutoDetectDisplayRefreshRate

Value: 0. Automatic refresh-rate detection is disabled. Check requested durations against physical timing with the site photodiode.

BCI2000 Integration

HumanAssociationTask.exe is the native C++ Application. It runs with the site's Signal Source, Signal Processing and Operator modules. Guided playback requires the task's AV adapter and packaged media.

Running the task and resources

Use the site launcher; load acquisition and task parameters, select SetConfig, then Start. The documented setup launches the Signal Source on the response-keyboard computer with --LogKeyboard=1 --FileFormat=BCI2000, supplying KeyDown / KeyUp and native recording. Do not also enable KeyLogFilter.

The supplied package places resources under tasks/HumanAssociationTask_BCI2000/resources: The cifar folder contains BMP category images, audio contains feedback WAVs, and guided contains videos/instructions. Match resource paths to the loaded parameters. Task-specific category IDs are 2 = car, 6 = dog and 58 = tree, with 500 images each.

For background on CIFAR, see the CIFAR-10 and CIFAR-100 dataset page.

States

The native BCI2000 .dat file stores acquired signals, loaded parameters and task states. Selected states for identifying the main events and outcomes are listed below.

State or group Meaning
HATPhase / HATGuidedStage
HATTrialKind		 Current phase and guided stage; trial kind: 0 none, 1 practice, 2 main task.
HATTrial / HATPracticeTrial Main-task counter (0 during practice) and separate practice counter.
HATMappingID
HATSwitchCount / HATPostSwitchCount		 Current association; switch counts before and after trial evaluation.
HATDominantColor
HATRealizedCoherence		 Color: 1 red, 2 blue; rounded realized dominant-color percentage.
HATResponseCategory
HATResponseOutcome		 Category: 2 car, 6 dog, 58 tree; 0 no accepted response. Outcome: 0 pending, 1 incorrect, 2 correct, 3 timeout.
HATResponseOnset
HATReactionTimeMs		 Confirmation/timeout pulse; RT in ms from choice-window start to that event, excluding internal pauses. Confirmed-response RT includes the key hold; it is not first-keypress latency.
HATTrialStart / HATTrialCompleted Trial-entry and post-ITI trial-evaluation pulses.
HATFinished Endpoint reached; final acknowledgement may still be pending.

Task states, including HATPhotodiode, are software markers. Check build-specific block alignment and use verified photodiode/audio recordings for physical timing. HATFinished may precede final acknowledgement and file closure. Keep all recording parts together.

Versioning

Author: Jiancao Huang. Behavior, controls and state meanings follow the inspected C++ source (protocol 6.0); Figures 2 and 3 use its standalone renderer. Parameter values come from a recorded configuration declaring ProtocolVersion = 6.2-bci-hospital1500-flex; TaskReleaseID = 0.4.0-preintegration-hospital1500-flex; DataSchemaVersion = 2.

Retrieved from "http://www.bci2000.org/mediawiki/index.php?title=Contributions:Human_Association_Task_(HAT)&oldid=12651"