User Manual: Inquisit Balloon Analogue Risk Task


___________________________________________________________________________________________________________________	

									Balloon Analogue Risk Task (BART)
									(French Version)
___________________________________________________________________________________________________________________

last updated:  02-17-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-17-2022 Millisecond Software

Millisecond Software thanks Dr. Sylvain Iceta for sharing his French translations!

___________________________________________________________________________________________________________________
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 FILE INFORMATION 
___________________________________________________________________________________________________________________
The default data stored in the data files are:

(1) Raw data file: 'bart_french_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)
mean_timebtwpumps:				mean time between pumps for each balloon


(2) Summary data file: 'bart_french_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
->ballooncount_10 etc				->separate measures for the first 10 (1-10), the second 10 (11-20), and the last 10 balloons (21-30)

total_explosions:					the number of exploded balloons
-> total_explosions_10 etc: 		->separate measures for the first 10 (1-10), the second 10 (11-20), and the last 10 balloons (21-30)


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


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

averagepumpcount:					the mean average pump count (includes exploded balloons)
-> averagepumpcount_10 etc:			->separate measures for the first 10 (1-10), the second 10 (11-20), and the last 10 balloons (21-30)

adjustedtotalpumpcount:					sums up the pumps of balloons that did not explode
-> adjustedtotalpumpcount_10 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)
-> adjustedaveragepumpcount_10 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 10, the second 10, and the third 10 balloons.

/ 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)