User Manual: Inquisit Attention Network Test-Interaction (ANT-I)


___________________________________________________________________________________________________________________	

								Attention Network Test-Interaction (ANT-I)
								(German instructions)
___________________________________________________________________________________________________________________

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

Script Copyright © 10-18-2024 Millisecond Software

German instructions provided by K. Borchert for Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the Attention Network Test-Interaction (ANT-I), a behavioral measure of alerting, 
orienting and executive attention. The implemented procedure was originally proposed by Callejas et al (2005).

///References///

Callejas A, Lupiàñez J, Funes MJ, Tudela P (2005). Modulations
among the alerting, orienting and executive control networks.
Exp Brain Res 167:27–37. 
doi:10.1007/s00221-005-2365-z

Ishigami, Y., & Klein, R. M. (2011). Repeated Measurement of the Components of Attention of
Older Adults using the Two Versions of the Attention Network Test: 
Stability, Isolability, Robustness, and Reliability. 
Frontiers in Aging Neuroscience, 3, 17–17. 
https://doi.org/10.3389/fnagi.2011.00017

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

Participants are presented arrows either directly above or below a fixation cross. The center
arrow may or may not point in the same direction as the flanking arrows.
Participants have to decide whether the center arrows point right or left.
Before the arrows appear, participants may hear a beep followed by a location cue,
get only one of these signals, or get neither one.

Differences in mean reaction times in the different audio/location cue/flanker conditions are used to calculate
the following three Attentional Network Effects:
* Alert Effect: Effect of achieving and maintaining alertness
* Orienting Effect: Effect of orienting attention towards a specific location of information
* Executive Effect: Effect of resolving conflict between several possible responses and executing response

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

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

(1) Raw data file: 'ant_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

blockCode, blockNum:				the name and number of the current block (built-inquisit variable)
trialCode, trialNum: 				the name and number of the currently recorded trial (built-inquisit variable)
										Note: trialNum is a built-inquisit variable; it counts all trials run; even those
										that do not store data to the data file such as feedback trials. Thus, trialNum 
										may not reflect the number of main trials run per block. 

blockCount:					counts the number of test blocks run (custom counter)
trialCount:					counts the number of trials run in each block (resets after practice) (custom counter)

audioCondition:				the current audio (cue) condition: 1 = beep is played; 0 = no beep is played

cueCondition:				the current (visual) cue condition (NoCue; ValidSC, InvalidSC)
							NoCue: no visual cue is provided
							ValidSC: valid spatial cue -> the provided star correctly signals the location of arrows
							InvalidSC: invalid spatial cue -> the provided star is not located in the location the arrows will appear

congruence:					the current flanker condition (1 = congruent; 0 = incongruent)
targetPosition:				position of target relative to fixation (2 = above fixation; 1 = below fixation)
targetDirection:			the direction of the target (0 = right; 1 = left)

picture.flanker1.currentItem/
picture.flanker4.currentItem: 		stores the images presented for targets and flankers

Variables that contain y coordinates (vertical coordinates) for cues, targets, flankers:
Note: coordinates are provided proportional to the canvas (Top = 0% - Bottom = 100%)
targetY:
flanker1Y:
cueY:

response:					the response of participant (scancode of response button: 18 = left E; 23 = right I; 57 = spacebar)
correct:					correctness of response (1 = correct, 0 = error)
latency:					response latency (in ms); measured from onset of target until response is made or trial times out


(2) Summary data file: 'ant_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)
															
////////////
latencies:
////////////

meanCorrRT:				overall mean response time (in ms) of correct responses across all testblock trials

/////Main Effects:
meanCorrRTAudio: 		mean response time (in ms) of correct responses in Audio signal condition (beep was played)
meanCorrRTNoAudio: 		mean response time (in ms) of correct responses in NoAudio signal condition (beep was not played)

meanCorrRTNoCue: 		mean response time (in ms) of correct responses in NoCue condition
meanCorrRTValidSC:		mean response time (in ms) of correct responses in ValidSC condition
meanCorrRTInvalidSC:		mean response time (in ms) of correct responses in InvalidSC condition

meanCorrRTCongruent: 	mean response time (in ms) of correct responses in trials with target-congruent flankers (flankers that point in the same direction as target)
meanCorrRTIncongruent: 	mean response time (in ms) of correct responses in trials with target-incongruent flankers (flankers that point in the opposite direction as target)

alertingEffectRT: 	meanCorrRTNoAudio - meanCorrRTAudio => Effect of achieving and maintaining alertness
orientingEffectRT: 	meanCorrRTInvalidSC - meanCorrRTValidSC => Effect of orienting attention towards a specific location of information
executiveEffectRT: 	meanCorrRTincongruent - meanCorrRTcongruent => Effect of resolving conflict between several possible responses (executive function)

+ all 2-way and 3-way interactions data points

////////////
accuracy:
////////////

overallPropCorrect:			overall proportion correct across all testblock trials

/////Main Effects:
propCorrectAudio: 			proportion correct responses in Audio signal condition (beep was played)
propCorrectNoAudio: 		proportion correct responses in NoAudio signal condition (beep was not played)

propCorrectNoCue: 			proportion correct responses in NoCue condition
propCorrectValidSC:			proportion correct responses in ValidSC condition
propCorrectInvalidSC:		proportion correct responses invalidSC condition

propCorrectCongruent: 		proportion correct responses in trials with target-congruent flankers (flankers that point in the same direction as target)
propCorrectIncongruent: 	proportion correct responses in trials with target-incongruent flankers (flankers that point in the opposite direction as target)

alertingEffectAcc: 	propCorrectNoAudio - propCorrectAudio => Effect of achieving and maintaining alertness
orientingEffectAcc: propCorrectInvalidSC - propCorrectValidSC => Effect of orienting attention towards a specific location of information
executiveEffectAcc: propCorrectincongruent - propCorrectcongruent => Effect of resolving conflict between several possible responses (executive function)

+ all 2-way and 3-way interactions data points
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________

Design:
2 audio signal conditions (beep vs. no beep) x
3 location cue conditions (no cue, valid spatial cue, invalid spatial cue) x
2 flanker congruence (congruent vs. incongruent) x
2 locations (above vs. below fixation) x
2 directions (center arrow points to right or left) = 48 trials per block

A) 1 Block of 24 Practice trial sequences with full feedback, including summary feedback of speed and accuracy
=> 8 no cue; 8 ValidSC; 8 InvalidSC
B) 6 Blocks of 48 trial sequences each - no feedback (balanced design)
- trial order random

TRIAL SEQUENCE:
-> fixation (randomly chosen presentation time: 400-1600ms, in 100ms increments) 
-> audio/no audio signal (50ms)
-> fixation (400ms)
-> cue/no cue (100ms) 
-> fixation (400ms) 
-> target (max.1700ms)
-> intertrialinterval (variable; complete trialduration = 4450s)
(see Ishigami & Klein, 2011)
___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________

In this script, stimuli are presented in proportional sizing to the canvas.
Fine-tune fontsize of stimuli, distance of flanker to target, and position of target above and below 
fixation cross under section EDITABLE PARAMETERS.

The audio signal was produced in Audacity:
2000Hz, 50ms with amplitude = 1

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
Note: Instructions are modelled after the instructions used for the Inquisit ANT and updated for
the ANT-I by Millisecond Software.
(which use instruction based on: http://www.sacklerinstitute.org/cornell/assays_and_tools/)

___________________________________________________________________________________________________________________	
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:
//sizing parameters:
/ fontSizeFixation = 5%					//regulates the size of the fixation cross, in canvas height percentage
/ cueSize = 5%							//regulates the size of the cues, in canvas height percentage
/ arrowSize = 6%						//regulates the size of the target/flanker, in canvas height percentage
/ flankerDistance = 7%					//the relative screen distance between stimuli, in canvas width percentage
/ topY = 45%							//the y-coordinate of the target above the fixation cross
/ bottomY = 55%							//the y-coordinate of the target below the fixation cross


//timing parameters:
/ readyDuration = 2000					//sets the duration (in ms) of the get-ready trial
/ completeTrialDuration = 4450			//sets the complete duration of one trial sequence

/ audioDuration = 50					//sets the duration (in ms) allotted to the audio signal
										//Note: the duration of the audio signal is predetermined by the length of the audiofile in this script

/ audioCueIsi = 400						//sets the duration (in ms) of the fixation cross after the audio signal
/ cueDuration = 100						//sets the duration of the cue presentation (default: 100ms)
/ cueTargetIsi = 400					//sets the duration of the fixation cross after cue presentation (default: 400ms)
/ targetDuration = 1700					//sets the maximal duration of the target/flanker presentation (default: 1700ms)
/ practiceFeedbackDuration = 750		//sets the duration of the feedback trial during practice (default: 750ms)

//response keys:
/ responseKeyLeft = "E"
/ responseKeyRight = "I"