User Manual: Inquisit Insomnia Severity Index


___________________________________________________________________________________________________________________	

								INSOMNIA SEVERITY INDEX (ISI)
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 10-10-2013
last updated:  02-23-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-23-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements the Insomnia Severity Index (ISI) to assess Insomnia as described in:

Bastien, C.H., Vallières A., & Morin, C.M. (2001). Validation of the Insomnia Severity Index as a clinical outcome 
measure for insomnia research. Sleep Medicine, 2, 297-307.

___________________________________________________________________________________________________________________
OVERVIEW
___________________________________________________________________________________________________________________	
This script offers the 7 questions of the Insomnia Severity Index on a single surveypage.
A demographic surveypage at the beginning (by default: not run) as well as a feedback page at the end (by default: run)
are optional and controlled via Editable Parameters.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 1 minute to complete

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

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

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)
									Scale: 0 - 4 (anchors depend on question)
									no automatically reversed scored questions
									
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: 'insomniaseverityindex_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)
 
textbox.name.response/textbox.age.response/dropdown.gender.response:		Name/Age/Gender-if collected
isi_totalscore:					the participant's total ISI score


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

/skipdemographics:							false = script does collect demographic data 
											true = script does NOT collect demographic data (default)
											
/skipfeedback:								false = script does provide feedback to participants (default)
											true = script does NOT provide feedback to participants
											Note: to customize feedback go to EDITABLE CODE -> Editable Stimuli