Return to the Mental Rotation Task page
						
										Mental Rotation 
SCRIPT INFO

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 07-10-2018
last updated: 07-12-2018 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC

Script Copyright © 07-12-2018 Millisecond Software


BACKGROUND INFO 

											*Purpose*
This script implements a Mental Rotation Script based on:

Ganis, G and Kievit, R (2015). A New Set of Three-Dimensional Shapes for Investigating Mental Rotation Processes: 
Validation Data and Stimulus Set. Journal of Open Psychology Data, 3: e3, DOI: http://dx.doi.org/10.5334/jopd.ai


											  *Task*
Participants see images of 2 3-D cube objects and have to decide whether the cube objects are the same or mirror
images of each other. The cube objects are rotated by 0deg, 50deg, 100deg, and 150deg.
By default, in this script participants work on 12 different cube objects 
(96 trials total = 12 cube objects * 4 rotation angles * 2 sameness categories (same vs. mirror images))

Duration: about 6-7 minutes (depends on response times; by default participants have max. 7.5s to respond during 
the test)


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

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

build:							Inquisit build
computer.platform:				the platform the script was run on
date, time, subject, group:		date and time script was run with the current subject/groupnumber 
values.subsets:					the selected subsets for the test (out of 48 possible)
values.subsets_practice:		the selected subsets for practice 
 
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) 
values.trialcount:				counts the number of trials run (resets after practice)
stimulusitem:					the presented stimuli in order of trial presentation
values.subset:					the subset the current image belongs to
values.sameness:				"same" vs. "different"
values.rotationAngle:			0, 50, 100, 150
response:						the participant's response, scancode of response button
								31 = S => same
								32 = D => different
values.resp:					"same", "different", "no respose"
correct:						accuracy of response: 1 = correct response; 0 = otherwise
latency: 						the response latency (in ms); measured from: onset of images until response is made or trial times out 


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

script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				subject id number
script.groupid:					group id number
script.elapsedtime:				time it took to run script (in ms)
computer.platform:				the platform the script was run on
/completed:						0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run)

values.subsets:					the selected subsets for the test (out of 48 possible)
values.subsets_practice:		the selected subsets for practice 
expressions.ACC_practice:		proportion correct performance across all practice trials
expressions.ACC:				proportion correct across all test trials 
expressions.RT:					mean response time (in ms) of correct responses across all test trials 

expressions.ACC_same:			proportion correct of 'same' test trials (across all rotation angles)
expressions.RT_same:			mean response time (in ms) of correct responses to 'same' test trials (across all rotation angles)
expressions.ACC_different:		proportion correct of 'different' test trials (across all rotation angles)
expressions.RT_different:		mean response time (in ms) of correct responses to 'different' test trials (across all rotation angles)

expressions.ACC_0:				proportion correct of responses to images with rotation angle = 0 degrees (across same/different trials)
expressions.RT_0:				mean response time (in ms) of correct responses to images with rotation angle = 0 degrees (across same/different trials)
expressions.ACC_50:				proportion correct of responses to images with rotation angle = 50 degrees (across same/different trials)
expressions.RT_50:				mean response time (in ms) of correct responses to images with rotation angle = 50 degrees (across same/different trials)
expressions.ACC_100:			proportion correct of responses to images with rotation angle = 100 degrees (across same/different trials)
expressions.RT_100:				mean response time (in ms) of correct responses to images with rotation angle = 100 degrees (across same/different trials)
expressions.ACC_150:			proportion correct of responses to images with rotation angle = 150 degrees (across same/different trials)
expressions.RT_150:				mean response time (in ms) of correct responses to images with rotation angle = 150 degrees (across same/different trials)

expressions.ACC_0_same:			proportion correct of responses to images with rotation angle = 0 degrees for 'same' images
expressions.RT_0_same:			mean response time (in ms) of correct responses to images with rotation angle = 0 degrees for 'same' images
expressions.ACC_50_same:		proportion correct of responses to images with rotation angle = 50 degrees for 'same' images
expressions.RT_50_same:			mean response time (in ms) of correct responses to images with rotation angle = 50 degrees for 'same' images
expressions.ACC_100_same:		proportion correct of responses to images with rotation angle = 100 degrees for 'same' images
expressions.RT_100_same:		mean response time (in ms) of correct responses to images with rotation angle = 100 degrees for 'same' images
expressions.ACC_150_same:		proportion correct of responses to images with rotation angle = 150 degrees for 'same' images
expressions.RT_150_same:		mean response time (in ms) of correct responses to images with rotation angle = 150 degrees for 'same' images

expressions.ACC_0_different:	proportion correct of responses to images with rotation angle = 0 degrees for 'different' images
expressions.RT_0_different:		mean response time (in ms) of correct responses to images with rotation angle = 0 degrees for 'different' images
expressions.ACC_50_different:	proportion correct of responses to images with rotation angle = 50 degrees for 'different' images
expressions.RT_50_different:	mean response time (in ms) of correct responses to images with rotation angle = 50 degrees for 'different' images
expressions.ACC_100_different:	proportion correct of responses to images with rotation angle = 100 degrees for 'different' images
expressions.RT_100_different:	mean response time (in ms) of correct responses to images with rotation angle = 100 degrees for 'different' images
expressions.ACC_150_different:	proportion correct of responses to images with rotation angle = 150 degrees for 'different' images
expressions.RT_150_different:	mean response time (in ms) of correct responses to images with rotation angle = 150 degrees for 'different' images

* 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) subsetGeneration ('silent block'):
the script randomly selects the number of image subsets (out of 48 possible) as specified by 
parameters.subsetSize. By default, the script randomly selects the subsets for the test.
If specific subsets should be used, go to section EDITABLE LISTS and follow instructions.
Once the test subsets have been selected, the script randomly selects 2 more subsets as practice subsets
(Note: this is only possible if not all subsets have been used for the test)

(2) Practice: 16 trials = 2 subsets x 8 images per subset
- images are presented randomly to the participants
- feedback is provided after each trial

(3) Test: number of subsets x 8 images per subset => default: 12 x 8 = 96 trials
- half the images are 'same', half the images are 'different' 
- the images are presented randomly with the constraint that no more than 3 same/different are
run consecutively
- no feedback provided
- after every 48 trials (editable, see parameters.restTrial under section EDITABLE PARAMETERS)
participants get a break

Trial Sequence:
ITI (250ms, editable)-> images for max 7500ms (editable) -> ITI


STIMULI
provided by: Ganis, G and Kievit, R (2015) (see article for stimuli generation)
The images are white on a black background.
Sizing can be edited under section EDITABLE PARAMETERS

INSTRUCTIONS
provided by Millisecond Software - can be edited 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:

/subsetSize:							the number of subsets used for the test (default: 12; Max: 48).
										By default, the script randomly selects the subsets for the test.
										If specific subsets should be used, go to section LISTS and follow
										instructions.
										
										Note: the script uses 2 different subsets for practice as long
										as not all 48 subsets are needed for the test.
										
/restTrial:								by default, every 48 trials the script provides a rest trial 
										
/picSize:								proportional size of images (relative to canvas height) (default: 40%)

/iti:									the intertrial interval in ms (blank screen) before each new image (default: 250ms)
/responseTimeout:						the response Timeout in ms (default: 7500ms)
										By default, the trial terminates after 7500ms

/responsekey_same:						the scancode of the 'same' response key  (default: 31)
/responsekey_same_label:				the label associated with the same response key (default: "S")
/responsekey_different:					the scancode of the 'different' response key  (default: 32)
/responsekey_different_label:			the label associated with the different response key (default: "D")

Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Privacy Statement | Security Statement | GDPR
Website Security Test