User Manual: Inquisit Digit Symbol Substitution Task - Keyboard Input - Form 11


___________________________________________________________________________________________________________________	

									DIGIT SYMBOL SUBSTITUTION TASK - (Version 11) 
									- keyboard input
									- scrolling version
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
last updated:  06-23-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 06-23-2022 Millisecond Software

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

Researchers can select to run the task with an absolute screen size to ensure that distances
stay the same across devices. The default settings are optimized for ipad touchscreens sizes.
See section Editable Parameters 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 FILE INFORMATION 
___________________________________________________________________________________________________________________
The default data stored in the data files are:

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


//Play Setup:
(parameter) runAbsoluteSizes:	true (1) = should run absolutely sized canvas (see parameters- canvasHeight_inmm)
								false (0) = should use proportionally sized canvas (uses width = 43*screenHeight)
								
canvasAdjustments:				NA: not applicable => parameters- runAbsoluteSize was set to 'false'
								0: parameters- runAbsoluteSize was set to 'true' and screen size was large enough
								1: parameters- runAbsoluteSize was set to 'true' BUT screen size was too small and 
								adjustments had to be made

display.canvasheight:			the height of the active canvas ('playarea') in pixels
display.canvaswidth:			the width of the active canvas ('playarea') in pixels

px_per_mm:						the conversion factor to convert pixel data into mm-results for the current monitor
								(Note: the higher resolution of the current monitor 
								the more pixels cover the same absolute screen distance)
								This factor is needed if you want to convert pixel data into absolute mm data or the other way around

playareaHeight_inmm:			the width of the play area in mm 
playareaWidth_inmm:				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_test11_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)
									
//Play Setup:
(parameter) runAbsoluteSizes:	true (1) = should run absolutely sized canvas (see parameters- canvasHeight_inmm)
								false (0) = should use proportionally sized canvas (uses width = 43*screenHeight)
								
canvasAdjustments:				NA: not applicable => parameters- runAbsoluteSize was set to 'false'
								0: parameters- runAbsoluteSize was set to 'true' and screen size was large enough
								1: parameters- runAbsoluteSize was set to 'true' BUT screen size was too small and 
								adjustments had to be made

display.canvasheight:			the height of the active canvas ('playarea') in pixels
display.canvaswidth:			the width of the active canvas ('playarea') in pixels

px_per_mm:						the conversion factor to convert pixel data into mm-results for the current monitor
								(Note: the higher resolution of the current monitor 
								the more pixels cover the same absolute screen distance)
								This factor is needed if you want to convert pixel data into absolute mm data or the other way around

playareaHeight_inmm:			the width of the play area in mm 
playareaWidth_inmm:				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
* the complete grid appears and the timed portion of the test starts

(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: