Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com), Millisecond
Millisecond thanks Dr. Malte Friese for collaborating on this script!
Created: January 11, 2016
Last Modified: January 05, 2023 by K. Borchert (katjab@millisecond.com), Millisecond
Script Copyright © Millisecond Software, LLC
This script implements the Demand Selection Task based on:
Kool W, McGuire JT, Rosen ZB, Botvinick MM (2010) Decision making and the avoidance of cognitive demand. J Exp Psychol Gen 139: 665–682.
McGuire JT, Botvinick MM (2010) Prefrontal cortex, cognitive control, and the registration of decision costs. Proc Natl Acad Sci U S A 107: 7922–7926.
The implemented version in this script is based on Kool et al (2010), Experiment 3. The script automatically adapts response keys to the dominant hand. (dominant hand on mouse, other hand on response buttons)
50 minutes
Participants see 2 stimuli (patterned discs) on the screen and are asked to select one of them with the mouse. A digit appears on the selected disc. The color of the digit represents a different cognitive task: blue ('parity' task)-> decide if number is even (if so press the right response key; otherwise press the left response key) purple ('magnitude' task)-> decide if number is bigger than 5 (if so press the right response key, otherwise press the left response key).
One of the 2 discs represents a high cognitive demand condition: if chosen, the cognitive tasks (parity/magnitude) repeatedly switch from one to the other. The other disc represents a low cognitive demand condition: if chosen, the cognitive tasks (parity/magnitude) repeat the previous ones with a high likelihood
Practice Block(s):
• 10 trials: random order of 5 parity and 5 magnitude tests (digits are randomly chosen)
• repeats if block performance < 90%
Test Block set-up:
• 8 blocks (75 trials each = 600 trials total) with 8 different stim pairs (stims randomly assigned to each run; no repeats)
• one stim is randomly assigned the 'high cognitive demand' condition; the other stim is assigned the 'low cognitive demand' condition
• 8 different spatial arrangements of stim pairs (circular arrangement, stims are opposite of each other and wander in 45degrees increments);
randomly sampled (without replacement) for each block
Trial Sequence:
Select center with mouse -> stims appear: select one of the stims -> digit appears on selected stim in either blue or purple: do task
2 cognitive tasks:
a) digit in color purple: 'if digit is even, press right key, otherwise left key (both with left hand)
b) digit in color blue: 'if digit > 5, press right key, otherwise left key (both with left hand)
=> 8 digits are used: 1, 2, 3, 4, 6, 7, 8, 9; equally often sampled across 600 trials (= each sampled 75 times)
2 cognitive demand conditions:
a) low cognitive demand: same cognitive task as previous trial with probability = 0.9
b) high cognitive demand: same cognitive task as previous trial with probability = 0.1
the first trial in each block is randomly chosen to be a magnitude or parity task.
It's switch category is set to "first trial" (thus it's neither a switch nor a reversal trial)
provided by Millisecond (stimuli are not original to Kool et al, 2010)
They can be edited under section Editable Stimuli
provided by Millisecond (instructions are not original to Kool et al, 2010)
They are provided and presented in the form of html-files which can be edited directly.
File Name: demandselectiontask_summary*.iqdat
| Name | Description |
|---|---|
| inquisit.version | Inquisit version number |
| computer.platform | Device platform: win | mac |ios | android |
| 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 |
| version | RH (version for right handed participants) vs. LH (version for left handed participants) |
| propSelectionHD | The overall proportion of selecting the high demand (HD) option across all blocks and trials |
| meanRTChoiceHD | The mean latency of selecting the high demand (HD) option across all blocks and trials |
| propSelectionLD | The overall proportion of selecting the low demand (LD) option across all blocks and trials |
| meanRTChoiceLD | The mean latency of selecting the low demand (LD) option across all blocks and trials |
| propCorrect | The overall proportion of correct responses across tasks and across all blocks and trials |
| meanRT | The mean latency (in ms) of correct responses across tasks and across all blocks and trials |
| propCorrectHD | The proportion correct responses under high demand conditions (across tasks and across all blocks and trials) |
| meanRTHD | The mean latency (in ms) of correct responses under high demand conditions (across tasks and across all blocks and trials) |
| propCorrectLD | The proportion correct responses under low demand conditions (across tasks and across all blocks and trials) |
| meanRTLD | The mean latency (in ms) of correct responses under low demand conditions (across tasks and across all blocks and trials) |
| propCorrectParity | The proportion correct responses to the Parity task (across all blocks and trials) |
| meanRTParity | The mean latency (in ms) of correct responses to the Parity task (across all blocks and trials) |
| propCorrectMagnitude | The proportion correct responses to the Magnitude task (across all blocks and trials) |
| meanRTMagnitude | The mean latency (in ms) of correct responses to the Magnitude task (across all blocks and trials) |
| propCorrectHDParity | The proportion correct responses to the Parity task under high demand conditions (across all blocks and trials) |
| meanRTHDParity | The mean latency (in ms) of correct responses to the Parity task under high demand conditions (across all blocks and trials) |
| propCorrectHDMagnitude | The proportion correct responses to the Magnitude task under high demand conditions (across all blocks and trials) |
| meanRTHDMagnitude | The mean latency (in ms) of correct responses to the Magnitude task under high demand conditions (across all blocks and trials) |
| propCorrectLDParity | The proportion correct responses to the Parity task under low demand conditions (across all blocks and trials) |
| meanRTLDParity | The mean latency (in ms) of correct responses to the Parity task under low demand conditions (across all blocks and trials) |
| propCorrectLDMagnitude | The proportion correct responses to the Magnitude task under low demand conditions (across all blocks and trials) |
| meanRTLDMagnitude | The mean latency (in ms) of correct responses to the Magnitude task under low demand conditions (across all blocks and trials) |
| nrSwitchTrials | Count of the number of switch trials run |
| nrRepetitionTrials | Count of the number of repetition trials run first trials in each test block are counted as neither |
| propCorrectSwitch | The proportion correct of switch task trials (across tasks and all blocks and trials) |
| meanRTSwitch | The mean latency (in ms) of correct responses to switch task trials (across tasks and all blocks and trials) |
| propCorrectRepetition | The proportion correct of Repetition task trials (across tasks and all blocks and trials) |
| meanRTRepetition | The mean latency (in ms) of correct responses to nowitch task trials (across tasks and all blocks and trials) * can be changed to one file for all participants under section DATA |
File Name: demandselectiontask_raw*.iqdat
| Name | Description |
|---|---|
| build | Inquisit version number |
| computer.platform | Device platform: win | mac |ios | android |
| date | Date the session was run |
| time | Time the session was run |
| subject | Participant ID |
| group | Group number |
| session | Session number |
| blockCode | Name of the current block |
| blockNum | Number of the current block |
| trialCode | Name of the current trial |
| trialNum | Number of the current trial |
| version | RH (version for right handed participants) vs. LH (version for left handed participnts) |
| phase | "practice" vs. "choice" vs. "task" |
| practiceBlockCount | Counts the practice blocks |
| testBlockCount | Counts the test blocks |
| trialCount | Counts the number of trials in a test block |
| stimADemand | 1 = high demand for stim A; 2 = low demand for stim A (for the current block) |
| stimBDemand | 1 = high demand for stim B; 2 = low demand for stim B (for the current block) |
| stiMax | The horizontal coordinate for stim A (for the current block) |
| stimAY | The vertical coordinate for stim A (for the current block) |
| stimBX | The horizontal coordinate for stim B (for the current block) |
| stimBY | The vertical coordinate for stim B (for the current block) |
| itemNumberA | The selected itemnumber for stim A (for the current block) |
| itemNumberB | The selected itemnumber for stim B (for the current block) |
| nrSwitchTrials | Count of the number of switch trials run |
| nrRepetitionTrials | Count of the number of repetition trials run first trials in each test block are counted as neither |
| switchCat | 1 = same task (repetition trial); 0 = different task (switch trial) |
| previousTask | 1 = parity; 2 = magnitude |
| currentTask | 1 = parity; 2 = magnitude |
| digit | Stores the currently presented digit |
| stimulusItem | The presented stimuli in order of trial presentation |
| response | The participant's response (either mouse selection or scancode) |
| correct | The correctness of the response (1 = correct; 0 = incorrect) - if applicable |
| latency | The response latency (in ms) |
| choice | "HD" (high demand option) vs. "LD" (low demand option) |
| buttonHand | The hand on the response buttons (LEFT vs. RIGHT) |
| mouseHand | The hand on the mouse (LEFT vs. RIGHT) |
The procedure can be adjusted by setting the following parameters.
| Name | Description | Default |
|---|---|---|
| circleProportion | Proportion of canvas height used for the circle radius of stim presentation | 0.2 |
| digitSize | The size of the digit in percentage of canvas height | 5% |
| stimSize | The size of the stims in percentage of canvas height | 20% |