Version 1: keyboard version
Main Script to run: digitsymbolsubstitution_test1_spanish.iqjs
___________________________________________________________________________________________________________________
DIGIT SYMBOL SUBSTITUTION TASK (Spanish Instructions)
- keyboard input
- scrolling version
___________________________________________________________________________________________________________________
Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
last updated: 11-05-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC
Script Copyright © 11-05-2024 Millisecond Software
Millisecond Software thanks Miguel Carmona (certified translator) for providing the Spanish translations!
___________________________________________________________________________________________________________________
BACKGROUND INFO
___________________________________________________________________________________________________________________
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.
This script version asks participants to convert symbols into digits using keyboard keys.
Note the script runs with proportional sizing by default.
Researchers can select to run the task with an absolute screen size to ensure that distances
stay the same across devices. See section Defaults for more info.
___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________
Participant are presented with a 2 (row) x 9 (columns) matrix.
The first row contains a sequence of digits; the second row contains boxes to be filled with
digit-matching symbols.
The task is to translate symbols into digits with the help of a provided key within a 2 min time frame
using keys on the keyboard.
The first 4 boxes of the second row contain previously entered digits (from the previous 4 trials);
the fifth box is highlighted in purple and awaits the current digit selection.
The remaining 4 boxes of the second row are empty (the matching symbols for the next 4 trials can be seen).
Once a participant selects the current digit, the digits/symbol move to the left
and a new symbol box is added to the right.
The result: The highlighted response box always stays in the center of the matrix and
the next symbol conveniently 'scrolls' in.
___________________________________________________________________________________________________________________
DURATION
___________________________________________________________________________________________________________________
the default set-up of the script takes appr. 3.5 minutes to complete
___________________________________________________________________________________________________________________
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:
(1) Raw data file: 'digitsymbolsubstitutiontask_testx_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
playAreaHeightMM: the width of the play area in mm
playAreaWidthMM: the height of the play area in mm
blockCode, blockNum: the name and number of the current block (built-in Inquisit variable)
trialCode, trialNum: the name and number of the currently recorded trial (built-in Inquisit variable)
Note: trialNum is a built-in Inquisit variable; it counts all trials run; even those
that do not store data to the data file.
version: the version of the Inquisit Digit Symbol Substitution Task run
box: stores the itemnumber of the currently LAST symbol
correctAnswer: the correct symbol itemnumber for the current ACTIVE symbol (correct digit)
response: scancode of pressed response key
responseText: the actual value of the pressed response key (=selected digit)
correct: 1 if given response is correct, 0 if given response is incorrect
latency: time in milliseconds for the current response
correctCount: total count of correct responses
errorCount: total count of erroroneous responses
(2) Summary data file: 'digitsymbolsubstitutiontask_testx_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)
playAreaHeightMM: the width of the play area in mm
playAreaWidthMM: the height of the play area in mm
version: the version of the Inquisit Digit Symbol Substitution Task run
totalSeconds: maximum time in seconds allowed for the task
correctCount: total count of correct responses
errorCount: total count of erroroneous responses
secondsperCorrect: average number of seconds per correct response
___________________________________________________________________________________________________________________
EXPERIMENTAL SET-UP
___________________________________________________________________________________________________________________
(A) PRACTICE:
* 9 boxes with symbols on tops and digits (or space for digits) on the bottom
* the first 4 present symbols and digits, the last 5 digits need to be filled in by participant
* the center box (box5) 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
(B) TIMED TEST:
* 9 boxes with symbols on tops and digits (or space for digits) on the bottom
* the first 4 present symbols and digits, the last 5 digits need to be filled in by participant
* the empty response box (box 5) for the next digit is highlighted in purple
* there is no more performance feedback
* participant cannot correct their answers nor jump ahead.
* after two minutes the test ends.
(C) DIGIT SEQUENCE:
the order of the symbols can be edited under section EDITABLE LISTS
Follow instructions.
___________________________________________________________________________________________________________________
INSTRUCTIONS
___________________________________________________________________________________________________________________
All instruction stimuli are presented under 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:
//color parameter
/ canvasColor = black //Display color of the actively used portion of the screen (the 'canvas')
//Note: if set to a color other than the screenColor, you can distinguish the active canvas
//from the inactive portion of the screen
/ screenColor = black //Color of the screen not used by the canvas ('inactive screen')
/ defaultTextColor = white //Default color of text items
//timing parameters
/ timeLimit = 120000 //default duration (120000ms =>2min) for the timed portion of the test in ms
//clock:
/ showTimer = false //true = a timer appears in the top right during the test
//false = no timer is presented
