User Manual: Inquisit Manikin Test of Spatial Orientation and Transformation - Touch/Mouse


___________________________________________________________________________________________________________________	

									       MANIKIN TEST (test of spatial reasoning)
										   - touch input-
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 08-18-2014
last updated:  02-24-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-24-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script runs the Manikin Test to test Spatial Orientation & Spatial Transformation described by:

UNIFIED TRI-SERVICE COGNITIVE PERFORMANCE ASSESSMENT BATTERY (UTC-PAB) I. DESIGN AND SPECIFICATION OF THE BATTERY. 
ENGLUND, C.E., REEVES. D.L., SHINGLEDECKER, C.A., THORNE, D.R., WILSON, K.P., & HEGGE. F.W. (1987).
REPORT NO. 87-10, NAVAL HEALTH RESEARCH CENTER, P 0 BOX 85122, SAN DIEGO, CALIFORNIA 92138
NAVAL MEDICAL RESEARCH AND DEVELOPMENT COMMAND, BETHESDA, MARYLAND (p.29)

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants view Manikins superimposed on either a red square or green circle that hold a red square in one hand
and a green circle in the other.  Manikins can be right side up or upside down, can face towards
participant ('forward') or face away from participant ('backward').
Participants have to decide as fast as possible if the manikin holds the shape that is congruent with 
the background (e.g. the red square) in the left or right hand and press corresponding buttons on the screen. 

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

___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________	
The default data stored in the data files are:

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

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.
																			
verticalorientation:			"U(pright)" vs. "D(ownside)" (aka standing on the head)

horizontalorientation:			"F(orward)" vs. "B(ackward)"
								Forward facing => participant sees the front of the manikin
								Backward facing => participant sees the back of the manikin
										
stimshape:						"C(ircle)" vs. "S(quare)"
congruenthand:					"R(ight)" vs. "L(eft)"

stimulusitem:					the presented image

response:						the participant's response (LEFT vs. RIGHT)
										
correct:						the correctness of the response (1 = correct; 0 = otherwise)
latency: 						the response latency (measured from onset of stimuli to pressing response button; in ms)


(2) Summary data file: 'manikintest_mi_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)
									
propcorrect:					proportion correct (testblocks only)

count_total:					counts the total number of trials
MeanRT_total: 					mean latency of all trials (in ms)
STD_total:						standard deviation of latencies of all trials
medianRT_total:					calculates the median of the sorted items (in ms)
MaxRT_total:					stores the minimum latency (in ms)
MinRT_total:					stores the maximum latency (in ms)
Range_total:					stores the range of latencies

(for total, correct, incorrect, righthand responses, lefthand responses)

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
Practice Block: by default runs 1 block of 16 trials (all possible combinations once)
with performance (accuracy) feedback for 1s
Test Block: by default runs 4 blocks of 16 trials (no performance feedback)

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
manikins provided by Millisecond Software (can be easily be exchanged for others under Editable Stimuli;
Note: the file names should be kept as they are used to extract condition information about the stimulus)

16 manikins: 
2 vertical rotation (up vs. down) 
x 2 lateral rotation (forward vs. backwards) 
x 2 shape (circle vs. square) 
x 2 congruent hand (left vs right)

Manikins show facial features, buttons, slit pockets, belt buckle when forward (aka facing towards the participant)
Manikins show hair on the head, back pockets, no buttons and no belt buckle when backwards 
(when facing away from participant)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
Instructions are provided by Millisecond Software in the form of html pages.
They are based on the ones published by Englund et al (1987).

To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac)
or Notepad (Windows).

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

Response Key:

/number_practiceblocks:			number of practice blocks to run (default: 1)
/number_testblocks:				number of testblocks to run (default: 4)

/getReadyDuration:				the duration (in ms) of the get-ready trial (default: 3000) + 500ms posttrialpause
/practicefeedbackduration:		the duration (in ms) of the feedbackstimulus (default: 1000ms)