Return to the Jumping To Conclusion (JTC) Beads Task page
___________________________________________________________________________________________________________________	

						JUMPING TO CONCLUSION (JTC) - BEADS TASK ("Jar Task")
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 10-28-2014
last updated: 12-16-2019 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC

Script Copyright © 12-16-2019 Millisecond Software

Millisecond Software thanks Sarah Reeve for assistance with this script!
___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements the Jumping to Conclusion (JTC) Beads Test, a probabilistic reasoning task.

The implemented procedure is similar to the one described in:

Garety, P. A., Hemsley, D. R. & Wessely, S. (1991). Reasoning in deluded schizophrenic and paranoid
patients : Biases in performance on a probabilistic inference task. Journal of Nervous and Mental Disease,
179, 194-201.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants are presented with 2 jars (A and B) with different ratios of red to blue beads (15:85).
They are told that the computer selects one jar and draws beads from it with replacement.
The computer will draw one bead at a time and always returns the bead to the jar before it draws the next bead.
The participant's task is decide which jar the computer selected.
By default, participants can ask for as many beads as they need to make a decision 
(number of max. drawings can be limited).
A sequence of small red and blue beads at the bottom of the screen reminds participants 
of all the beads drawn up to this 
point.
											  
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 1 minute to complete

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

(1) Raw data file: 'jtc_beadtask_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
script.sessionid:				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 such as feedback trials
									
parameters.type_drawing:	"random" vs. "predetermined" (can be set under section Editable Parameters)

parameters.max_drawings:	"unlimited" vs. an integer (can be set under section Editable Parameters)

parameters.feedback:		true (1) = participants receive feedback at the end
								false (0) = participants receive no feedback at the end (can be set under section Editable Parameters)

parameters.jarA:				stores the ratio of red to blue beads in jar A (default: "85R:15B")
parameters.jarB:				stores the ratio of red to blue beads in jar B (default: "15R:85B")
Target Jar:					"A" or "B" (counterbalanced by groupnumber)

values.bead,:					1 = high probability bead drawn; 
								2 = low probability bead drawn
									
stimulusitem:					the presented stimuli in order of trial presentation
response:						the participant's response
latency: 						the response latency (in ms); measured from start of current trial
values.rt_start:				stores the latency (in ms) from start of task until the Spacebar is pressed to see the first bead
values.rt_drawing:			stores the latency (in ms) from presentation of first bead to pressing 'D' (decision)
values.selectedjar:			stores the jar participant selects
values.decision:				"correct" vs. "incorrect"
values.beatCount:			counts the number of beads drawn
values.beadsequence:		stores the bead sequence (e.g. R, R, B, R, R, R, ....)


(2) Summary data file: 'jtc_beadtask_summary*.iqdat' (a separate file for each participant)

Computer Platform:				the platform the script was run on (win/mac/ios/android)
Date:								date script was run
Time:								time script was started
Subject ID:							assigned subject id number
Group ID:							assigned group id number
Session ID:							assigned session id number
Script Duration:					time it took to run script (in ms); measured from onset to offset of script
Script Completion:				0 = script was not completed (prematurely aborted); 
									1 = script was completed (all conditions run)
									
parameters.type_drawing:		"random" vs. "predetermined" (can be set under section Editable Parameters)

parameters.max_drawings:		"unlimited" vs. an integer (can be set under section Editable Parameters)

parameters.feedback:			true (1) = participants receive feedback at the end
									false (0) = participants receive no feedback at the end (can be set under section Editable Parameters)

parameters.jarA:					stores the ratio of red to blue beads in jar A (default: "85R:15B")
parameters.jarB:					stores the ratio of red to blue beads in jar B (default: "15R:85B")
values.targetjar:							"A" or "B" (counterbalanced by groupnumber)

values.selectedjar:				stores the jar participant selects
values.decision:					"correct" vs. "incorrect"
values.beatCount:				counts the number of beads drawn
values.rt_drawing:				stores the latency (in ms) from presentation of first bead to pressing 'D' (decision)
expressions.meanrt_drawing:  	mean latency (in ms) of trial.beaddrawing
expressions.medianrt_drawing:	median latency (in ms) of trial.beaddrawing
values.beadsequence:			stores the bead sequence (e.g. R, R, B, R, R, R, ....)

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

The default design of this JTC task is consistent with the "draws to decision" methologies:
Participants can request as many beads as they need to make a decision.
!HOWEVER, the number of drawings can be limited via an editable parameter (parameters.max_drawings).
Go to section Editable Parameters and edit parameters.max_drawings.

Bead Sequence: the default bead sequence is randomly determined (with replacement).
If a predetermined sequence is needed, go to 
a) section Editable Parameters and edit parameters.type_drawing accordingly
b) section Editable Lists and edit the drawing sequence under list.beadsequence_predetermined accordingly

Feedback is optional. By default, participants receive feedback at the end.
To change: Go to section Editable Parameters and edit parameters.feedback

Target Jar A/B are counterbalanced by groupnumber:
odd groupnumbers are assigned to TargetJar A
even groupnumbers are assigned to TargetJar B

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
Jar images: the default images with this script contain 100 beads in each jar (85 of one color, 15 of the other).
Alternative images provided:
* with opaque jars with 85:15
* with ratio 60:40
(go to Editable Stimuli to change the images).

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
The provided instructions are provided by Millisecond Software and can be edited under
section Editable 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:

/jarA:					stores the ratio of red to blue beads in jar A (default: "85R:15B")
/jarB:					stores the ratio of red to blue beads in jar B (default: "15R:85B")
							Note: 	*if these default ratios are changed, the images under item.jars need to be edited accordingly
									*if these default ratios are changed, list.beadsequence_random might have to edited accordingly
								
/color1:				sets bead color1; the predominant color in jar A (default: red)
/color2:				sets bead color2; the predominant color in jar B (default: blue)
							Note: if these default colors are changed, the images under item.jars need to be edited accordingly

/type_drawing:		"random" vs. "predetermined" (default: "random")
						!Note: if "predetermined" go to 'Editable Lists' and edit list.beadsequence_predetermined
						(default list from Garety et al, 1991, condition 2) as well as set parameters.max_drawings below
						
/max_drawings:		"unlimited" vs. an integer e.g. /nr_drawing = 20 (default: "unlimited")
							Note: if the number of maximum beads is limited, the instructions under item.instructions may 
							need to be edited accordingly

/feedback:				true = participants receive feedback at the end (default)
						false = participants receive no feedback at the end