Return to the Little Man Test - ABCD Consortium page
___________________________________________________________________________________________________________________	

										*ABCD Little Man Test*
										(Smart Phone Version)
___________________________________________________________________________________________________________________							
										
SCRIPT INFO

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

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

This script implements a mental rotation task for children.
Originally the task was programmed for ipads for inperson testing.
This current version was updated/optimized for ABCD for running on smart phones to use
for remote testing.

It can be run on its own or in conjunction with script 'remotetesting_instructions.iqx'.
'remotetesting_instructions.iqx': script that tests that the screen sizing roughly fits a smart phone.
The combined sequence is run by script 'batch.iqx'

___________________________________________________________________________________________________________________
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 FILE INFORMATION 
___________________________________________________________________________________________________________________
The default data stored in the data files are:

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

parameters. scriptlastupdate:	should store the date of the last change made to the script

build:							Inquisit build

computer.platform:				the platform the script was run on (win/mac/ios/android)

more information about the operating system of the current device:
computer.os 
computer.osmajorversion 
computer.osminorversion

information about the current screen size:
expressions.screenWidth_inmm 
expressions.screenHeight_inmm

parameters.test_setting:		"remote"

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) 

/lmt_stimulus_xx:				stores the currently presented image file
/lmt_stimulus_type_xx:			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
/lmt_correctButton_xx:			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)
/lmt_button_pressed_xx:			stores the response button pressed: 0 = "left"; 1 = "right"; or "timedout" (custom response variable)
/lmt_correct_xx:				accuracy of response: 1 = correct response; 0 = otherwise (wrong selection or timeout)
/lmt_RT_xx: 					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: 'littlemantest_summary*.iqdat' (a separate file for each participant)*

parameters. scriptlastupdate:		should store the date of the last change made to the script

computer.platform:					the platform the script was run on (win/mac/ios/android)

more information about the operating system of the current device:
computer.os 
computer.osmajorversion 
computer.osminorversion

information about the current screen size:
expressions.screenWidth_inmm 
expressions.screenHeight_inmm

parameters.test_setting:		"remote"

script.startdate:				date script was run (local date for participant)
script.starttime:				time script was started (local time for participant)
script.subjectid:				subject id number
script.groupid:					group id number
script.sessionid:				session id number
script.elapsedtime:				time it took to run script (in ms)
script.completed:				0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run)

lmt_scr_assess_date:			currently simply stores the script.startdate (the local time is stored under script.starttime)
lmt_src_prop_correct:			proportion of correct responses

lmt_scr_num_correct:			absolute number of correct responses
lmt_scr_num_wrong:				absolute number of (active) error responses
lmt_scr_num_timed_out:			absolute number of timeout (passive) errors.

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

/lmt_stimtype1_correct_rt-
/lmt_stimtype8_correct_rt:		latency of correct selections by stimulus type (1-8)

/lmt_stimtype1_num_correct-
/lmt_stimtype8_num_correct:		number of correct selections by stimulus type (1-8)

/lmt_stimtype1_wrong_rt-
/lmt_stimtype8_wrong_rt:		latency of error selections by stimulus type (1-8)

/lmt_stimtype1_num_wrong-
/lmt_stimtype8_num_wrong:		number of error selections by stimulus type (1-8)

/lmt_stimtype1_num_timed_out-
/lmt_stimtype8_num_timed_out:	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 
___________________________________________________________________________________________________________________	

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