User Manual: Inquisit Flow State Questionnaire of the Positive Psychology Lab (PPL-FSQ)


___________________________________________________________________________________________________________________	

				Flow State Questionnaire (PPL-FSQ: Flow State Questionnaire of the Positive Psychology Lab)
___________________________________________________________________________________________________________________	

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

Script Copyright © 02-22-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements a computerized version of the Flow State Questionnaire 
(PPL-FSQ: Flow State Questionnaire of the Positive Psychology Lab).

'Flow' = the positive feeling of balance btw. challenges of a task and personal capabilities to tackle it
resulting in a state of intrinsic motivation and task absorption.

The implemented procedure is based on:

Magyaródi, T.; Nagy, H.; Soltész, P.; Mózes, T. & Oláh, A. (2013).
Psychometric properties of a newly established flow state questionnaire.
The Journal of Happiness & Well-Being, 1(2), 89-100.

___________________________________________________________________________________________________________________
OVERVIEW
___________________________________________________________________________________________________________________
A 20-item, 5-point Likert scale self-report questionnaire with 11 items measuring subscale "Balance btw. 
challenges and skill" and
9 items measuring subscale "Absorption in the task".

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

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

(1) Raw data file: 'ppl_fsq_survey.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) - 5 point Likert scales (range: 1-5)
								B = questions score on 'balance' subscale
								A = questions score on 'absorption' subscale
								!Note: reversed scored items are automatically reversed scored								
								e.g. 'Strongly disagree' is coded as 5 on reversed scored items (see 'q10_A8R') whereas it is coded as 1 on regular items

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

total:								the combined score

Balance:							points on 'Balance btw. challenges and skill' subscale (range: 11-55)
									(the higher the points the higher the greater the reported 'balance')
								
Absorption:							points on 'Absorption in the task' subscale (range: 9 - 45)
									(the higher the points, the greater the reported absorption)


___________________________________________________________________________________________________________________
QUESTIONNAIRE SET-UP & SCORING
___________________________________________________________________________________________________________________
A 20-item, 5-point Likert scale self-report questionnaire with
* 11 items measuring subscales "Balance btw. challenges and skill": q1, q2, q6, q7, q11, q14, q16, q17, q18, q19, q20
* 9 items measuring subscale "Absorption in the task": q3, q4, q5, q8, q9, q10, q12, q13, q15

Question order in this script (based on Magyaródi et al, 2013, table 3):
* all questions are ordered from lowest numbered question ('1', see table 3) to highest numbered question ('23') (see table 3)
and then renamed q1-q20
* the names of each question contain a) the factor on which the question loads (A vs. B) and b) the original numbering
Example: q17_B18 => question 17 "I knew I was able to solve the task" loads on subscale B (Balance) and was originally labeled '18' (see table 3)
(double numbered questions in table 3 (e.g. 1) receive the additional letters A or B => 1A (first in table) vs. 1B (second in table))
* R = reversed scored (applies to two questions on absorption scale)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
Instructions are based on: 

Jackson, S.A., & Marsh, H.W. (1996). Development and validation of a scale to measure
optimal experience: The flow state scale. Journal of Sport & Exercise Psychology,
18, 17–35.

They can be edited under 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:			store the instructions presented on each surveypage