User Manual: Inquisit Attentional Network Task (Child Version)


___________________________________________________________________________________________________________________	

							ATTENTION NETWORK TEST (ANT) - Child Version
							*Danish Version*
___________________________________________________________________________________________________________________	


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

Script Copyright © 01-18-2024 Millisecond Software

Millisecond Software thanks Anne Thingbak for providing her Danish translations!

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements a child friendly version of the Attention Network Test (ANT), a behavioral measure 
of alerting, orienting and executive attention. The implemented procedure is based on:

Rueda, M. R., Fan, J., McCandlis, B. D., Halparin, J. D., Gruber, D. B., Pappert Lercari, L., & Posner, M.I (2004).
Development of attentional networks in childhood. Neuropsychologia, 42, 1029–1040.

The original ANT for adults was published in:

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.

The original ANT for adults and the child ANT as well as all stimuli used are generously shared by 
the original authors/Sackler Institute at:  http://www.sacklerinstitute.org/cornell/assays_and_tools/

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are presented a fish either directly above or below a fixation cross. The fish may be flanked by other 
fish  (3 flanker conditions). Participants have to decide whether the central fish's mouth points right or left. 
Several cue conditions (4)  (may) alert the participants that the fish is about to come on screen and potentially where on the screen
(above or below the fixation cross).

Differences in mean reaction times in the different 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
* Conflict Effect: Effect of resolving conflict between several possible responses

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

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

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

cuecondition:				the current cue condition (1 = no cue; 2 = center cue; 3 = double cue; 4 = spatial cue)
flankercondition:			the current flanker condition (1 = neutral; 2 = congruent; 3 = incongruent)
targetposition:				position of target relative to fixation (1 = above fixation; 2 = below fixation)
targetdirection:			the direction of the target (1 = right; 2 = 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%)
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: 'childant_danish_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)

trialcount:					counts the number of trials run (resets after practice)
overallPropCorrect:			proportion correct across all testblock trials
meanRT_correct:				overall mean RT (of correct responses; in ms) for test trials
medianRT_correct:			overall median RT (of correct responses; in ms) for test trials

*****************
Main Effects:
*****************

propCorrect_NoCue:				proportion correct across all NoCue test trials
meanRT_correctnocue:			mean RT (of correct responses; in ms) for NoCue test trials
medianRT_correctnocue:			median RT (of correct responses; in ms) for NoCue test trials

propCorrect_CenterCue:			proportion correct across all CenterCue test trials
meanRT_correctcentercue:		mean RT (of correct responses; in ms) for CenterCue test trials
medianRT_correctcentercue:		median RT (of correct responses; in ms) for CenterCue test trials

propCorrect_DoubleCue:			proportion correct across all DoubleCue test trials
meanRT_correctdoublecue:		mean RT (of correct responses; in ms) for DoubleCue test trials
medianRT_correctdoublecue:		median RT (of correct responses; in ms) for DoubleCue test trials

propCorrect_SpatialCue:			proportion correct across all SpatialCue test trials
meanRT_correctspatialcue:		mean RT (of correct responses; in ms) for SpatialCue test trials
medianRT_correctspatialcue:		median RT (of correct responses; in ms) for SpatialCue test trials

propCorrect_Congruent:			proportion correct across all Congruent test trials
meanRT_correctCongruent:		mean RT (of correct responses; in ms) for Congruent test trials
medianRT_correctCongruent:		median RT (of correct responses; in ms) for Congruent test trials

propCorrect_Incongruent:		proportion correct across all Incongruent test trials
meanRT_correctIncongruent:		mean RT (of correct responses; in ms) for Incongruent test trials
medianRT_correctIncongruent:	median RT (of correct responses; in ms) for Incongruent test trials

propCorrect_Neutral:			proportion correct across all Neutral(=only the middle fish presented) test trials
meanRT_correctNeutral:			mean RT (of correct responses; in ms) for Neutral(=only the middle fish presented) test trials
medianRT_correctNeutral:		median RT (of correct responses; in ms) for Neutral(=only the middle fish presented) test trials

*****************
Interactions:
*****************
propCorrect_congruentNC: 		proportion correct responses in trials with target-congruent flankers in No Cue Condition
meanRT_correctCongruentNC: 		mean response time (in ms) of correct responses in trials with target-congruent flankers in No Cue Condition
medianRT_correctCongruentNC: 	median response time (in ms) of correct responses in trials with target-congruent flankers in No Cue Condition
propCorrect_incongruentNC: 		proportion correct responses in trials with target-incongruent flankers in No Cue Condition
meanRT_correctIncongruentNC: 	mean response time (in ms) of correct responses in trials with target-incongruent flankers in No Cue Condition
medianRT_correctIncongruentNC: 	median response time (in ms) of correct responses in trials with target-incongruent flankers in No Cue Condition
propCorrect_neutralNC: 			proportion correct responses in neutral trials in No Cue Condition
meanRT_correctNeutralNC: 		mean response time (in ms) of correct responses in in neutral trials in No Cue Condition
medianRT_correctNeutralNC: 		median response time (in ms) of correct responses in in neutral trials in No Cue Condition
(same for CC= center condition; DC = double cue condition; SC = spatial condition)

Expressions that use above expressions and calculate the 3 attentional network effects 
based on means OR median RTs (Rueda et al, 2004) of correct responses

alertingeffect_meanbased  = Mean CorrRT nocue - Mean CorrRT doublecue
orientingeffect_meanbased = Mean CorrRT centercue - Mean CorrRT spatialcue
conflicteffect_meanbased = Mean CorrRT incongruent - Mean CorrRT congruent

alertingeffect_medianbased = Median CorrRT nocue - Median CorrRT doublecue
orientingeffect_medianbased = Median CorrRT centercue - Median CorrRT spatialcue
conflicteffect_medianbased = Median CorrRT incongruent - Median CorrRT congruent

__________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
 
4 cue conditions (no cue, center cue, double cue, spatial cue) x 3 flanker conditions (neutral, congruent, incongruent)
within-subjects design

A) 1 Block of 24 Practice trial sequences with feedback,
B) 3 Blocks of 48 trial sequences each - feedback optional (default: with feedback, Editable Values -> parameters.experimentalfeedback)
	EXPERIMENTAL BLOCKS:
	48 trial sequences: 1 (repetition) x 4 (cue conditions) x 3 (flanker conditions) x 2 (target positions) x 2 (target directions) - order randomly determined
	TRIAL SEQUENCES (one sequence for each cue condition)
	fixation (randomly chosen presentation time) -> cue (150ms) -> fixation (450ms) -> target (1700ms)-> intertrialinterval (1000ms)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________

The original fish can be downloaded from: http://www.sacklerinstitute.org/cornell/assays_and_tools/
This script runs with a different set of fish (Note: the fish in this script are also used in the childFlanker.iqx).

* Stimuli can easily be edited under section EDITABLE STIMULI
* This script uses a yellow star as the cue

Size of Stimuli:
Rueda et al (2004) give specific dimensions of the size and distance of targets/flankers (p.1031) for the adult version
	=> distance participant/screen: about 53cm
	=> single fish: each fish covered 1.6◦ of visual angle
	=> flanker/target distance: adjacent fish were separated by 0.21◦
	=> distance target/fixation: target fish was presented about 1◦ above or below +

This script does NOT attempt to replicate these dimensions as different monitors require different fontsizes etc.
Fine-tune sizes of stimuli, distance of flanker to target, and position of target above and below 
fixation cross under section EDITABLE values

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
Instructions are provided by Millisecond Software. They adapt to touchscreens 
via including helper scripts:
"keyboardinstruction_images.iqx" or "touchscreeninstruction_images.iqx"

The provided instructions are not original. 
The original instructions are published at:
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:

Stimuli Dimension/Placement:
/fontsize_fixation:						regulates the size of the fixation cross, canvas height % (default:  5%)
/cueSize:								regulates the size of the cue, canvas height %  (default: 5%)
/fishSize:								regulates the size of the fish, canvas height %  (default: 7%)
/flankerdistance:						the relative screen distance between fish, canvas width %  (default: 8%)
/top_y:									the y-coordinate of the target above the fixation cross, canvas height %  (default: 40%)
/bottom_y:								the y-coordinate of the target below the fixation cross, canvas height %  (default: 60%)

Trial Durations:
/cue_duration:							sets the duration (in ms) of the cue presentation (default: 150ms)
/fixation2_duration:					sets the duration (in ms) of the fixation cross after cue presentation (default: 450ms)
/ target_duration:						sets the duration (in ms) of the target presentation (default: 1700ms)
/feedback_duration:						sets the duration (in ms) of the feedback trial (default: 2000ms)
/ITI_practice:							sets the duration (in ms) of trial.ITI (default: 1000ms)


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

/experimentalfeedback:					1 = feedback only during practice; 
										2 = feedback for experimental trials also (default)