User Manual: Inquisit Sleep Wake Activity Inventory


___________________________________________________________________________________________________________________	

								*SLEEP-WAKE ACTIVITY INVENTORY (SWAI)*
___________________________________________________________________________________________________________________	

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

Script Copyright © 10-12-2023 Millisecond Software

Millisecond Software thanks Meghan Lee for collaborating on this script!

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements the Sleep-Wake Activity Inventory (SWAI) as described in:

Rosenthal L., Roehrs TA, Roth T. (1993). The Sleep-Wake Activity Inventory: a self-report measure of daytime sleepiness.
Biol Psychiatry, 34, 810-20.

___________________________________________________________________________________________________________________
OVERVIEW
___________________________________________________________________________________________________________________
Participants answer 59 9-point Likert Scale questions. 
31 of these questions belong to 6 subscales (the remaining 28 questions are not considered for scoring):
Excessive Daytime Sleepiness (EDS): 9 questions
Psychic Distress (PD): 6 questions
Social desirability (SD): 6 questions
Energy Level (EL): 4 questions
Ability to Relax (AR): 3 questions
Nocturnal Sleep (NS): 3 questions											  

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

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

(1) Raw data file: 'sleepwakeactivityinventory.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: 1 (Always) 9 (Never))
								Note: Recorded Scores reflect Reversed scoring for questions with 'Reversed' in the question label

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: 'sleepwakeactivityinventory_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)

edsScore: 						score for the Excessive Daytime Sleepiness Scale: 9 (high daytime sleepiness)-81 (low daytime sleepiness)
pdScore:						score for the Psychic Distress Scale: 6 (high psychic distress) - 54 (low psychic distress)
sdScore:						score for the Social Desirability Scale: 6 (low social desirability) - 54 (high social desirability)
elScore:						score for the Energy Level Scale: 4 (high energy) - 36 (low energy)
arScore: 						score for the Ability to Relax Scale: 3 (high ability to relax) - 27 (low ability to relax)
nsScore:						score for the Nocturnal Sleep Scale: 3 (high ability to fall asleep at night)- 27 (low ability to fall asleep at night)
(the recorded raw scores reflect reversed coding where appropriate)

___________________________________________________________________________________________________________________
QUESTIONNAIRE SET-UP
___________________________________________________________________________________________________________________	
The questionnaire consists of 59 9-point Likert questions. 
31 questions score on 6 subscales, the remaining 28 questions are not considered for scoring.

Excessive Daytime Sleepiness (EDS): 9 questions (9, 13, 24, 29, 40, 45, 50, 53, 54); Min 9 (high daytime sleepiness)- Max 81 (low daytime sleepiness)
Psychic Distress (PD): 6 questions (7, 16, 21, 32, 36, 37); Min 6 (high psychic distress) - Max 54 (low psychic distress)
Social desirability (SD): 6 questions (5, 15, 26, 27, 43, 49);  Min 6 (low social desirability) - Max 54 (high social desirability)
Energy Level (EL): 4 questions (8, 14R*, 30R*, 41); Min 4 (high energy) - Max 36 (low energy)
Ability to Relax (AR): 3 questions (34, 38R*, 51); Min 3 (high ability to relax) - Max 27 (low ability to relax)
Nocturnal Sleep (NS): 3 questions (11R*, 18, 35); Min 3 (high ability to fall asleep at night)- Max 27 (low ability to fall asleep at night)

*R: Script takes care of reversed coding where appropriate.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
see 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