___________________________________________________________________________________________________________________ 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: