___________________________________________________________________________________________________________________ ABCD ARROW FLANKER TEST - touchscreen input German Version (written for tablets) ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 03-28-2018 last updated: 06-14-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 06-14-2023 Millisecond Software Note: this script has been customized for the GENFI-NeuroDev Project under Dr. E. Finger (verbal instructions removed) Millisecond Software thanks Lisa Graf for generously sharing the German translations! ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements an short arrow version of the Flanker Test, an inhibition test to assess the ability to suppress inappropriate dominant responses evoked by task irrelevant information. The script was written for use on tablets (e.g. ipads). A version for smartphone use (e.g. remote testing) is also available through the Millisecond library. The implemented version is generously shared by the ABCD Consortium. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ Participants see 5 arrows in the middle of the screen inside a box. They have to decide whether the central arrow points right or left. The surrounding arrows (=flankers) either point in the same direction (congruent trials) or in the opposite direction (incongruent trials). ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes appr. 3 minutes to complete ___________________________________________________________________________________________________________________ DATA FILE INFORMATION ___________________________________________________________________________________________________________________ The default data stored in the data files are: (1) Raw data file: 'abcdarrowflankertest_tablet_raw*.iqdat' (a separate file for each participant) /testdate: the testdate information entered at the start of testing /id: the id entered at the start of testing /language: the selected language 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 script.sessionId: 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. values.practice: 0 = test block; 1 = practice block values.blockcount: counts the test blocks run values.countPracticeBlocks: counts the number of practice runs values.trialcount: counts all trials per block values.congruence: determines the state of the flankers 1 = congruent (target and flanker point in the same direction), 2 = incongruent (target points in opposite direction) values.selecttarget: itemnumber of the current target (center) stimulus 1 = target points to right; 2 = target points to left values.selectflanker: itemnumber of the current flanker stimuli response: the participant's response (leftresponsebutton, rightresponsebutton) correct: the correctness of the response (0 = error or no response; 1 = correct) latency: the response latency (in ms); measured from onset of target to response (or trial timeout) homeButton_RT: the response time to press the homeButton during trial.homeBase list.ACC_practice.mean: the current proportion correct at this point in practice values.practicePass: 1 = participant passed practice; 0 = participant did not pass practice (2) Summary data file: 'abcdarrowflankertest_tablet_summary*.iqdat' (a separate file for each participant) /testdate: the testdate information entered at the start of testing /id: the id entered at the start of testing /language: the selected language inquisit.version: the version of Inquisit computer.platform: the platform the script was run on (win/mac/ios/android) script.startDate: date script was run script.startTime: time script was started script.subjectId: assigned subject id number script.groupId: assigned group id number script.sessionId: assigned session id number script.elapsedTime: time it took to run script (in ms); measured from onset to offset of script script.completed: 0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run) values.blockcount: number of test blocks run values.countPracticeBlocks: counts the number of practice runs list.ACC_practice.mean: the proportion correct at the end of the last practice run values.practicePass: 1 = participant passed practice; 0 = participant did not pass practice expressions.TrialCount: overall trial count expressions.propcorrect: overall proportion correct (test trials only) expressions.meanrt: overall mean latency (in ms) of correct responses (test trials only) expressions.medianrt: overall median latency (in ms) of correct responses (test trials only) expressions.TrialCount_congruent: congruent trial count expressions.propcorrect_congruent: proportion correct for all congruent trials expressions.meanrt_congruent: mean latency (ms) of correct responses to congruent targets expressions.medianrt_congruent: median latency (ms) of correct responses to congruent targets expressions.TrialCount_incongruent: incongruent trial count expressions.propcorrect_incongruent: proportion correct for all incongruent trials expressions.meanrt_incongruent: mean latency (ms) of correct responses to incongruent targets expressions.medianrt_incongruent: median latency (ms) of correct responses to incongruent targets ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ 2 flanker congruence (congruent vs. incongruent), tested within 1-3 Practice Blocks: each block runs 4 trials with errorfeedback (number of trials can be edited under section Editable Parameters) - participants have to get 75% correct to move on to the test block (proportion correct editable under section Editable Parameters) - after 3 failed practice runs, all participants move on to the test - trial order is fixed; fixation star duration = 1250ms for each trial 1 Test Block: runs 20 trials in fixed sequence Trial Sequence: homeBase (waits for finger to press homeBase) -> presents fixation star for values.fixationDuration (1000, 1250, 1500ms) -> presents 'middle' text reminder (default: 100ms) -> presents flankers (default: 100ms) -> adds the target and waits for response Note: the selected response button is highlighted for 100ms -> homeBase for 800ms (whether pressed or not) ___________________________________________________________________________________________________________________ STIMULI ___________________________________________________________________________________________________________________ stimuli: 5 arrows pointing right or left (flanker, flanker, target, flanker, flanker) Arrows can be edited under section Editable Stimuli ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ Instructions are similar to the NIH toolbox Arrow Flanker Test. Instruction text 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: /targetDelay: the delay (in ms) of the target relative to onset of flankers (default: 100ms) /cueDuration: the duration (in ms) of the cue 'middle' reminder (default: 1000ms) /homeBaseReminder: the delay (in ms) of the home base reminder if finger is not returned to home base (default: 2000ms) /iti: the intertrial interval (in ms) (default: 800ms) /errorFeedbackDuration: the duration (in ms) of error feedback during practice (default: 5000ms) /correctFeedbackDuration: the duration (in ms) of correct feedback during practice (default: 2000ms) /minPracticeACC: the minimum proportion correct during a practice run that moves participant to the test (default: 0.75) /numberPracticeTrials: the number of practice trials per practice run (default: 4) Note: needs to be divisible by 4 /maxPracticeRuns: the maximum number of practice runs (default: 3) /numberTestTrials: the number of test trials run (default: 20) Note: needs to be divisible by 4