User Manual for Inquisit's Santa Barbara Solids Test


___________________________________________________________________________________________________________________	

							SANTA BARBARA SOLIDS TEST (SBST)
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-23-2015
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 a computerized version of the Santa Barbara Solids Test (SBST);
a test of spatial reasoning.

The implemented procedure is based on:

Cohen, C. A. & Hegarty, M. (2012). Inferring cross sections of 3D objects: A new spatial thinking test. 
Learning and Individual Differences, 22(6), 868-874.
			
additional material published at:
http://spatiallearning.org/index.php/testsainstruments

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants see 29* 3-D figures cut in three cutting planes (horizonal, vertical, or oblique).
14 of the figures are cut in the oblique plane (one was dropped); 15 are cut in the vertical/horizontal plane.
10 problems represent cuts of simple figures, 10 problems represent cuts of joint figures, 9 problems represent
cuts of embedded figures.
The task is to select the correct cross section (viewed head-on) from amongst 4 possible choices. 

*the test originally contained 30 figures but figure 3 was dropped from the test based on
Dr. Cohen's recommendations.

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

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

(1) Raw data file: 'santabarbarasolidstest_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. 
										
problemcount:					tracks the number of problems presented

cuttingplane:					1 = vertical cut; 2 = horizontal cut; 3 = oblique cut
structure:						1 = simple; 2 = joint; 3 = embedded

stimulusitem.1:					the image of the current problem

stimulusitem.2-
Stimulusitem.5:					the images for response options A-D

egocentricaloption:				stores the current egocentrical answer choice 
correctoption:					stores the currently correct answer choice

response:						the participant's response (selection of answer choice)
respCat:						"correct" vs. "egocentrial error" vs. "other error"
correct:						the correctness of the response (1 = correct; 0 = incorrect)
latency: 						the response latency (in ms); measured from onset of problem

countcorrect:					counts all correct responses
count_egocentric: 				counts egocentrial selections

count_h:						counts all horizontal cut (h) figures 
count_v:						counts all vertical cut (v) figures 
count_o:						counts all oblique cut (o) figures 
countcorrect_h:					counts all correct horizontal cut (h) figures 
countcorrect_v:					counts all correct vertical cut (v) figures 
countcorrect_o:					counts all correct oblique cut (o) figures 

count_s:						counts all simple (s) figures 
count_j:						counts all joint (j) figures 
count_e:						counts all embedded (e) figures 
countcorrect_s:					counts all correct simple (s) figures 
countcorrect_j:					counts all correct joint (j) figures 
countcorrect_e:					counts all correct embedded (e) figures


(2) Summary data file: 'santabarbarasolidstest_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)
																		
problemcount:					tracks the number of problems presented
propcorrect:					proportion correct overall (across all test problems)
meanRT:							mean response time (in ms) of selecting a correct option (across all test problems)
propEgocentrical: 				proportion egocentrial selections

propcorrect_h:					proportion correct horizontal cut plane problems
propcorrect_v:					proportion correct vertical cut plane problems
propcorrect_hv:					proportion correct vertical+horizonal cut plane problems
propcorrect_o:					proportion correct oblique cut plance problems

propcorrect_s:					proportion correct responses to Simple problems
propcorrect_j:					proportion correct responses to Joint problems
propcorrect_e:					proportion correct responses to Embedded problems

meanRT_h:						mean correct response time (in ms) to horizontal cut plane problems
meanRT_v:						mean correct response time (in ms) to vertical cut plane problems
meanRT_hv:						mean correct response time (in ms) to vertical+horizonal cut plane problems
meanRT_o:						mean correct response time (in ms) to oblique cut plance problems

meanRT_s:						mean correct response time (in ms) to responses to Simple problems
meanRT_j:						mean correct response time (in ms) to responses to Joint problems
meanRT_e:						mean correct response time (in ms) to responses to Embedded problems

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________

(1) Block.sample: presents one sample problem with feedback
(2) Block.sbst: presents the 29 problems in order (no feedback is provided)
	* 29 figures total (one figure dropped based on recommendations:)
		* 14 of the figures are cut in the oblique plane (one was dropped); 
		15 are cut in the vertical/horizontal plane.
		* 10 problems represent cuts of simple figures, 10 problems represent cuts of joint figures, 
		9 problems represent cuts of embedded figures

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
This script uses the stimuli published at:
http://spatiallearning.org/resource-info/Spatial_Ability_Tests/Santa_Barbara_Solids_Test_rev_1210.pdf
The problems and answer choices were created as separate *.jpg files in Paint.net by
Millisecond Software.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
uses the instructions published at:
http://spatiallearning.org/resource-info/Spatial_Ability_Tests/Santa_Barbara_Solids_Test_rev_1210.pdf

The instructions are presented as htm-files that can be directly edited in any simple Text Editor such as
TextEdit (Mac) or Notepad (Win)

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

/highlightduration:		stores the duration (in ms) of the blue ring around the selected answer choice