Return to the Little Man Test - ABCD Consortium page
___________________________________________________________________________________________________________________	

										ABCD Little Man Test (touchscreen/mouse input)
___________________________________________________________________________________________________________________

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

Script Copyright © 10-10-2019 Millisecond Software

This script has been made available to the Millisecond Software Library by the ABCD Research Consortium.
The script was designed to be run on ipads but can be adapted to run with mouse input.

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements a mental rotation task for children programmed for the for ABCD Research Consortium.

___________________________________________________________________________________________________________________
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: 'abcdlittlemantest_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
script.sessionid:				with the current session id

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 such as feedback trials. Thus, trialnum 
										may not reflect the number of main trials run per block. 
										
values.stim:					stores the currently presented image
values.correctAnswer:			stores the correct location of the suitcase: 1 = left; 2 = right
response:					the participant's response (response button pressed): leftButton vs. rightButton
correct:						accuracy of response: 1 = correct response; 0 = otherwise
latency: 						the response latency (in ms); measured from: onset of images


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

computer.platform:			the platform the script was run on (win/mac/ios/android)
script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				assigned subject id number
script.groupid:				assigned group id number
script.sessionid:				assigned session id number
script.elapsedtime:			time it took to run script (in ms); measured from onset to offset of script
script.completed:				0 = script was not completed (prematurely aborted); 
							1 = script was completed (all conditions run)
									
expressions.propCorrect:		proportion correct test responses
expressions.meanRT:			mean response time (in ms) of correct responses (measured from onset of stim)

* 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 
___________________________________________________________________________________________________________________	
- 4 practice problems with assistance from Test Administrator
	- 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) ->

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)