Return to the Hungry Donkey Task page
						
									Hungry Donkey Task
SCRIPT INFO

Script Author: David Nitz (dave@millisecond.com) for Millisecond Software, LLC
last updated: 01-12-2016 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC

Copyright © 01-12-2016 Millisecond Software


BACKGROUND INFO

											*Purpose*
	This script implements the 'Hungry Donkey Task' as described in:

	Crone, E. A., & van der Molen, M. W. (2004). Developmental changes in real life decision 
	making: Performance on a gambling task previously shown to depend on the ventromedial 
	prefrontal cortex. Developmental Neuropsychology, 25(3), 251-279.

	The picture stimuli used in this task were adapted from the open source PEBL Test Battery 
	available at 'http://pebl.sourceforge.net'.


											  *Task*
The goal of the game is to collect as many apples as possible for a hungry donkey.
The apples can be found behind 4 doors.	Each door can either offer apples or take apples
away or both at the same time. The 4 doors are tied to 4 different reinforcement
schedules: two of the doors offer overall more apples than take them away (advantageous doors);
two doors overall take more apples than offer them (disadvantageous doors).


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

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

build:							Inquisit build
computer.platform:				the platform the script was run on
date, time, subject, group:		date and time script was run with the current subject/groupnumber 
blockcode, blocknum:			the name and number of the current block
trialcode, trialnum: 			the name and number of the currently recorded trial
									(Note: not all trials that are run might record data; by default data is collected unless /recorddata = false is set for a particular trial/block) 
doorsselected:					Running count of the number of doors selected by the subject.
latency: 						the response latency (in ms)
response:						the participant's response
currentgain:					Amount of apples gained in a given trial.
currentloss:					Amount of apples lost in a given trial.
total:							total earned
globalgain:						Amount of apples gained across the whole task with separate 
								counts for standard and reversed version.
globalloss:						Amout of apples lost across the whole task with separate 
								counts for standard and reversed version.
dooragain:						Amount of apples gained across the whole task for Door A with 
								separate counts for standard and reversed version.
dooraloss:						Amount of apples lost across the whole task for Door A with 
								separate counts for standard and reversed version.
doorbgain:						Amount of apples gained across the whole task for Door B with 
								separate counts for standard and reversed version.
doorbloss:						Amount of apples lost across the whole task for Door B with 
								separate counts for standard and reversed version.
doorcgain:						Amount of apples gained across the whole task for Door C with 
								separate counts for standard and reversed version.
doorcloss:						Amount of apples lost across the whole task for Door C with 
								separate counts for standard and reversed version.
doordgain:						Amount of apples gained across the whole task for Door D with 
								separate counts for standard and reversed version.
doordloss:						Amount of apples lost across the whole task for Door D with 
doorahposition:					Horizontal screen position for Door A and associated elements
								assigned by 'trial.doorpositions' and 'list.doorpositions' at block 
								onset. By default, doors are positioned in alphabetical order from 
								left to right (A->B->C->D). See comments for 'list.doorpositions'
								for further details.
doorbhposition:					Horizontal screen position for Door B and associated elements
								assigned by 'trial.doorpositions' and 'list.doorpositions' at block 
								onset. By default, doors are positioned in alphabetical order from 
								left to right (A->B->C->D). See comments for 'list.doorpositions'
								for further details.
doorchposition:					Horizontal screen position for Door C and associated elements
								assigned by 'trial.doorpositions' and 'list.doorpositions' at block 
								onset. By default, doors are positioned in alphabetical order from 
								left to right (A->B->C->D). See comments for 'list.doorpositions'
								for further details.
doordhposition:					Horizontal screen position for Door D and associated elements
								assigned by 'trial.doorpositions' and 'list.doorpositions' at block 
								onset. By default, doors are positioned in alphabetical order from 
								left to right (A->B->C->D). See comments for 'list.doorpositions'
								for further details.
trackingcondition:				Adjustable parameter to switch between three different feedback
								tracking conditions (i.e. which feedback bars are available).
								'1' -> Display global and local feedback.
								'2' -> Display only global feedback.
								'3' -> Display no visual feedback at all.


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

script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				subject id number
script.groupid:					group id number
script.elapsedtime:				time it took to run script (in ms)
computer.platform:				the platform the script was run on
/completed:						0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run)
total:							total earned
globalgain:						Amount of apples gained across the whole task with separate 
								counts for standard and reversed version.
globalloss:						Amout of apples lost across the whole task with separate 
								counts for standard and reversed version.
dooragain:						Amount of apples gained across the whole task for Door A with 
								separate counts for standard and reversed version.
dooraloss:						Amount of apples lost across the whole task for Door A with 
								separate counts for standard and reversed version.
doorbgain:						Amount of apples gained across the whole task for Door B with 
								separate counts for standard and reversed version.
doorbloss:						Amount of apples lost across the whole task for Door B with 
								separate counts for standard and reversed version.
doorcgain:						Amount of apples gained across the whole task for Door C with 
								separate counts for standard and reversed version.
doorcloss:						Amount of apples lost across the whole task for Door C with 
								separate counts for standard and reversed version.
doordgain:						Amount of apples gained across the whole task for Door D with 
								separate counts for standard and reversed version.
doordloss:						Amount of apples lost across the whole task for Door D with 
doorahposition:					Horizontal screen position for Door A and associated elements
								assigned by 'trial.doorpositions' and 'list.doorpositions' at block 
								onset. By default, doors are positioned in alphabetical order from 
								left to right (A->B->C->D). See comments for 'list.doorpositions'
								for further details.
doorbhposition:					Horizontal screen position for Door B and associated elements
								assigned by 'trial.doorpositions' and 'list.doorpositions' at block 
								onset. By default, doors are positioned in alphabetical order from 
								left to right (A->B->C->D). See comments for 'list.doorpositions'
								for further details.
doorchposition:					Horizontal screen position for Door C and associated elements
								assigned by 'trial.doorpositions' and 'list.doorpositions' at block 
								onset. By default, doors are positioned in alphabetical order from 
								left to right (A->B->C->D). See comments for 'list.doorpositions'
								for further details.
doordhposition:					Horizontal screen position for Door D and associated elements
								assigned by 'trial.doorpositions' and 'list.doorpositions' at block 
								onset. By default, doors are positioned in alphabetical order from 
								left to right (A->B->C->D). See comments for 'list.doorpositions'
								for further details.
trackingcondition:				Adjustable parameter to switch between three different feedback
								tracking conditions (i.e. which feedback bars are available).
								'1' -> Display global and local feedback.
								'2' -> Display only global feedback.
								'3' -> Display no visual feedback at all.

EXPERIMENTAL SET-UP

2 conditions (standard, reverse), tested within-subjects, order is counterbalanced by groupnumber aassignment
=> 200 trials in each block

Standard: Doors C, D are advantageous (across 10 draws: gain of 10 apples); doors A, B are disadvantageous (across 10 draws: loss of 10 apples)
Reverse: Doors C, D are disadvantageous; doors A, B are advantageous

win/loss amounts of apples are sampled randomly from a list of 10 possible outcomes that are different for each door.
After 10 selections, the lists reset.
	
STIMULI
The picture stimuli used in this task were adapted from the open source PEBL Test Battery 
available at 'http://pebl.sourceforge.net'.

INSTRUCTIONS
The instructions 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:

	feedbackduration:			Duration of trial feedback in milliseconds. The original task used 
								2000 ms.
	trackingcondition:			Adjustable parameter to switch between three different feedback
								tracking conditions (i.e. which feedback bars are available).
								'1' -> Display global and local feedback.
								'2' -> Display only global feedback.
								'3' -> Display no visual feedback at all.
	runstandard:				Pseudo-boolean switch to easily (de)activate the task's standard
								version. '1' will run the standard version, '0' will skip the standard
								block. By default, both standard and reversed version of the task
								are run in counterbalanced order.
	runreversed:				Pseudo-boolean switch to easily (de)activate the task's reversed
								version. '1' will run the reversed version, '0' will skip the reversed
								block. By default, both standard and reversed version of the task
								are run in counterbalanced order.

Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Security Statement | Employment