User Manual: Inquisit Snaith Hamilton Pleasure Scale (SHAPS)


___________________________________________________________________________________________________________________	

								*The Snaith Hamilton Pleasure Scale (SHAPS)*
___________________________________________________________________________________________________________________

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

Script Copyright © 10-10-2023 Millisecond Software
___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements a computerized version of the Snaith Hamilton Pleasure Scale (SHAPS) as described in:

Snaith RP, Hamilton M, Morley S, Humayan A, Hargreaves D, Trigwell P. (1995). A scale  
for the assessment of hedonic tone the Snaith-Hamilton Pleasure Scale. Br J Psychiatry.Jul;167(1):99-103 

___________________________________________________________________________________________________________________
OVERVIEW
___________________________________________________________________________________________________________________	
14 4-point Likert scale items (when scored the scale gets simplified into binary categories); self-report

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

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

(1) Raw data file: 'shaps.iqdat'

date, time:						date and time script was run with the current group/subjectnumber 
subject, group, session:	  	with the current subject/groupnumber/session id
build:							the Inquisit build 

q*_response:					response given (in assigned values)
								4 = strongly disagree, 3 = disagree, 2 = agree, 1 = strongly agree
								'D' => questions with a slightly different scale
								1 = "Definitely Agree", 2 = "Agree", 3 = "Disagree", 4 = "Strongly Disagree"
								
q*_latency:						how much time (in ms) the participant spent on the surveyPage with this particular question (the last time this particular surveyPage was visited)


(2) Summary data file: 'shaps_summary.iqdat' (Inquisit Lab: one data file per 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)

shapsTotalScore:				the total score based on all simplified question scores (Range: 0-14)
								strongly disagree/disagree => 1 point
								strongly agree/agree => 0 point
								(the lower the score the more pleasure experienced)
									
q1:								the simplified score for question 1
								strongly disagree/disagree => 1 point
								strongly agree/agree => 0 point
									
radioButtons.q1.response:		question 1 raw response: 
								4 = strongly disagree, 
								3 = disagree, 
								2 = agree, 
								1 = strongly agree
(same for the remaining questions)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
see section Editable Parameters

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

/pageInstructions:			the instructions that appear at the top of each surveyPage