Return to the Digit Symbol Substitution Task - Keyboard Input - Form 1 page
									DIGIT SYMBOL SUBSTITUTION TASK - uses keyboard input

Script Author: Katja Borchert, Ph.D. ( for Millisecond Software, LLC
(reusing some matrix code from the Inquisit Information Sampling Script by David Nitz)
Date: 09-27-2012
last updated: 10-31-2019 by K.Borchert ( for Millisecond Software LLC

Script Copyright © 10-31-2019 Millisecond Software


This script implements a computerized Inquisit version of the WISC Coding Task (PROCESSING SPEED TASK)
developed by Amy Finn (Ph.D), John Gabrieli (Ph.D.) and Julia Leonard.
Symbols provided by Millisecond Software.

Participant are presented with a 18 (columns) x 16 (rows) matrix. Odd rows contain symols,
even rows contain empty answer boxes (18x8 = 144).
The task is to translate the symbols into digits with the help of a provided key within a 2 min time frame. 

Note: in this script, the default response device is the keyboard. To use mouse input, check out

The default data stored in the data files are:

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

Inquisit Version:					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 ID, Group ID, Session ID:	with the current subject/groupnumber/session id
Blockcode, Blocknum:				the name and number of the current block
Trialcode, Trialnum: 				the name and number of the currently recorded trial
										(Note: not all trials that are run might record data but they will still be reflected by trialnum; 
										by default data is collected unless /recorddata = false is set for a particular trial/block)
Box									ordinal number of the box within the grid for the current symbol
Key Response:						scan code of key pressed for current symbol
Response:							digit value of the response key
Correct Response:					the correct digit for the current symbol
ACC:								1 if given response is correct, 0 if given response is incorrect
Latency:							time in milliseconds for the current response
Correct Count:						total count of correct responses
Error Count: 						total count of erroroneous responses

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

Computer Platform:					the platform the script was run on (win/mac/ios/android)
Date:								date script was run
Time:								time script was started
Subject ID:							assigned subject id number
Group ID:							assigned group id number
Session ID:							assigned session id number
Script Duration:					time it took to run script (in ms); measured from onset to offset of script
Script Completion:					0 = script was not completed (prematurely aborted); 
									1 = script was completed (all conditions run)

Totalseconds:						maximum time in seconds allowed for the task
Correct Count:						total count of correct responses
Error Count: 						total count of erroroneous responses
Seconds per Correct:				average number of seconds per correct response


* 9 practice boxes that appear in gray (practice grid boxes are presented separately from the complete grid)
* 3 of these are already filled in
* 6 need to be filled in by participant
* the box that needs to be filled in next is highlighted in a different color
* if the answer is correct, the answer is filled in the box and the next practice box is highlighted
* if the answer is incorrect, a text stimulus (in red) appears that reminds participant to correct
the answer. In addition, the box (with the incorrect answer choice) turns red.
* once all practice boxes are filled in correctly, participants press the space bar to continue
* after a final instruction screen comes up, participants press the space bar to start the test
* the complete grid appears and the timed portion of the test starts

* the first presented coding matrix/grid contains 135 test boxes (135 = 144 - 9 practice boxes)
(if another coding matrix is necessary, it will contain 144 test boxes)
* there is no feedback
* the next box that needs to be filled in is highlighted in a different color
(highlighted boxes move from row to row, left to right)
* participant cannot correct their answers nor jump ahead.
* after two minutes the test ends.

the order of the symbols can be edited under section EDITABLE LISTS
Follow instructions.

In order to provide roughly the same size set-up on different monitors, a specific pixel resolution can be
set under DEFAULTS (for example: 1024px,768px). To change the pixelsize, go to DEFAULTS and change /canvassize.

!!!However, there is no absolute relationship between a pixel and any "real", 
physical measurement unit (mm, cm, inches, etc.). It's different on each monitor.
If the same size is REQUIRED, you can use script MonitorCalibration.iqx to calibrate your monitor.
Transfer the data stored for values.canvassize (in MonitorCalibration.iqx) into
/canvassize = under the DEFAULTS section in this script.

All instruction stimuli are presented under INSTRUCTIONS. Instructions are either 
pages, text stimuli, or instruction images. If instructions need to be changed on images,
new images need to be created (e.g. in PowerPoint) and saved under the current file names.

the default set-up of the script takes appr. 3.5 minutes

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:

/timelimit:							default duration (120000ms =>2min) for the timed portion of the test in ms

Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Privacy Statement | Security Statement | GDPR
Website Security Test