User Manual: Inquisit Centre for Research on Safe Driving Attentional Network Task (CRSD-ANT) - Arrows


__________________________________________________________________________________________________________________	

					'CENTRE FOR RESEARCH ON SAFE DRIVING' ATTENTION NETWORK TASK (CRSD-ANT)
									- Script runs with arrow stimuli-
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 05-11-2015
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 L. Raghani for helping with this script!

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements the 'Centre for Research on Safe Driving' shortened Attention Network Task (CRSD-ANT), 
a behavioral measure of alerting, orienting and executive attention.
Compared to the original ANT (Fan et al, 2002), the CRSD-ANT can be run within 10 minutes.
											
The implemented procedure is based on:

Weaver, B.,Bédarda, M., and McAuliffe, J. (2013). Evaluation of a 10-minute Version of the Attention
Network Test. The Clinical Neuropsychologist, Vol. 27, No. 8, 1281–1299.

The original CRSD-ANT is available as a Javascript program at:
	http://crsd.lakeheadu.ca/crsd-ant/

The original CRSD-ANT is programmed by:
    Luke Docksteader - http://docksteaderluke.com
    Kris Scott - http://krssctt.com
	
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 directly above or below a fixation cross. 
Participants have to decide whether the central arrow looks right or left. 
Several cue conditions (4) (may) alert the participants that the arrows are about to come on screen and potentially where on the screen
(above or below fixation).

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

Notes: 
in this script the effects are calculated using the same measures as in the original CRSD-ANT Javascript program

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

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

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

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

Min_validresponselatency:	minimum response latency (in ms) that is considered valid and not anticipatory (default: 100ms)

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


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

Note: summary statistics for latencies are based on correct responses with a latency >= parameters.Min_validresponselatency (default: 100ms)

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)

Min_validresponselatency:	minimum response latency (in ms) that is considered valid and not anticipatory (default: 100ms)
trialcount:					counts the number of test trials run

Note: 
(1) all Accuracy measures: based on valid responses (correct = correct AND valid; error = anything else)
(2) all Latency measures: based on correct and valid responses; 
valid responses are responses with latencies >= values.min_responselatency (default: 100ms)

overall_percenterror:			overall %error rate for test trials
medianRT:						overall median RT for test trials
meanRT:							overall mean RT for test trials
stdRT:							overall standard deviation of latencies for test trials
MinRT:							minimum RT in test trials
MaxRT:							maximum RT in test trials

nocue:							mean of the congruent and incongruent RT medians for no cue condition => mean(medianrt cNC, medianrt icNC)
center:							mean of the congruent and incongruent RT medians for center cue condition 
double:							mean of the congruent and incongruent RT medians for double cue condition 
spatial:						mean of the congruent and incongruent RT medians for spatial cue condition
congruent:						mean of the congruent RT medians across cue condition
incongruent:					mean of the incongruent RT medians across cue condition

AlertingEffect = nocue - doublecue (see original CRSD-ANT)
OrientingEffect = centercue - spatialcue (see original CRSD-ANT)
ConflictEffect = incongruent - congruent (see original CRSD-ANT)
(see original CRSD-ANT)

medianRT_NC_C:					median RT for congruent, no cue condition
medianRT_NC_IC:					median RT for incongruent, no cue condition
medianRT_CC_C:					median RT for congruent, center cue condition
medianRT_CC_IC:					median RT for incongruent, center cue condition
medianRT_DC_C:					median RT for congruent, double cue condition
medianRT_DC_IC:					median RT for incongruent, double cue condition
medianRT_SC_C:					median RT for congruent, spatial cue condition
medianRT_SC_IC:					median RT for incongruent, spatial cue condition

meanRT_cNC:						mean RT for congruent, no cue condition
meanRT_icNC:					mean RT for incongruent, no cue condition
meanRT_cCC:						mean RT for congruent, center cue condition
meanRT_icCC:					mean RT for incongruent, center cue condition
meanRT_cDC:						mean RT for congruent, double cue condition
meanRT_icDC:					mean RT for incongruent, double cue condition
meanRT_cSC:						mean RT for congruent, spatial cue condition
meanRT_icSC:					mean RT for incongruent, spatial cue condition

percerror_NC:					percent error in no cue condition
percerror_CC:					percent error in center cue condition
percerror_DC:					percent error in double cue condition
percerror_SC:					percent error in spatial cue condition

percerror_NC_C:					percent error in congruent, no cue condition
percerror_NC_IC:				percent error in incongruent, no cue condition
percerror_CC_C:					percent error in congruent, center cue condition
percerror_CC_IC:				percent error in incongruent, center cue condition
percerror_DC_C:					percent error in congruent, double cue condition
percerror_DC_IC:				percent error in incongruent, double cue condition
percerror_SC_C:					percent error in congruent, spatial cue condition
percerror_SC_IC:				percent error in incongruent, spatial cue condition


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

A) 1 Block of 32 Practice trial sequences with feedback,
B) 2 Blocks of 64 trial sequences each - order randomly determined
	EXPERIMENTAL BLOCKS:
	64 trial sequences: 2 (repetitions) x 4 (cue conditions: no cue/center cue/double cue/spatial cue) x 2 (flanker conditions: congruent vs. incongruent) x 2 (target positions: above or below) x 2 (target directions: right or left)
	TRIAL SEQUENCES (one sequence for each cue condition)
	fixation (randomly* chosen presentation time: 400ms-1200ms) -> cue (100ms) -> fixation (400ms) -> target (1500ms)-> intertrialinterval (3000ms)
	
	*random: by default, random selection with replacement. To change to to section EDITABLE LISTS. 

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
Notes: 
* This script comes with the stimuli to run it with arrows
* This script uses a simple black dot as the cue as opposed to a *
* the userinterface (e.g. size of targets, position of targets, flanker distance) can be fine-tuned under EDITABLE values
By default, they are proportional to the specified canvas of the screen (4:3 canvas; see section DEFAULTS).
Disclaimer: depending on the size of the monitors the script is run on, stimuli will have different physical sizes.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
Instructions are based on the original instructions screen published at:
http://crsd.lakeheadu.ca/crsd-ant/

Instructions are provided by Millisecond Software as htm/html pages and can be edited by changing the provided htm/html files.
To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac) or Notepad (Windows).

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

Stimuli Dimension/Placement:
/fontsize_fixation:						regulates the size of the fixation cross, in canvas height percentage (default:  5%)
/fontsize_cue:							regulates the size of the cues, in canvas height percentage (default: 5%)
/picturesize:							regulates the size of the target/flanker, in canvas height percentage (default: 8%)
/flankerdistance:						the relative screen distance between stimuli, in canvas width percentage (default: 8%)
/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:
/cue_duration:							sets the duration of the cue presentation (default: 100ms)
/fixation2_duration:					sets the duration of the fixation cross after cue presentation (default: 400ms)
/target_duration:						sets the maximal duration of the target/flanker presentation (default: 1500ms); 
										equals the response window
/iti_duration:							sets the intertrial interval (default: 3000ms)
/practicefeedback_duration:				sets the duration of the feedback trial during practice (default: 750ms)
/Min_validresponselatency:				minimum response latency (in ms) that is considered valid and not anticipatory (default: 100ms)

Response Keys:
/responsekey_left:						the left response key (default: "E")
/responsekey_right:						the right response key (default: "I")