Return to the Dual Task Adaptive N-Back Task page
						
									DUAL N-BACK TASK - adaptive
SCRIPT INFO

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software LLC
Date: October, 2011
last updated: 10-24-2016 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC

Copyright © 10-24-2016 Millisecond Software


BACKGROUND INFO

											*Purpose*
This Inquisit script provides trials and instructions for adaptive DUAL n-back tasks with blue squares in 8 different screen locations 
as well as spoken Roman letters.
The script follows the procedure for adaptive DUAL n-back tasks provided by Jaeggi et al (2010), Experiment 2, and implements 
original instructions (or new ones closely following the original ones) and stimuli kindly provided by the authors. 
This script provides code to run N=1 to infinite levels of N.

Reference:
Jaeggi S.M, Studer-Luethi, B., Buschkuehl, M, Su, Y.-F., Jonides, J., Perrig, W.J. (2010). The relationship between n-back performance
and matrix reasoning - implications for training and transfer. Intelligence, 38, 625-635.

Millisecond Software LLC thanks Jaeggi et al (2010) for kindly providing original instruction materials, stimuli, as well as ample assistance!


											  *Task*
In dual n-back tasks, participants are presented with two sequences of stimuli in two modalities at the same time
Here:
a) VISUAL: a random sequence of blue squares that can be presented in 8 different locations on the screen  and 
b) AUDITORY: a random sequence of 8 spoken Roman letters 
In each trial one visual and one auditory stimulus are presented and participants are asked to indicate whether the currently presented stimuli
fulfill the following criteria:

for N=1 trials:
- is the location of the square the same as the one  in the previous trial? If so (it's a target), and press "A".  If not, don't press "A".
- is the letter the same as the one in the previous trial? If so (it's a target), and press "L". If not, don't press "L".

for N=2 trials:
- is the location of the square the same as the one  two trials before? If so (it's a target), and press "A". If not, don't press "A".
- is the letter the same as the one two trials before? If so (it's a target), and press "L". If not, don't press "L".

etc.


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

(1) Raw data file: 'DualTaskAdaptiveNBack_raw.iqdat' (a separate file for each participant)

build:							Inquisit build
computer.platform:				the platform the script was run on
date, time, subject, group:		date and time script was run with the current subject/groupnumber 
values.N:						the type of N-back trial
blockcode:						the name of the current block
blocknum:						block number
values.TotalBlocks:				the total number of experimental blocks run
trialcode:						the name of the current trial
trialnum:						trialnumber
starttrialcounter:				counts the number of start trials run
stimulusitem:					first shown stimulus (=square)
values.v_position:				contains the position of the current square
									(1 = (25, 25), 2 = (50, 25), 3 = (75, 25), 4 = (25, 50), 5 = (75, 50), 6 = (25, 75), 7 = (50, 75), 8 = (75, 75))
values.v_currenttarget:			the position number of the current target shape
stimulusitem:					second presented stimulus (=sound)
values.a_stimnumber:			contains item number of the currently presented sound
values.v_currenttarget:			the item number of the current target sound
values.1response:				the value of the first response (if any)
values.2response:				the value of the second response (if any)
correct:						1 = if correct response, 0 = otherwise
values.1latency:				the latency value of 1response (in ms)
values.2latency:				the latency value of 2response (in ms)
latency:						the latency value of the last response made (if any), MAX=3000 (=no response made)
values.trial_Hitv:				trial Hit for visual stimulus (1 = hit, 0 = no hit) (visual Hit: any trial response -either the first or the second- for a visual target)
values.trial_Missv:				trial Miss for visual stimulus (1 = miss, 0 = no miss) (visual Miss: no trial response for a visual target if a visual target was presented)
values.trial_CRv:				trial Correct Rejection  for visual stimulus (1 = CR, 0 = no CR) (visual CR: no trial response for a visual target if no visual target was presented)
values.trial_FAv:				trial False Alarm for visual stimulus (1 = FA, 0 = no FA) (visual FA: any trial response for visual target -either the first or the second- if no visual target was presented)
values.trial_Hita:				trial Hit for auditory stimulus (1 = hit, 0 = no hit) (auditory Hit: any trial response -either the first or the second- for an auditory target)
values.trial_Missa:				trial Miss for auditory stimulus (1 = miss, 0 = no miss) (auditory Miss: no trial response for an auditory target if an auditory target was presented)
values.trial_CRa:				trial Correct Rejection  for auditory stimulus (1 = CR, 0 = no CR) (auditory CR: no trial response for an auditory target if no auditory response was presented)
values.trial_FAa:				trial False Alarm for auditory stimulus (1 = FA, 0 = no FA) (auditory FA: any trial response for an auditory target -either the first or the second- if no auditory response was presented)
values.v_Hits:					the number of Hits for visual modality
values.v_FalseA:				the number of False Alarms for visual modality
values. v_Misses:				the number of Misses for visual modality
values.v_CorrReject:			the number of Correct Rejections for visual modality
values.a_Hits:					the number of Hits for auditory modality
values.a_FalseA:				the number of False Alarms for auditory modality
values. a_Misses:				the number of Misses for auditory modality
values.a_CorrReject:			the number of Correct Rejections for auditory modality
values.v_TotalHits:				the number of total hits across all experimental blocks for the visual modality
values.a_TotalHits:				the number of total hits across all experimental blocks for the auditory modality
values.v_TotalFA:				the number of total false alarms across all experimental blocks for the visual modality
values.a_TotalFA:				the number of total false alarms across all experimental blocks for the auditory modality
values.DV:						the proportion of ((v_TotalHits - v_TotalFA) + (a_TotalHits - a_TotalFA)/2) /number of total experimental blocks

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

script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				subject id number
script.groupid:					group id number
script.elapsedtime:				time it took to run script (in ms)
computer.platform:				the platform the script was run on
/completed:						0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run)
values.v_TotalHits:				the number of total hits across all experimental blocks for the visual modality
values.a_TotalHits:				the number of total hits across all experimental blocks for the auditory modality
values.v_TotalFA:				the number of total false alarms across all experimental blocks for the visual modality
values.a_TotalFA:				the number of total false alarms across all experimental blocks for the auditory modality
values.DV:						the proportion of ((v_TotalHits - v_TotalFA) + (a_TotalHits - a_TotalFA)/2) /number of total experimental blocks


EXPERIMENTAL SET-UP
(1) Dual n-back Experiment (adaptive) information:
- After instructions, participants receive 10 trials for levels N = 1, N = 2, N = 3  for practice (with the possibility for more practice if desired)
- After practice, participants start out at level N = 1 and depending on performance, move up or stay on level N = 1
- After a total of 15 blocks, the experiment ends

(2) Dual n-back BLOCK information:
- Each dual n-task block consists of 20 + trials. 
=> + trials are the N trials that cannot display target shapes yet (=start trials). Their numbers vary depending on N. The data collected during these 
		start trials are NOT included in performance counts for Correct Rejections/False Alarms.
=> Of the actual  20 experimental trials, 4 present a visual target only, 4 present an auditory target only, 2 present both targets
and 10 present no targets at all
- The computer selects randomly 
a) which kind of trial 
b) what letter/ square location to use if it is not a target

(3) Dual n-back TRIAL informations:
- Each trial presents the square/letter for 500ms and waits another 2500ms before presenting the next square/letter in the sequence.
- Participants have the entire 3000ms to respond by pressing "A", "L", or both if they detect a target or two.


INFORMATION FOR CODE-CHANGES (e.g. ADDITIONAL/DIFFERENT LEVELS OF N)
Instructions for changing code for additional Ns are provided with this script. Please check the following sections for the relevant info:
1. Custom Values
2. Instructions: (a) Instruction Slides (b) Instruction Blocks
3. Trials
4. Blocks: (a) Practice (b) Experimental


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:

/StartN = 1						the starting N
								!Note: if the starting N changes other changes need to be made, 
/LastPracticeN = 3				last N tested in Practice (default is 3)
/NumberTestBlocks = 15			Number of test blocks run (default is 15)
/Debugmode = 0					Debugmode = 1, target alerts are presented
								Debugmode = 0, target alerts are turned-off (default)
/stimulusPresentationtime:		the presentation time (in ms) of the stimuli (default: 500ms)								
/SOA:							the stimulus onset asynchrony in ms (default: 3000ms)- also response Window							

Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Security Statement | Employment