User Manual: Inquisit Auditory ANT


___________________________________________________________________________________________________________________	

								ATTENTION NETWORK TEST- Auditory
								(Batch Script)
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 06-06-2024
last updated: 06-10-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 06-10-2024 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the auditory Attention Network Test (ANT-A) as suggested by Wu et al (2021).
The ANT-A is an approximate auditory analog of the visual ANT-R (Fan et al, 2009). As part of the ANT tasks,
the ANT-A is a behavioral measure of alerting, orienting and  executive attention.

This script runs the practice session, followed by the test session via a batch script.

//ANT-R: visual
Fan, J., Gu, X., Guise, K.G., Liu, X., Fossella, J., Wang, H. & Posner, M.I. (2009).
Testing the behavioral interaction and integration of attentional networks.
Brain and Cognition, 70, 209–220.

The original ANT-R (e-prime, version 1) can be downloaded at: http://people.qc.cuny.edu/Faculty/Jin.Fan/Pages/Downloads.aspx

//ANT: auditory
Wu, X., Jiang, Y., Jiang, Y., Chen, G., Chen, Y., & Bai, X. (2021). 
The Influence of Action Video Games on Attentional Functions Across Visual and Auditory Modalities. 
Frontiers in Psychology, 12, 611778–611778. 
https://doi.org/10.3389/fpsyg.2021.611778


___________________________________________________________________________________________________________________	

								ATTENTION NETWORK TEST- Auditory
								*Practice Session*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 06-06-2024
last updated: 06-10-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 06-10-2024 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the auditory Attention Network Test (ANT-A) as suggested by Wu et al (2021).
The ANT-A is an approximate auditory analog of the visual ANT-R (Fan et al, 2009). As part of the ANT tasks,
the ANT-A is a behavioral measure of alerting, orienting and executive attention. 

//ANT-R: visual
Fan, J., Gu, X., Guise, K.G., Liu, X., Fossella, J., Wang, H. & Posner, M.I. (2009).
Testing the behavioral interaction and integration of attentional networks.
Brain and Cognition, 70, 209–220.

The original ANT-R (e-prime, version 1) can be downloaded at: http://people.qc.cuny.edu/Faculty/Jin.Fan/Pages/Downloads.aspx

//ANT: auditory
Wu, X., Jiang, Y., Jiang, Y., Chen, G., Chen, Y., & Bai, X. (2021). 
The Influence of Action Video Games on Attentional Functions Across Visual and Auditory Modalities. 
Frontiers in Psychology, 12, 611778–611778. 
https://doi.org/10.3389/fpsyg.2021.611778

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants are presented two binaurally sounds sequentially. The first sound is the TARGET sound.
It can either be long or short (and of a high or low frequency). 
The second sound is the 'flanker'. It can either be long or short (it always has the same frequency
as the target). 

If both sounds are of the same length, the sounds are congruent.
If they are not, they are incongruent. Participants have to press one key when the 
TARGET sound is short, and another when the target sound is long (all irrespective of the 
length of the flanker sound.)

The two sounds may be preceded by a binaurally cue sound. This cue sound falls into four different
categories:
1. no cue => no cue sound is actually played 
2. double cue => one high frequency and one low frequency tone is played through each ear
3. valid cue => the binaurally cues are of the same frequency as the following target
4. invalid cue => the binaurally cues are of the opposite frequence as the the following target

Differences in mean reaction times in the different cue/flanker conditions can be used to calculate
several Attentional Network Effects.

Note: this script runs the practice session.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 5 minutes to complete

___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:

(1) Raw data file: 'ant_auditory_raw*.iqdat' (a separate file for each participant)

build:							The specific Inquisit version used (the 'build') that was run
computer.platform:				the platform the script was run on (win/mac/ios/android)
date, time: 					date and time script was run 
subject, group: 				with the current subject/groupnumber
session:						with the current session id

blockCount:						counts the number of practice blocks run (resets after practice1)
blockCode:						the name and number of the current block
trialCount:						counts the number of trials run (resets for each block)
trialCode: 						the name and number of the currently recorded trial


cueCondition:					the current cue condition 
									1 = no cue; 
									2 = double cue; 
									3 = valid frequency cue1; 
									4 = invalid frequency cue
																										
cueValidity:					the (frequency) validity of the current cue

flankerCongruence:				the current flanker congruence condition 
								1 = congruent => flanker and target sound are of the same length; 
								2 = incongruent
								
targetFrequency:				current frequency of target 
								1 = low (here: 1000Hz)
								2 = high (here: 1500Hz)

targetLength:					the current length of the target sound 
								1 = short (->left key)
								2 = long  (->right key)
								Note: this setting determines correct response
								
targetDurationMS:				the assigned target duration (in ms) 
flankerDurationMS:				the assigned flanker duration (in ms)								
								
ctISI:							stores the current interstimulus interval between offset of cue and onset of target in ms
(parameter) targetDuration:	the maximal duration of the target/flanker presentation in ms (default: 500ms)
(parameter) responsewindow:		maximum amount of time (in ms) participant can respond after target onset (default: 1700ms)
tcISI:							stores the current interstimulus interval between offset of target and onset of next cue in ms 

corrResp:						the currently correct response key
response:						the response of participant (scancode of response button: 18 = left E; 23 = right I; 57 = space)
responseText:					label of response button
latency:						response latency (in ms); measured from onset of target
valid:							1 = valid latency (latency >= (parameter) minValidlatency); 0 = anticipatory latency
correct:						correct of response regardless of validity (1 = correct; 0 = error)
validCorrect:					correctness of responses taking latency into account (1 = correct AND valid; 0 = otherwise)


sound.cueL.currentItem:			store the sound file used for the left-panned cue
sound.cueR.currentItem:			store the sound file used for the right-panned cue
sound.aTarget.currentItem:		store the sound file used for the target
sound.aflanker.currentItem:		store the sound file used for the flanker


(2) Summary data file: 'ant_auditory_summary*.iqdat' (a separate file for each participant)

inquisit.version:				Inquisit version run
computer.platform:				the platform the script was run on (win/mac/ios/android)
startDate:						date script was run
startTime:						time script was started
subjectId:						assigned subject id number
groupId:						assigned group id number
sessionId:						assigned session id number
elapsedTime:					time it took to run script (in ms); measured from onset to offset of script
completed:						0 = script was not completed (prematurely aborted); 
								1 = script was completed (all conditions run)	

blockCount:						number of practice2 blocks runs 
propCorrectPR2:					proportion correct of last practice2 block 
meanCorrRTPR2:					mean correct response times of last practice2 block
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

"4" cue conditions (no cue, double cue, invalid spatial cue, valid spatial cue) x 2 flanker congruence (congruent, incongruent) x 2 location congruence (position and direction of target are congruent, incongruent)
within-subjects design

- step by step demo Instructions
- 1 Block of 6 practice trials with infinite responsewindow (Targets are presented indefinitely); only correct responses accepted
- 1 Block of 32 Practice trial sequences with finite response window - with accuracy and RT feedback 
-> practice block 2 can be repeated until block performance >= 90% correct (optional, set values.practicerepeat under Editable Values)
		
!Note: this script uses the predetermined trialsequences used in the original e-prime program (http://people.qc.cuny.edu/Faculty/Jin.Fan/Pages/Downloads.aspx)


TRIAL SEQUENCE (one sequence for each cue condition) - order is predetermined

-> (frequency) cue (115ms) 
-> fixation: cue-target ISI (675ms) 
-> target (30ms OR 150ms), binaurally presented (Note: a temporal buffer btw. target and flanker has been added by Millisecond Software, see editable parameters.targetFlankerIsi)
-> flanker (30ms OR 150ms), binaurally presented
-> fixation after target for a minimum of 500ms (depends on response time. If longer than 500ms 
the duration of this fixation cross will be longer but the surplus time will then be subtracted from 
the following target-cue ISI)
-> fixation during target-cue ISI (2000-12000ms, Mean = 4000) - same as visual ANT-R

Notes: 
1) Response Window: not specified by Wu et al (2021). This script uses the settings from the visual ANT-R
of max.1700ms. 
	
!Note: this script uses the predetermined trialsequences used in the original e-prime program 
of the visual ANT-R (http://people.qc.cuny.edu/Faculty/Jin.Fan/Pages/Downloads.aspx)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software.
The soundfiles were created with Audacity.

They can easily be replaced under section Editable Stimuli.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
provided by Millisecond Software.

They can easily be replaced/modified under section Editable Stimuli.

___________________________________________________________________________________________________________________	
EDITABLE CODE 
___________________________________________________________________________________________________________________	
check below for (relatively) easily editable parameters, stimuli, instructions etc. 
Keep in mind that you can use this script as a template and therefore always "mess" with the entire code 
to further customize your experiment.

The parameters you can change are:



___________________________________________________________________________________________________________________	

								ATTENTION NETWORK TEST- Auditory
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 06-06-2024
last updated: 06-10-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 06-10-2024 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the auditory Attention Network Test (ANT-A) as suggested by Wu et al (2021).
The ANT-A is an approximate auditory analog of the visual ANT-R (Fan et al, 2009). As part of the ANT tasks,
the ANT-A is a behavioral measure of alerting, orienting and  executive attention. 

//ANT-R: visual
Fan, J., Gu, X., Guise, K.G., Liu, X., Fossella, J., Wang, H. & Posner, M.I. (2009).
Testing the behavioral interaction and integration of attentional networks.
Brain and Cognition, 70, 209–220.

The original ANT-R (e-prime, version 1) can be downloaded at: http://people.qc.cuny.edu/Faculty/Jin.Fan/Pages/Downloads.aspx

//ANT: auditory
Wu, X., Jiang, Y., Jiang, Y., Chen, G., Chen, Y., & Bai, X. (2021). 
The Influence of Action Video Games on Attentional Functions Across Visual and Auditory Modalities. 
Frontiers in Psychology, 12, 611778–611778. 
https://doi.org/10.3389/fpsyg.2021.611778

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants are presented two binaurally sounds sequentially. The first sound is the TARGET sound.
It can either be long or short (and of a high or low frequency). 
The second sound is the 'flanker'. It can either be long or short (it always has the same frequency
as the target). 

If both sounds are of the same length, the sounds are congruent.
If they are not, they are incongruent. Participants have to press one key when the 
TARGET sound is short, and another when the target sound is long (all irrespective of the 
length of the flanker sound.)

The two sounds may be preceded by a binaurally cue sound. This cue sound falls into four different
categories:
1. no cue => no cue sound is actually played 
2. double cue => one high frequency and one low frequency tone is played through each ear
3. valid cue => the binaurally cues are of the same frequency as the following target
4. invalid cue => the binaurally cues are of the opposite frequence as the the following target

Differences in mean reaction times in the different cue/flanker conditions can be used to calculate
several Attentional Network Effects.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 30 minutes to complete

___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:

(1) Raw data file: 'ant_auditory_raw*.iqdat' (a separate file for each participant)

build:							The specific Inquisit version used (the 'build') that was run
computer.platform:				the platform the script was run on (win/mac/ios/android)
date, time: 					date and time script was run 
subject, group: 				with the current subject/groupnumber
session:						with the current session id

blockCount:						counts the number of experimental blocks run
blockCode:						the name and number of the current block
trialCount:						counts the number of trials run (resets for each block)
trialCode: 						the name and number of the currently recorded trial


cueCondition:					the current cue condition 
									1 = no cue; 
									2 = double cue; 
									3 = valid frequency cue1; 
									4 = invalid frequency cue									
																	
cueValidity:					the (frequency) validity of the current cue

flankerCongruence:				the current flanker congruence condition 
								1 = congruent => flanker and target sound are of the same length; 
								2 = incongruent
								
targetFrequency:				current frequency of target 
								1 = low (here: 1000Hz)
								2 = high (here: 1500Hz)

targetLength:					the current length of the target sound 
								1 = short (->left key)
								2 = long  (->right key)
								Note: this setting determines correct response
								
targetDurationMS:				the assigned target duration (in ms) 
flankerDurationMS:				the assigned flanker duration (in ms)								

ctISI:							stores the current interstimulus interval between offset of cue and onset of target in ms
(parameter) targetDuration:	the maximal duration of the target/flanker presentation in ms (default: 500ms)
(parameter) responsewindow:		maximum amount of time (in ms) participant can respond after target onset (default: 1700ms)
tcISI:							stores the current interstimulus interval between offset of target and onset of next cue in ms
(parameter) minValidlatency:	minimum response latency (in ms) that is considered valid and not anticipatory (default: 0) 

corrResp:						the currently correct response key
response:						the response of participant (scancode of response button: 18 = left E; 23 = right I; 57 = space)
responseText:					label of response button
latency:						response latency (in ms); measured from onset of target
valid:							1 = valid latency (latency >= (parameter) minValidlatency); 0 = anticipatory latency
correct:						correct of response regardless of validity (1 = correct; 0 = error)
validCorrect:					correctness of responses taking latency into account (1 = correct AND valid; 0 = otherwise)


sound.cueL.currentItem:			store the sound file used for the left-panned cue
sound.cueR.currentItem:			store the sound file used for the right-panned cue
sound.aTarget.currentItem:		store the sound file used for the target
sound.aflanker.currentItem:		store the sound file used for the flanker


(2) Summary data file: 'ant_auditory_summary*.iqdat' (a separate file for each participant)

inquisit.version:				Inquisit version run
computer.platform:				the platform the script was run on (win/mac/ios/android)
startDate:						date script was run
startTime:						time script was started
subjectId:						assigned subject id number
groupId:						assigned group id number
sessionId:						assigned session id number
elapsedTime:					time it took to run script (in ms); measured from onset to offset of script
completed:						0 = script was not completed (prematurely aborted); 
								1 = script was completed (all conditions run)	

(parameter) minValidlatency:	minimum response latency (in ms) that is considered valid and not anticipatory (default: 0) 
trialCount:						counts the number of trials run, across testblocks 
overallPropCorrect:				total percent correct; across testblocks

Note: latency summary variables are based on correct and valid responses (latency >= (parameter) minValidlatency)
meanRT:		mean response latency (in ms) of correct and valid responses across testblocks
stdR:		standard deviation of latencies of correct and valid responses across testblocks


Attentional Network Effects: All effects are calculated based on the means of correct and valid responses:
(for interpretation, see Fan et al, 2009, p.212-213)

NOTE: There are no corresponding matches in the auditory ANT to any effect based on 'location effects'
in the visual ANT (location: right vs. left). Furthermore orientation time effects (based on 
cue-target ISI) cannot be determined either as a constant cue-targetISI is run

(1) Cue-Effects:
alerting:				 	RTnoCue - RTdoubleCue	
orienting:					RTdoubleCue - RTvalidCue												
validity:					RTinvalidCue - RTvalidCue 
disengaging:				RTinvalidCue - RTdoubleCue

(2) Flanker Conflict (Cost) Effects:
flankerConflict:			RTflanker incongruent - RTflanker congruent

(3) Interaction Effects:
alertingByFlankerConflict:		(RTnoCue, flanker incongruent - RTnoCue, flanker congruent) - (RTdoubleCue, flanker incongruent - RTdoubleCue, flanker congruent)
orientingByFlankerConflict:		(RTdoubleCue, flanker incongruent - RTdoubleCue, flanker congruent) - (RTvalidCue, flanker incongruent - RTvalidCue, flanker congruent)
validityByFlankerConflict:		(RTinvalidCue, flanker incongruent - RTinvalidCue, flanker congruent) - (RTvalidCue, flanker incongruent - RTvalidCue, flanker congruent)
disengagingByFlankerConflict:	(RTinvalidCue, flanker incongruent - RTinvalidCue, flanker congruent) - (RTdoubleCue, flanker incongruent - RTdoubleCue, flanker congruent)

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

A) Practice
Practice is run by script ant_auditory_practice.iqx

B) 4 Blocks of 72 trial sequences each - no feedback 
(2 blocks use the same predetermined sequence, then they get repeated)
- 12 nocue; 12 doubleCue; 12 invalid frequency cue; 36 valid frequency cues trials per block
- conditions are counterbalanced across 2 blocks (144 trials)

TRIAL SEQUENCE - order of cueCondition is predetermined

-> (frequency) cue (115ms), presented in left and right ear
-> fixation: cue-target ISI (675ms) 
-> target (30ms OR 150ms), binaurally presented (Note: a temporal buffer btw. target and flanker has been added by Millisecond Software, see editable parameters.targetFlankerIsi)
-> flanker (30ms OR 150ms), binaurally presented  
-> fixation after target for a minimum of 500ms (depends on response time. If longer than 500ms 
the duration of this fixation cross will be longer but the surplus time will then be subtracted from 
the following target-cue ISI)
-> fixation during target-cue ISI (2000-12000ms, Mean = 4000) - same as visual ANT-R

Notes: 
1) Response Window: not specified by Wu et al (2021). This script uses the settings from the visual ANT-R
of max.1700ms. 
	
!Note: this script uses the predetermined trialsequences used in the original e-prime program 
of the visual ANT-R (http://people.qc.cuny.edu/Faculty/Jin.Fan/Pages/Downloads.aspx)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software.
The soundfiles were created with Audacity.

They can easily be replaced under section Editable Stimuli.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
provided by Millisecond Software.

They can easily be replaced/modified under section Editable Stimuli.

___________________________________________________________________________________________________________________	
EDITABLE CODE 
___________________________________________________________________________________________________________________	
check below for (relatively) easily editable parameters, stimuli, instructions etc. 
Keep in mind that you can use this script as a template and therefore always "mess" with the entire code 
to further customize your experiment.

The parameters you can change are: