___________________________________________________________________________________________________________________ NUMBER-LETTER TASK: category switch task with alternating runs ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 11-21-2017 last updated: 02-25-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 02-25-2022 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements the Number-Letter task (category switch task), an executive function task. The implemented procedure is based on: Miyake, A., Friedman, N. P., Emerson, M. J., Witzki, A. H., Howerter, A., & Wager, T. D. (2000). The unity and diversity of executive functions and their contributions to complex “frontal lobe” tasks: A latent variable analysis. Cognitive Psychology, 41, 49–100. The Letter-Number Task is a simplified version of the alternating runs switch task by: Rogers, R. D., & Monsell, S. (1995). The costs of a predictable switch between simple cognitive tasks. Journal of Experimental Psychology: General, 124, 207–231. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ This task switching task uses two simple categorization tasks and predictably alternates btw. the two by using a clockwise rotation of stimulus presentation in a 2x2 matrix as the predictable location cues: A 2 x 2 matrix is presented on screen. A pair of characters (e.g. '2F') appears in one of the matrix fields. For each new trial, the presented pair of characters moves in clockwise fashion to the next box, so that it is always predictable where the next character pair will appear. The task that needs to be performed depends on the box the character pair appears in (= location cue). Two tasks: Task A: letter task: "If one of the characters is a consonant press, key E. If one of the characters is a consonant, press key I" Task B: digit task: "If one of the characters is an even digit press, key E. If one of the characters is an odd digit, press key I" Each character pair consists of of a target character (depends on the target task) and a distractor character. The distractor character always comes from the opposite task. Example: Participant has to perform the letter task every time the character pair appears in the top quadrants of the matrix and has to perform the digit task every time the character pair appears in the bottom quadrants of the matrix (this quadrant-task assignment can be set by experimenter). Letter Task: the character pair consists of of a target letter (e.g. 'G') and a distractor digit (e.g. '2') Digit Task: the character pair consists of of a target digit (e.g. '3') and a distractor letter (e.g. 'A') Because the presentation of the character pairs moves predictably in a clockwise fashion, every odd trial during the combined block is a 'switch task' trial and every even trial is a 'nonswitch task' trial. ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes appr. 8 minutes to complete __________________________________________________________________________________________________________________ DATA FILE INFORMATION ___________________________________________________________________________________________________________________ The default data stored in the data files are: (1) Raw data file: 'numberlettertask_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. countCombinedPracticeBlocks: counts the number of combined practice blocks run parameters- quadrantTaskAssignment: 1 = top quadrants: letter task; bottom quadrants: digit task symbols appearing in quadrant 1 (top, left) and quadrant 2 (top, right) => do letter task, symbols appearing in quadrant 3 (bottom, right) and quadrant 4 (bottom, left) => do digit task 2 = top quadrants: digit task; bottom quadrants: letter task symbols appearing in quadrant 1 (top, left) and quadrant 2 (top, right) => do digit task, symbols appearing in quadrant 3 (bottom, right) and quadrant 4 (bottom, left) => do letter task 3 = left quadrants: letter task; right quadrants: digit task symbols appearing in quadrant 1 (top, left) and quadrant 4 (bottom, left) => do letter task symbols appearing in quadrant 2 (top, left) and quadrant 3 (bottom, left) => do digit task 4 = left quadrants: digit task; right quadrants: letter task symbols appearing in quadrant 1 (top, left) and quadrant 4 (bottom, left) => do digit task symbols appearing in quadrant 2 (top, left) and quadrant 3 (bottom, left) => do letter task congruentTasks: stores the currently congruent tasks (based on key assignment) "consonant-even; vowel-odd" vs. "consonant-odd; vowel-even"; switch: 0 = non-switch trial (even trials); (relevant for combined trials only) 1 = switch trials (odd trials) quadrant: 1 = top, left; 2 = top, right; 3 = bottom, right; 4 = bottom, left (clockwise) targetTask: stores the task to be performed: "letter task" vs. "digit task" targetCategory: "CONSONANT" vs. "VOWEL" vs. "ODD" vs. "EVEN" targetSymbol: stores the current target symbol (either the target consonant, target vowel, target even number, target odd number) distractorSymbol: stores the current distractor symbol targetPair: stores the currently presented combined pair of target symbol and distractor symbol congruence: 1 = target symbol and distractor symbol share the same key 2 = target symbol and distractor symbol require opposite keys stimulusitem: the presented stimuli in order of trial presentation response: the participant's response (scancode of response button: 18 = E; 23 = I) correct: accuracy of response: 1 = correct response; 0 = otherwise latency: the response latency (in ms); measured from: onset of symbol pair (2) Summary data file: 'numberlettertask_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) parameters- quadrantTaskAssignment: 1 = top quadrants: letter task; bottom quadrants: digit task symbols appearing in quadrant 1 (top, left) and quadrant 2 (top, right) => do letter task, symbols appearing in quadrant 3 (bottom, right) and quadrant 4 (bottom, left) => do digit task 2 = top quadrants: digit task; bottom quadrants: letter task symbols appearing in quadrant 1 (top, left) and quadrant 2 (top, right) => do digit task, symbols appearing in quadrant 3 (bottom, right) and quadrant 4 (bottom, left) => do letter task 3 = left quadrants: letter task; right quadrants: digit task symbols appearing in quadrant 1 (top, left) and quadrant 4 (bottom, left) => do letter task symbols appearing in quadrant 2 (top, left) and quadrant 3 (bottom, left) => do digit task 4 = left quadrants: digit task; right quadrants: letter task symbols appearing in quadrant 1 (top, left) and quadrant 4 (bottom, left) => do digit task symbols appearing in quadrant 2 (top, left) and quadrant 3 (bottom, left) => do letter task congruentTasks: stores the currently congruent tasks (based on key assignment) "consonant-even; vowel-odd" vs. "consonant-odd; vowel-even"; prematureEnd: 1 = last combined practice performance was too low and script aborted prematurely 0 = last combined practice performance >= parameters- minCombinedPracticeACC countCombinedPracticeBlocks: number of combined practice blocks of 16 trials run until performace >= parameters- minCombinedPracticeACC OR max number of practice blocks was run ACC_combinedPractice: proportion correct during last combined practice blocks run Note: trials with latencies < 100ms are excluded from summary variables count_switch: number of switch trial responses qualified for summary variables propCorrect_switch: proportion of correct switch trials count_nonswitch: number of nonswitch trial responses qualified for summary variables propCorrect_nonswitch: proportion of correct nonswitch trials ACC_SwitchCost: accuracy switchcosts (difference btw. proportion correct of switch trials and nonswitch trials) => negative value: participants were less accurate on switch trials (there was an accuracy cost to switching ) meanRT_switch: mean latency of correctly responding to a switch trial meanRT_nonswitch: mean latency of correctly responding to a nonswitch trial RT_SwitchCost: latency switchcosts difference btw. mean correct latency of switch trials and nonswitch trials) => positive value: participants were slower on switch trials (there was a latency cost to switching) propExcluded: proportion excluded (from summary variables) trials across all combined trials (excluded because of no responses or because latency < 100ms) * separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section "DATA" and follow further instructions ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ (1) Practice: individual task practice * 1 block of Letter Task, 1 block of Number Task (order is randomized) * Letter Task (32 trials): * 16 Consonant trials (consonants are selected randomly with replacement. Constraint: no immediate re-use of the same consonant) * half the consonants are paired with odd numbers, half are paired with even numbers * 16 Vowel trials (vowels are selected randomly with replacement. Constraint: no immediate re-use of the same vowel) * half the vowels are paired with odd numbers, half are paired with even numbers * Number Task (32 trials): * 16 Odd trials (odd numbers are selected randomly with replacement. Constraint: no immediate re-use of the same odd number) * half the odd numbers are paired with consonants, half are paired with vowels * 16 Even trials (even numbers are selected randomly with replacement. Constraint: no immediate re-use of the same even number) * half the even numbers are paired with consonants, half are paired with vowels * Key-Reminder are on screen for the first 8 trials of each practice block (2) Test: combined task (A) Combined Practice: 16 trials (if more or fewer practice trials should be run, change block.combinedTaskPractice) * if proportion correct during the practice block < parameters.minCombinedPractice ACC (default = 0.8), then the practice blocks gets repeated. Once paramaters.maxCombinedPracticeBlocks (default: 10) have run with proportion correct during the practice block < parameters.minCombinedPractice ACC, the script aborts prematurely. * trial set up is similar to test trials with the following differences: - if a mistake is made during the combined practice trials, a task and key reminder is presented and participants have to correct their incorrect response to move along - targetCategory as well as congruence is sampled randomly (B) Combined Test: (128 trials) * Block Start: depending on values.quadrantTaskAssignment (1, 2, 3, 4) the first quadrant position is randomly determined (randomly WITH replacement) (and with it the first task is randomly determined) Example: values.quadrantTaskAssignment = 1 (top quadrants = letter task; bottom quadrants = digit task) => the first selected quadrant is randomly selected to be either 1 (top left), or 3 (bottom right) => if start quadrant is 1: starting task is letter task => task sequence: AABBAABBAABB...AABB => if start quadrant is 3: starting task is digit task => task sequence: BBAABBAABBAA...BBAA * quadrant changes clockwise from one trial to the next: 1 = top left; 2 = top, right; 3 = bottom, right; 4 = bottom, left * the task to be performed (letter task vs. digit task) depends on the quadrant * if letter task: half the trials select consonants; half select vowels * if digit task: half the trials select even numbers; half select odd numbers * consonants, vowels, even digits, odd digits, control symbols are selected randomly WITH replacement (constraint: the same consonant (vowel, even digit, odd digit, control symbol) canNOT be selected during the next drawing from the same list) * the placement in the pair presented ('7R' vs. 'R7') is randomly determined * Trials: 64 switch trials, 64 non-switch trials * 64 switch trials => 32 switch trials for letter (number) task => 16 consonant (vowel, even, odd) trials => 8 congruent/ 8 incongruent consonant (vowel, even, odd) trials (congruent = response buttons are the same for the target and distractor letter) Trial Information: target pair presentation-> correct response/timeout: ITI of 150ms; incorrect response: ITI of 1500ms (with errorfeedback) ___________________________________________________________________________________________________________________ STIMULI ___________________________________________________________________________________________________________________ vowels: "A", "E", "I", "U" (see list.vowels under section Editable Stimuli) consonants: "G", "K", "M", "R" (see list.consonants under section Editable Stimuli) odd: "3", "5", "7", "9" (see list.odd under section Editable Stimuli) even: "2", "4", "6", "8" (see list.even under section Editable Stimuli) ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ provided by Millisecond Software - 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: /quadrantTaskAssignmnent: 1 = top quadrants:letter task; bottom quadrants: digit task symbols appearing in quadrant 1 (top, left) and quadrant 2 (top, right) => do letter task, symbols appearing in quadrant 3 (bottom, right) and quadrant 4 (bottom, left) => do digit task 2 = top quadrants: digit task; bottom quadrants: letter task symbols appearing in quadrant 1 (top, left) and quadrant 2 (top, right) => do digit task, symbols appearing in quadrant 3 (bottom, right) and quadrant 4 (bottom, left) => do letter task 3 = left quadrants: letter task; right quadrants: digit task symbols appearing in quadrant 1 (top, left) and quadrant 4 (bottom, left) => do letter task symbols appearing in quadrant 2 (top, left) and quadrant 3 (bottom, left) => do digit task 4 = left quadrants: digit task; right quadrants: letter task symbols appearing in quadrant 1 (top, left) and quadrant 4 (bottom, left) => do digit task symbols appearing in quadrant 2 (top, left) and quadrant 3 (bottom, left) => do letter task Key Assignments: the default assignments align consonants and even digits/vowels and odd digits /leftKey: the left response button (default: "E") /rightKey: the right response button (default: "I") /consonantKey: the key assigned for consonants (default: parameters.leftKey) /vowelKey: the key assigned for vowels (default: parameters.rightKey) /evenKey: the key assigned for even digits (default: parameters.leftKey) /oddKey: the key assigned for odd digits (default: parameters.rightKey) Stimuli Sizing /quadrantSize: the size of one of the box quadrants proportional to canvas height (default: 25%) /targetSize: the height of the symbol pairs proportional to canvas height (default: 5%) Timing Parameters: /readyDuration: the duration (in ms) of the 'get-ready' trial (default: 2000ms) /correctITI: the duration (in ms) of the intertrial interval if response was correct (default: 150ms) /errorITI: the duration (in ms) of the intertrial interval if response was incorrect (default: 1500ms) /blockstartDuration: the duration (in ms) of the highlighted box at the start of a new block (default: 2000ms) For Summary Variables /minRT: trials in which participant respond with latency < minRT are excluded from summary variables (default: 100ms) /minCombinedPracticeACC: minimum performance (proportion correct) during last combined practice block to move on to actual test. If performance during last combined practice block is lower than parameters.minCombinedPracticeACC, combined practice block gets repeated (default: 0.8 => max. number of errors = 3 => 13correct trials/16 practice trials = 0.8125) /maxCombinedPracticeBlocks: maximum number of combined practice blocks run. If practice performance is still < minCombinedPracticeACC after the last block, then script aborts prematurely (default: 10)