User Manual: Inquisit Medical Outcomes Study (MOS) Sleep Scale


___________________________________________________________________________________________________________________	

						MEDICAL OUTCOME STUDY (MOS) SLEEP SCALE 1.0
___________________________________________________________________________________________________________________

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

Script Copyright © 02-25-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the MOS sleep scale 1.0 as provided by:
http://www.rand.org/health/surveys_tools/mos/mos_sleep.html

and discussed in:
Hays, Ron D., Martin, Susan A., Sesti, Anne M., & Spritzer, Karen L. (2005). Psychometric properties of the 
Medical Outcomes Study sleep measure. Sleep Medicine, 6(1), 41-44.

Scoring Algorithm can be obtained under:
http://gim.med.ucla.edu/FacultyPages/Hays/surveys.htm

and is described in:
Spritzer, K. L. & Hays, R. D. (2003, November). MOS Sleep Scale: A Manual for Use and Scoring, 
Version 1.0. Los Angeles, CA.

___________________________________________________________________________________________________________________
OVERVIEW
___________________________________________________________________________________________________________________	
The survey presents 12 sleep questions (by default, the questions are coded in such a way that participants 
do not have to answer them) that make up 7 subscales (+ 2 extra).

___________________________________________________________________________________________________________________	
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: 'mos_sleepscale.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)
								Scale: all of the time - none of the time; no automatically attached values attached to response anchors
								=> see summary data for numeric values
									
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: 'mos_sleepscale_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)
							
						
slpd4_sleepdisturbance -
slp9_sleepproblems:				subscale scores	

SLPQRAW_sleepquantity:			Sleep Quantity Score (q2)

q1 -
q12_SP:							scoring of the individual questions
								(according to the scoring manual: "Note that items 4 and 12 are scored differently 
								depending upon which scale they are used in. When used in the sleep adequacy scale, 
								a higher score reflects less of a problem. When used in the sleep problems index, a 
								higher score reflects more of a problem." (Spritzer & Hays, 2003, p.2)
										
count_slpd4 -
count_slp9:						count the number of answered items of a subscale


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

/instructions:						Contain the surveypage instructions. The default instructions ("Please answer the following questions")
								are not original to the survey and were addede by Millisecond Software.
								
/skipfeedback:					true = no feedback is given (default)
								false = feedback is given (-> page.feedback)