User Manual: Inquisit Balloon Analogue Risk Task


___________________________________________________________________________________________________________________	

						Balloon Analogue Risk Task (BART) - Hebrew Version
___________________________________________________________________________________________________________________

last updated:  06-12-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 06-12-2024 Millisecond Software
Millisecond Software thanks Ilana Hairston (hanahai@telhai.ac.il) for sharing the Hebrew translations!

Note from Ilana Hairston:
This script was adapted to be used in Hebrew.  Some of the instructions are hidden due to problems with 
display of Hebrew fonts. If you want to edit the text, copy and paste the element into any simple text editor, 
make the changes and then paste back into Inquisit.
GOOD LUCK!

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements the BART, a measure of impulsivity and risk aversion, based on:

Lejuez, C. W., Read, J. P., Kahler, C. W., Richards, J.B., Ramsey, S. E., Stuart, G. L., et al. (2002). 
Evaluation of a behavioral measure of risk-taking: The Balloon Analogue Risk Task (BART).
Journal of Experimental Psychology: Applied, 8, 75–84. 

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are given 30 (default) balloons. For each balloon they get the choice to pump up the balloon or
collect their winnings. For each successful pump, they can earn money. However, if a balloon pops before 
participants collect their potential winnings, they lose all their potential winnings for the current balloon.
The average number of pumps for unexploded balloons is the main Dependent Variable in this paradigm.
High numbers indicate increased risk seeking behavior.

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

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

(1) Raw data file: 'bart_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 such as feedback trials. Thus, trialNum 
										may not reflect the number of main trials run per block.
																					
balloonCount:					running total of number of balloons
response:						the participant's response 
latency: 						the response latency (in ms)
pumpCount:						number of times the participant presses the pump button for each balloon (resets for each balloon)
pumpResult:						the selected digit from list.pumpResult (1 = balloon explodes)
totalEarnings:					currently earned reward up to this point

timeBefore1stPump:				time (in ms) before 1.pump
timeBeforeCollectWithoutPump: 	time (in ms) before collecting without pumping first
timeBtwLastPumpAndCollect:		time (in ms) btw. last pump and collect
timeBtwPumps:					time (in ms) between pumps (excluding time before first pump)
meanTimeBtwPumps:				mean time between pumps for each balloon


(2) Summary data file: 'bart_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)

totalEarnings:					sums up the earnings across balloons

balloonCount:					running total of number of balloons
->balloonCount1 etc				->separate measures for the first third (trials 1-10), the second third (trials 11-20), and the third (trials 21-30)

totalExplosions:				the number of exploded balloons
-> totalExplosions1 etc: 		->separate measures for the first third (trials 1-10), the second third (trials 11-20), and the third (trials 21-30)


nonExplodedBalloons: 			the number of balloons out of (default) 30 that did NOT explode
->nonExplodedBalloons1 etc:		->separate measures for the first third (trials 1-10), the second third (trials 11-20), and the third (trials 21-30)


totalPumpCount:					total number of times the participant presses the pump button across all balloons (includes exploded balloons)
-> totalPumpcount1 etc:			->separate measures for the first third (trials 1-10), the second third (trials 11-20), and the third (trials 21-30)

averagePumpCount:				the mean average pump count (includes exploded balloons)
-> averagePumpcount1 etc:		->separate measures for the first third (trials 1-10), the second third (trials 11-20), and the third (trials 21-30)

adjustedTotalPumpCount:					sums up the pumps of balloons that did not explode
-> adjustedtotalPumpcount1 etc.:		->separate measures for the first 10, the second 10, and the last 10 balloons

adjustedAveragePumpCount:				mean number of pumps only of balloons that did not explode (=Main Dependent Variable)
-> adjustedAveragePumpcount1 etc:		->separate measures for the first 10, the second 10, and the last 10 balloons
										Note: the lower the number the more risk averse the participant

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________
* 30 ballons to pump up 
* each (successful) pump increases the possible winnings gained from this balloon
	Determination of Explosionpoints: random for each balloon
	script samples randomly without replacement from a list of numbers 1-128: once the 1 gets sampled, the current balloon pops.
	The probability that the 1 gets sampled increases after each successful pump.

* participant can decide whether to "collect" the winnings or keep pumping to increase the 
reward further. Participants are told that each balloon will explode at some point and that in the
case of an exploding balloon no money will be won from the popped balloon. Further, participants are alerted to 
the fact that some balloons may explode after only 1 pump while others may fill up the entire screen before they explode.
*after 30 balloons have been pumped, the experiment is over, and participants can collect their total winnings

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
Instructions can be easily 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:

/ totalBalloons: 					Number of balloons: Default is 30 
									Note: this script includes summary variables that distinguish between the first third (here balloons: 1-10), the second third (here balloons: 11-20), and the third (here balloons: 21-30).

/ pumpValue: 						Payoff per pump: Default is $.05

/ balloonSizeIncrement: 			Ballon size increment in scale proportion to the original image

/ showPumpCount: 					Show current pump count
										true: pump count is shown to participant  (default)
										false: pump count is not shown to participant

/ showBalloonCount: 				Show current balloon count: 
										true: ballon count is shown to participant  (default)
										false: ballon count is not shown to participant

/ showPotentialEarnings: 			Show potential earnings for the current balloon (default)