Return to the Self Assessment Manikin (SAM) page
___________________________________________________________________________________________________________________	

							*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:  12-20-2019 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 12-20-2019 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.

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

___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________	
The default data stored 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
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.trialCount:				tracks the number of trials run
values.targetIndex:				tracks the itemnumber of the current image presented
values.target:					stores the current image file presented

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

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


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


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

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