User Manual: Inquisit Graded Chronic Pain Scale - Revised (GCPS-R)


___________________________________________________________________________________________________________________	

								*Graded Chronic Pain Scale - Revised (GCPS-R)*
___________________________________________________________________________________________________________________	

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

Script Copyright © 06-15-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the Graded Chronic Pain Scale-Revised (GCPS-R). 
The GCPS-R uses a standard 3-month recall period for assessing chronic pain and high-impact chronic pain, 
as well as a  1-week time frame for assessing current pain severity.

Reference

Von Korff, M.; DeBar, L.L.; Krebs, E.E,c; Kerns, R.D.; Deyo, R.A; Keefe, F.J.(2020).
Graded chronic pain scale revised: mild, bothersome, and high-impact chronic pain.
PAIN,161,651-661.
doi: 10.1097/j.pain.0000000000001758


___________________________________________________________________________________________________________________
OVERVIEW
___________________________________________________________________________________________________________________	

This script runs 2 screening question regarding chronic pain during the last 3 months as well as
well as 4 questions regarding pain severity during the last week. 

If the answer to the first question is 0 ("no pain during the last 3 months"), the remaining questions are
skipped.
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 1 minute to complete

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

(1) Raw data file: 'gradedchronicpainscale_revised.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:
									R = 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: 'gradedchronicpainscale_revised_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)
								
grade:								0: chronic pain absent
									1: mild chronic pain
									2: bothersome chronic pain
									3: high impact chronic pain

+ responses to the individual 6 questions								
								
___________________________________________________________________________________________________________________
QUESTIONNAIRE SET-UP & SCORING
___________________________________________________________________________________________________________________								
		
6 likert-type questions:

grade scoring follows the algorithm outline in vonKorff et al (2020):
q1 = if response is Never/Some days => grade 0
q2 = if response is Most Days/Every Day => grade3
(q3+q4+q5) >= 12 => grade 2 else grade 1		
___________________________________________________________________________________________________________________	
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:

/pageInstructions:					the general instructions provided