User Manual: Inquisit Little Man Test - ABCD Consortium - Tablet


___________________________________________________________________________________________________________________	

										*ABCD Little Man Test*
										(Tablet Version)
___________________________________________________________________________________________________________________							
										
SCRIPT INFO

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 08-24-2017
last updated:  08-09-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 08-09-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script was programmed for and made available by the ABCD Research Consortium.

This script implements a mental rotation task for children.
The current version is optimized for tablet use/tablet size (e.g. ipads) used for
iperson testing. A smartphone version optimized for remote testing is also available in the
Millisecond Software library.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants are presented figures that carry a suitcase in either the left or right hand.
Figures can show their front or back and can be right side up or up side down.											  
Participants work through 4 practice problems with the test administrator before
working on 32 problems on their own.

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

___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
DATA FILE INFORMATION: 
The fields in the data files are:

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

build:							Inquisit build
computer.platform:				the platform the script was run on (win/mac/ios/android)
date, time, subject, group, session:	date and time script was run with the current subject/groupnumber/session number 
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; by default data is collected unless /recorddata = false is set for a particular trial/block) 

lmtStimulusXx:				stores the currently presented image file
lmtStimulusTypeXx:			1 Backward Down Left
								2 Backward Down Right
								3 Backward Up Left
								4 Backward Up Right
								5 Forward Down Left
								6 Forward Down Right
								7 Forward Up Left
								8 Forward Up Right
lmtCorrectButtonXx:			stores the correct location of the suitcase: 0 = left; 1 = right
response:						stores the response button pressed: "leftbutton" vs. "rightbutton" vs. 0 => no response (Inquisit default response variable)
lmtButtonPressedXx:			stores the response button pressed: 0 = "left"; 1 = "right"; or "timedout" (custom response variable)
lmtCorrectXx:					accuracy of response: 1 = correct response; 0 = otherwise (wrong selection or timeout)
lmtRTXx: 						the response latency (in ms); measured from: onset of images until response or timeout
									Note: timeout latencies are stored as -1
									
homeButtonRT:					the time (in ms) that it took to press the green home Button during trial.ITI								


(2) Summary data file: 'abcdlittlemantest_tablet_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)

lmtScrAssessDate:			currently simply stores the script.startDate (the local time is stored under script.startTime)
lmtSrcPropCorrect:			proportion of correct responses

lmtScrNumCorrect:			absolute number of correct responses
lmtScrNumWrong:				absolute number of (active) error responses
lmtScrNumTimedOut:			absolute number of timeout (passive) errors.

lmtScrAvgRT:					average response time of correct and incorrect selections
									Note: timeouts latencies are excluded from this variable
									
lmtScrRtCorrect:				average only correct RT; calculation (Mean latency for correct =1)
lmtScrRtWrong:				average only wrong RT (= latencies of incorrect selections); 
									Note (KB): timeout errors are excluded
									
lmtScrEfficiency:				Accuracy/ Reaction Time; calculation (lmt_src_prop_correct/lmt_scr_rt_correct)

lmtStimType1CorrectRt-
lmtStimType8CorrectRt:		latency of correct selections by stimulus type (1-8)

lmtStimType1NumCorrect-
lmtStimType8NumCorrect:		number of correct selections by stimulus type (1-8)

lmtStimType1WrongRt-
lmtStimType8WrongRt:			latency of error selections by stimulus type (1-8)

lmtStimType1NumWrong-
lmtStimType8NumWrong:		number of error selections by stimulus type (1-8)

lmtStimType1NumTimedOut-
lmtStimType8NumTimedOut:	number of timed-out selection trials by stimulus type (1-8)

* separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section
"DATA" and follow further instructions

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
- 1 demo problem (if incorrect, it can be repeated as often as necessary); no response deadline
- 3 additional practice problems
	- demo and practice problems are presented in a fixed order
- 32 test problems (presented in fixed order)

Trial Sequence:
homebutton needs to be pressed (changes color from white to gray) -> ITI: 1500ms -> stim (until response or timeout at 5s) ->

Note: practice trials
The error feedback is presented for at least 1000ms regardless of whether the home button is pressed beforehand or not.
ITI is started only if the home button was pressed.

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by ABCD Consortium, see section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
provided by ABCD Consortium, see 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:

/picSize:					the proportional size of the little man images (default: 60%)
/responseButtonSize:		the proportional size of the response buttons (default: 8%)

/iti:						the duration (in ms) of the intertrial interval (default: 1500ms)
/readyDuration:				the duration (in ms) of the ready trial (default: 3000ms)
/responseDeadline:			a response deadline in ms (default: 5000ms)

/scriptLastUpdate:			should store the date of the last change made to the script