Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com), Millisecond
Created: January 28, 2015
Last Modified: January 30, 2025 by K. Borchert (katjab@millisecond.com), Millisecond
Script Copyright © Millisecond Software, LLC
This script implements the Effort Expenditure for Rewards Task (EEfRT); a measure of reward motivation for physical work. The implemented procedure is based on Treadway et al (2009).
Treadway MT, Buckholtz JW, Schwartzman AN, Lambert WE, Zald DH (2009) Worth the ‘EEfRT’? The Effort Expenditure for Rewards Task as an Objective Measure of Motivation and Anhedonia. PLoS ONE 4(8): e6598. doi:10.1371/journal.pone.0006598
23 minutes
Participants have to select between an Easy and a Hard task. Both tasks involve pressing the Spacebar for a predetermined amount of time. The Hard task offers more money (in this script: 8 variable amounts) but is harder and takes twice as long. Participants make their selection knowingly under 3 different win probabilities (aka they might not win money even if they are successful; particularly not if the win probabilities are low). By default, E selects the Easy task and I selects the Hard task (can be edited under section Editable Parameters).
The instructions are not original to Treadway et al (2009). They are provided by Millisecond.
They can be edited under section Editable Instructions.
File Name: effortexpenditureforrewardtask_summary*.iqdat
| Name | Description |
|---|---|
| inquisit.version | Inquisit version number |
| computer.platform | Device platform: win | mac |ios | android |
| computer.touch | 0 = device has no touchscreen capabilities; 1 = device has touchscreen capabilities |
| computer.hasKeyboard | 0 = no external keyboard detected; 1 = external keyboard detected |
| startDate | Date the session was run |
| startTime | Time the session was run |
| subjectId | Participant ID |
| groupId | Group number |
| sessionId | Session number |
| elapsedTime | Session duration in ms |
| completed | 0 = Test was not completed 1 = Test was completed |
Summary Data: Based On Full Cycles Only (Trial Sequences That Were Cut Short Due To Time Constraints Do Not Count Towards Summary Variables) |
|
| randomwin1 | Stores the first randomly selected win amount (in case this is used for an extra incentive) |
| randomwin2 | Stores the second randomly selected win amount (in case this is used for an extra incentive) |
| total | Stores the total of all rewards earned |
| countTestTrials | Counts the number of testtrials |
| countEasy | Counts the number of easy trials (includes forced easy trials) |
| countHard | Counts the number of hard trials (includes forced hard trials) |
| countSuccessEasy | Counts the number of successful easy trials |
| countSuccessHard | Counts the number of successful hard trials |
| countForced | Counts the number of times computer had to randomly select a level of difficulty for participant |
| meanRTSelection | Mean latency (in ms) of selection (excludes forced selections) |
| meanTaskDurationE | Mean successful taskduration (pressing button; in ms) of the easy task |
| meanTaskDurationH | Mean successful taskduration (pressing button; in ms) of the hard task |
| proportionNonforcedHardChoices | Overall proportion of non-forced choices of the difficult task relative to the number of presented choices |
| meanRTNonforcedHardChoices | Overall mean choice response time (in ms) for selecting difficult task (non-forced) |
| proportionNonforcedHardChoicesP1 | Proportion of non-forced choices of the difficult task for win probability p1 (12% chance) |
| meanRTNonforcedHardChoicesP1 | Overall mean choice response time (in ms) for selecting difficult task (non-forced) for win probability p1 (12% chance) |
| proportionNonforcedHardChoicesP2 | Proportion of non-forced choices of the difficult task for win probability p2 (50% chance) |
| meanRTNonforcedHardChoicesP2 | Overall mean choice response time (in ms) for selecting difficult task (non-forced) for win probability p2 (50% chance) |
| proportionNonforcedHardChoicesP3 | Proportion of non-forced choices of the difficult task for win probability p3 (88% chance) |
| meanRTNonforcedHardChoicesP3 | Overall mean choice response time (in ms) for selecting difficult task (non-forced) for win probability p3 (88% chance) |
File Name: effortexpenditureforrewardtask_raw*.iqdat
| Name | Description |
|---|---|
| build | Inquisit version number |
| computer.platform | Device platform: win | mac |ios | android |
| computer.touch | 0 = device has no touchscreen capabilities; 1 = device has touchscreen capabilities |
| computer.hasKeyboard | 0 = no external keyboard detected; 1 = external keyboard detected |
| date | Date the session was run |
| time | Time the session was run |
| subject | Participant ID |
| group | Group number |
| session | Session number |
| blockcode | The name the current block (built-in Inquisit variable) |
| blocknum | The number of the current block (built-in Inquisit variable) |
| trialcode | The name of the currently recorded trial (built-in Inquisit variable) |
| trialnum | The number of the currently recorded trial (built-in Inquisit variable) trialnum is a built-in Inquisit variable; it counts all trials run even those that do not store data to the data file. |
| practice | 0 = test; 1 = practice |
| countTestTrials | Counts the number of COMPLETED testtrials |
| rewardEasy | The potential reward assigned to the Easy task (default: "1.00") |
| rewardHard | The currently assigned reward amount for the hard task |
| winProbability | The currently assigned win probability |
| selectionResponse | The key scancode of the selection response |
| forced | 1 = the task difficulty was randomly assigned to participant (did not choose themselves) 0 = participant selected difficulty |
| selectedDifficulty | The task difficulty chosen/assigned: 0 = easy task; 1 = hard task |
| selectedTask | "easy" vs. "hard" |
| selectionrt | The latency of the selection in ms (excludes forced choices) |
| countPresses | Counts the button presses of the current trial |
| finalTaskDuration | The duration (in ms) spent on the task (pressing buttons) |
| success | 1 = task was successfully completed; 0 = task was not completed |
| win | 1 = the successful completion is rewarded; 0 = the successful completion is not rewarded |
| currentReward | The currently assigned (potential) reward amount for the task chosen |
| total | Stores the total of all rewards earned |
The procedure can be adjusted by setting the following parameters.
| Name | Description | Default |
|---|---|---|
Colors |
||
| screenColor | The color of the 'inactive' screen | white |
| canvasColor | The color of the 'active' screen if changed, you may need to change the taskselection images | white |
| defaultTextColor | The default text color | black |
Design |
||
| rewardEasy | The potential reward assigned to the Easy task | "1.00" |
| easyPresses | Number of button presses for the Easy task | 30 |
| hardPresses | Number of button presses for the Hard task | 100 |
| maxPayOff | Default: ""; no maximum payoff is set If set to a number, then the script terminates when that number is reached | "" |
| showTimer | Show a timer while performing the task | false |
Timing Parameters |
||
| completeTaskDuration | The duration of the completed task in ms -> 20min | 1200000 |
| selectionWindow | The max. response window to make the task selection in ms | 5000 |
| readyDuration | The duration of the Ready screen in ms | 1000 |
| easyDuration | The max. duration of the Easy task in ms | 7000 |
| hardDuration | The max. duration of the Hard task in ms | 21000 |
| successFeedbackDuration | The duration of the feedback screen regarding success/failure in ms | 2000 |
| winFeedbackDuration | The duration of the feedback screen regarding the reward money won in ms | 2000 |
Response Keys |
||
| responseKeyEasy | The response key for the Easy selection | "E" |
| responseKeyHard | The response key for the Hard selection | "I" |