User Manual: Inquisit Door Opening Task


___________________________________________________________________________________________________________________	

									DOOR OPENING TASK
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 12-12-2013
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 the DoorOpeningTask, a Response Perseveration Task, as described in:

Matthys, W., van Goozen, S. H. M., de Vries, H., Cohen-Kettenis, P. T., & van Engeland, H. (1998). The Dominance 
of Behavioural Activation over Behavioural  Inhibition in Conduct Disordered Boys with or without Attention Deficit 
Hyperactivity Disorder. Journal of Child Psychology and Psychiatry, 5, 643–651.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are asked to open doors. Opening a door is either rewarded with 1 point that is added to the total winnings 
or punished by 1 point being subtracted from the total winnings. The number of winning doors decreases over the 
course of the experiment while the number of losing doors increases. Participants can quit the experiment at any 
point keeping the number of points earned up to this point.
A large number of doors opened is indicative of response perseveration

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the max duration of the game (opening all doors) takes about 5 minutes

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

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

build:								The specific Inquisit version used (the 'build') that was run
computer.platform:					the platform the script was run on (win/mac/ios/android)
date, time: 						date and time script was run 
subject, group: 					with the current subject/groupnumber
session:							with the current session id

blockcode, blocknum:				the name and number of the current block (built-in Inquisit variable)
trialcode, trialnum: 				the name and number of the currently recorded trial (built-in Inquisit variable)
										Note: trialnum is a built-in Inquisit variable; it counts all trials run; even those
										that do not store data to the data file.
										
nextoutcome:						stores the win/loss status of the current door
											1 = it's a win door
											0 = it's a loss door
											
response:							the participant's response (here: scancode of the response key)
											57 = spacebar press
											16 = Q

quit:								tracks whether participant has decided to quit
											0 = participant is still playing
											1 = participant has quit the game
											
latency: 							the response latency
TotalScore:							tracks the total points earned (updated in trial.doorchoice)

summary variable:
totalnumberdoors:					saves the total number of doors that could be potentially opened during the experiment

count_opendoors:					tracks the number of doors openend before quit.
									Note: the more doors are opened the higher response perseveration


(2) Summary data file: 'dooropeningtask_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)
								
///parameter settings:								
skip_0percWin:						true = block.0perc_win is skipped (default)
									false = block.0perc_win is run								

skip_100percWin:					true = block.100perc_win is skipped (default)
									false = block.100perc_win is run
								

///summary variable:
totalnumberdoors:					saves the total number of doors that could be potentially opened during the experiment

count_opendoors:					tracks the number of doors openend before quit.
									Note: the more doors are opened the higher response perseveration
									
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________
1. Instruction Block
2. Block "100percent wins" (block.100perc_win) => optional; see editable value parameters.skip_100percWin
...
12. Block "0percent wins" (block.0perc_win) => optional, see editable value parameters.skip_0percWin

Each block potentially presents 10 doors with a pre-assigned win/loss ratio (see list.100perc_win - list.0perc_win)
=> within those 10 trials win/losses are randomly sampled (without replacement)

Matthys et al (1998) ran all 11 text blocks (max number of doors: 110) with a beginning credit of 0 points.
Win and Loss amount both equaled 1 point.

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
are provided by Millisecond Software; see section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
Instructions are not original and can be easily edited under section Editable Instructions
(Matthys et al, 1998, provide instructions on p.645).

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

/responsekey_open:							response key to open doors (default: " " -> spacebar)
/responsekey_quit:							response  key to quit (default: "Q")

/feedbackduration:							default presentation duration of the win/loss door feedback screen (default: 1000ms)

/startcredits:								the number of points that participants start with (default: 0)
													Note: that's the amount specified in Matthys et al (1998)
													
/winamount:									the number of points that participants get for opening a win door (default: 1)
/lossamount:								the number of points that participants lose for opening a loss door (default: 1)

/skip_100percWin:							true = block.100perc_win is skipped 
											false = block.100perc_win is run (default)
/skip_0percWin:								true = block.0perc_win is skipped
											false = block.0perc_win is run  (default)

/present_feedbacksummary:					true = one the final page of the experiments, the total score is displayed (default)	
											false = one the final page of the experiments, the total score is Not displayed