Demand Selection Task

Technical Manual

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

Background

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)

Duration

50 minutes

Description

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

Procedure

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)

Stimuli

provided by Millisecond (stimuli are not original to Kool et al, 2010)
They can be edited under section Editable Stimuli

Instructions

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.

Summary Data

File Name: demandselectiontask_summary*.iqdat

Data Fields

NameDescription
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

Raw Data

File Name: demandselectiontask_raw*.iqdat

Data Fields

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

Parameters

The procedure can be adjusted by setting the following parameters.

NameDescriptionDefault
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%