User Manual: Inquisit Modified Attentional Network Task


___________________________________________________________________________________________________________________	

						Modified ATTENTION NETWORK TEST (ANT) - Wang et al (2015)
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date:	06-13-2013
last updated:  02-16-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-16-2022 Millisecond Software

Millisecond Software thanks Dr. Richard Canfield for collaborating on this script and Dr. Yi-Feng Wang et al
for providing their original e-prime script!

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements a modified version of the Attention Network Test (ANT), a behavioral measure of alerting, orienting and 
executive attention. The modified ANT procedure builds on the original ANT procedure by Fan et al (2002) and allows for 
detailed computing of the relationships amongst the three attention networks. The implemented procedure is based on:											

Yi-Feng Wang, Xiu-Juan Jing, Feng Liu, Mei-Ling Li, Zhi-Liang Long, Jin H. Yan & Hua-Fu Chen (2015).
Reliable Attention Network Scores and Mutually Inhibited Internetwork Relationships Revealed by
Mixed Design and Non-orthogonal Method.
www.nature.com/scientificreports: Scientific Reports | 5:10251 | DOI: 10.1038/srep10251

original ANT:
Fan, J., McCandliss, B. D., Sommer, T., Raz, A., & Posner, M. I. (2002). Testing the efficiency and independence 
of attentional networks. Journal of Cognitive Neuroscience, 14, 340–347.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are presented 5 arrows either on, above or below a screen-centered fixation cross. 
Participants have to decide whether the center arrow points right or left.
A cue '*' might alert participants that the targets/flankers are about to come on screen.

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

___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________
The default data stored in the data files are:

(1) Raw data file: 'ant_wang_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 after practice)
trialcode: 				the name and number of the currently recorded trial

prefatory:				1 = prefatory trial (not counted towards summary data); 0 = not a prefatory trial
fixation1_duration:		the duration (in ms) of the starting fixation cross in each trial

cuecondition:			sets the current cue condition (1 = no cue; 2 = center cue)
congruence:				1 = congruent target; 2 = incongruent target (flanker and target point in opposite directions)
targetposition:			sets position of target (0 = center position; 1 = above fixation; 2 = below fixation)
targetdirection:		sets the direction of the target (1 = right; 2 = left)
picture.flanker1.currentItem/
picture.flanker4.currentItem:	store the arrow images used as flanker1-flanker4 as well as the target


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

response:		the response of participant (scancode of response button: 30 = left A; 38 = right L; 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_wang_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)

General Notes:
* Summary Variables are based on test trials with 'prefatory = 0' 
(=> the first 4 trials in each block with 'prefatory = 1' are excluded)
* mean latencies are based on latencies of correct responses only

propCorrect:				overall proportion correct
meanRT:						overall mean correct response latency (in ms)
SD:							overall standard deviation of correct response latencies (in ms)

A_meanRT_CC:				mean latency (in ms) to center cue trials in A block
A_meanRT_NC:				mean latency (in ms) to no cue trials in A block
O_meanRT_CT:				mean latency (in ms) to center target trials in O block
O_meanRT_ST:				mean latency (in ms) to spatial target trials in O block

E_meanRT_CO:				mean latency (in ms) to congruent trials in E block
E_meanRT_ICO:				mean latency (in ms) to incongruent trials in E block

AO_meanRT_CC_CT:			mean latency (in ms) to center cues followed by center targets in AO block
AO_meanRT_CC_ST:			mean latency (in ms) to center cues followed by spatial targets in AO block
AO_meanRT_NC_CT:			mean latency (in ms) to no cues followed by center targets in AO block
AO_meanRT_NC_ST:			mean latency (in ms) to no cues followed by spatial targets in AO block

AE_meanRT_CC_CO:			mean latency (in ms) to center cues followed by congruent flanker/targets in AE block
AE_meanRT_CC_ICO:			mean latency (in ms) to center cues followed by incongruent flanker/targets in AE block
AE_meanRT_NC_CO:			mean latency (in ms) to no cues followed by congruent flanker/targets in AE block
AE_meanRT_NC_ICO:			mean latency (in ms) to no cues followed by incongruent flanker/targets in AE block

OE_meanRT_CT_CO:			mean latency (in ms) to congruent center targets in OE block
OE_meanRT_CT_ICO:			mean latency (in ms) to incongruent center targets in OE block
OE_meanRT_ST_CO:			mean latency (in ms) to congruent spatial targets in OE block
OE_meanRT_ST_ICO:			mean latency (in ms) to incongruent spatial targets in OE block

Network Effects:
A: 		Alerting Effect
O:		Orienting Effect
E:		Executive Control Effect

AO:		influence of alerting on orienting
OA:		influence of orienting on alerting

AE:		influence of alerting on excutive control
EA:		influence of executive control on alerting

OE:		influence of orienting on executive control
EO:		influence of executive control on orienting

Note: In these equations, a negative effect denoted beneficial in RT, whereas a positive effect represented cost in RT.
(see Wang et al, 2015, p.9)

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________

Block Sequence:
	1 = generalInstructions; => present the general instructions
	2 = ANT_practice; => runs the practice IF parameters.runPractice = true
	3-8 = noreplace(A, O, E, AE, AO, OE); => run the 6 experimental blocks in randomized order
		Note: select the blocks that you would like to run under Editable Parameters
	
1. optional ANT_practice:
- run 20 trials (selection taken from Wang et al's e-prime script)
- order is randomized

2. A-Block: -> manipulates cuecondition (no cue vs. center cue) with fixed center position and congruent targets
- run 4 prefatory 
- run 48 trials (randomized trial order) =  2 cueconditions x 2 target directions (points left vs. right) x 12 repetitions

3. O-Block: -> manipulates targetposition (center target vs. spatial target) with fixed cue condition (no cue) and congruent targets
- run 4 prefatory 
- run 48 trials (randomized trial order) =  2 targetpositions (center vs. not center (split into top/bottom)) x 2 target directions x 12 repetitions

4. E-Block: -> manipulates congruence (congruent targets vs. incongruent targets) with fixed cue condition (no cue) and fixed center position 
- run 4 prefatory 
- run 48 trials (randomized trial order) =  2 target congruence x 2 target directions x 12 repetitions

5. AO-Block: -> manipulates cuecondition and spatial condition (keep congruence fixed: only congruent targets)
- run 4 prefatory 
- run 96 trials (randomized trial order) = 2 cuecondition x 2 spatial condition (center vs. not center (split into top/bottom)) x 2 target directions x 12 repetitions

6. AE-Block: -> manipulates cuecondition and target congruence (keep spatial position of target fixed: only center targets)
- run 4 prefatory 
- run 96 trials (randomized trial order) = 2 cuecondition x 2 congruence x 2 target directions x 12 repetitions

7. OE-Block: -> manipulates spatial position and congruence (keep cue condition fixed: only no cue trials)
- run 4 prefatory 
- run 96 trials (randomized trial order) = 2 congruence x 2 spatial condition (center vs. not center (split into top/bottom)) x 2 target directions x 12 repetitions

Trial Sequence:
Fixation Cross (400-1600ms)->Cue (100ms)-> Fixation(300ms)->targets/flankers (max: 1700ms)->ITI (2600-target response latency)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
Size of Stimuli:
Fine-tune size of stimuli, distance of flanker to target, and position of target above and below 
fixation cross under section EDITABLE PARAMETERS

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
Note: Instructions are modelled after the instructions generously made available by
Wang et al's original e-prime version (slightly edited)
See section Editable Instructions

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

Experimental Set-up:
/runPractice:							1 (true) = the practice session is run (default)
										0 (false) = no practice session is run
										
/runA:									1 (true) = block A is run (default)
										0 (false) = no block A is run
										
/runE:									1 (true) = block E is run (default)
										0 (false) = no block E is run	
	
/runO:									1 (true) = block O is run (default)
										0 (false) = no block O is run	
										
/runAO:									1 (true) = block AO is run (default)
										0 (false) = no block AO is run
										
/runAE:									1 (true) = block AE is run (default)
										0 (false) = no block AE is run	
	
/runOE:									1 (true) = block OE is run (default)
										0 (false) = no block OE is run											

Stimuli Dimension/Placement:
/fontsize_fixation:						regulates the size of the fixation cross, in canvas height percentage (default:  5%)
/cueSize:								regulates the size of the cues, in canvas height percentage (default: 5%)
/arrowsize:								regulates the size of the target/flanker, in canvas height percentage (default: 6%)
/flankerdistance:						the relative screen distance between stimuli, in canvas width percentage (default: 7%)
/top_y:									the y-coordinate of the target above the fixation cross (default: 40%)
/bottom_y:								the y-coordinate of the target below the fixation cross (default: 60%)

Trial Durations:
expressions.values.fixation1_duration:  randomly selects durations (in ms) for the starting fixation cross between 400 and 1600ms
										NOTE: change under expressions.values.fixation1_duration
										
/cue_duration:							sets the duration (in ms) of the cue presentation (default: 100ms)
/fixation2_duration:					sets the duration (in ms) of the fixation cross after cue presentation (default: 300ms)
/target_duration:						sets the maximal duration (in ms) of the target/flanker presentation (default: 1700ms)
/fixation3_duration:					sets the max.duration (in ms) of the fixation cross presented after the target disappears (default: 2600ms)
										Note: the duration is adjusted during runtime 

Response Keys:
/responsekey_left:						scancode for the left response key (default: "A")
/responsekey_right:						scancode for the right response key (default: "L")