User Manual: Inquisit Self Assessment Manikin (SAM)


___________________________________________________________________________________________________________________	

							*Demonstration for Self Assessment Manikin Pictorial Rating Scale*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 11-05-2017
last updated:  10-09-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 10-09-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements a simple picture rating script that uses the Self Assessment Manikin Pictorial Rating Scale
described in:

Bradley, M. & Lang, P.J. (1994). Measuring Emotion: The Self-Assessment Manikin and The Semantic
Differential. J. Behav. Ther. Exp. Psychiat, 25, 49-59.

___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________	
Participants are shown 8 pictures (one at a time) and are asked to rate the emotions these pictures elicit
on three dimensions: valence, arousal, dominance.
The rating scales consist of a series of pictorial depictions of a manikin displaying those emotions.
This script runs a 9-point scale: 5 picture anchors with spaces in between 

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

___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________	
The fields in the data files are:

(1) Raw data file: 'selfassessmentmanikin_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.	
										
trialCount:						tracks the number of trials run
targetIndex:					tracks the itemnumber of the current image presented
target:							stores the current image file presented

valenceSelected:				1 (very unpleasant) - 9 (very pleasant)
arousalSelected:				1 (frantic) - 9 (chill) 
dominanceSelected:				1 (not in control at all) - 9 (100% in control) 

rt:								the time (in ms) from onset of image to pressing 'submit' button 

////built-in DVs:
latency:						records the response latency in the current data saving trial
response:						records the response latency in the current data saving trial

(2) Summary data file: 'selfassessmentmanikin_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)


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

This script implements a simple demonstration to use the Self Assessment Manikin Scales for picture ratings.

* 8 trials (the order of the images is determined randomly)
	Note: this script automatically adapts to run more/fewer trials if the number of images is changed
	under item.images.
	
* participants need to select one of the response boxes for each of the three dimensions (valence, arousal, dominance)
There are 5 picture anchors and 4 empty boxes in between (=9 anchor points)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
provided by Millisecond Software - can be edited under section Editable Stimuli

Note: the script runs as many self-assessment trials as there are images provided under item.images.
By default, the script runs 8 trials.

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

/picSize:							the size of the target picture relative to canvas height (default: 20%)
/picPosition:						the vertical position of the target picture relative to canvas height (default: 5%)
										Note: 0% = top of canvas - 100% = bottom of canvas

/ratingScalePosition:				the vertical position of the top of the rating scales relative to canvas height (default: 30%)

/ratingScaleScalingFactor:			a helper factor to scale the rating scale (default: 0.8)
										Note: if a larger pic Size is chosen, the rating scale might need to be scaled down 
										to fit on the canvas

/iti:									the intertrial interval (in ms) (default: 100ms)