___________________________________________________________________________________________________________________
Identification test
- choice reaction time task for the touchscreen-
___________________________________________________________________________________________________________________
Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 04-18-2022
last updated: 04-10-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC
Script Copyright © 04-10-2024 Millisecond Software
___________________________________________________________________________________________________________________
BACKGROUND INFO
___________________________________________________________________________________________________________________
This script implements a choice reaction time ('identification task') as a measure of psychomotor function
and attention.
The task uses playing cards as targets and is developed for touchscreens but will adapt to
mouse use on non-touchscreens.
Researchers can select to run the task with an absolute screen size to ensure that distances
stay the same across devices. The default settings are optimized for ipad touchscreens.
See section Editable Parameters for more info.
/////References for similar Identification Tasks:////
Maruff P, Thomas E, Cysique L, Brew B, Collie A, Snyder P, Pietrzak RH. Validity of the CogState brief battery:
relationship to standardized tests and sensitivity to cognitive impairment in mild traumatic brain injury,
schizophrenia, and AIDS dementia complex. Arch Clin Neuropsychol.
2009 Mar;24(2):165-78. doi: 10.1093/arclin/acp010. Epub 2009 Mar 25. PMID: 19395350.
___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________
Participants get presented with a deck of cards consisting of red jokers and black jokers.
The cards are turned over one by one with randomly selected delays.
Once a joker card is turned over, participants are instructed to press a YES response button as quickly as possible
IF the uncovered joker is a red joker. In any other case (that is for black jokers) they should press the NO
response button.
Once the response is made, an animation is started that 'returns' the card back to the stack.
The next trial is initiated once participants press a 'Home Button'. The 'Home Button' is implemented
to ensure that response fingers are roughly equally distanced from the response buttons for each trial.
___________________________________________________________________________________________________________________
DURATION
___________________________________________________________________________________________________________________
the default set-up of the script takes appr. 3 minutes to complete
___________________________________________________________________________________________________________________
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:
(1) Raw data file: 'ms_onecardlearningtest_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: with the current subject id
group: with the current group id
session: with the current session id
//Play Setup:
(parameter) runAbsoluteSizes: true (1) = should run absolutely sized canvas (see parameters- canvasHeightMM)
false (0) = should use proportionally sized canvas (uses width = 43*screenHeight)
canvasAdjustments: NA: not applicable => parameters- runAbsoluteSize was set to 'false'
0: parameters- runAbsoluteSize was set to 'true' and screen size was large enough
1: parameters- runAbsoluteSize was set to 'true' BUT screen size was too small and
adjustments had to be made
playAreaHeightMM: the width of the play area in mm
playAreaWidthMM: the height of the play area in mm
display.canvasHeight: the height of the active canvas ('playarea') in pixels
display.canvasWidth: the width of the active canvas ('playarea') in pixels
pxPerMM: the conversion factor to convert pixel data into mm-results for the current monitor
(Note: the higher resolution of the current monitor
the more pixels cover the same absolute screen distance)
This factor is needed if you want to convert pixel data into absolute mm data or the other way around
distanceHomeButtonResponseButtonMM: the calculated distance (in mm) between center of homeButton and center of one of the response buttons
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.
cardItemNumber: the itemnumber of the currently presented card
card: the filename of the currently presented card
delay: the current delay (in ms)
corrRsp: the correct response for the current card ("yes" or "no")
//Built-in DVs
response: the response of participant (button pressed)
By design, this script will store the FINAL (corrected) response
correct: correctness of response (1 = correct, 0 = error)
By design, 'correct' refers to the FIRST response made (see values.firstResponse)
latency: response latency (in ms); measured from: onset of card (NOT from last response)
until FINAL (corrected) response
(2) Summary data file: 'ms_onecardlearningtest_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)
//Play Setup:
(parameter) runAbsoluteSizes: true (1) = should run absolutely sized canvas (see parameters- canvasHeightMM)
false (0) = should use proportionally sized canvas (uses width = 43*screenHeight)
canvasAdjustments: NA: not applicable => parameters- runAbsoluteSize was set to 'false'
0: parameters- runAbsoluteSize was set to 'true' and screen size was large enough
1: parameters- runAbsoluteSize was set to 'true' BUT screen size was too small and
adjustments had to be made
playAreaHeightMM: the width of the play area in mm
playAreaWidthMM: the height of the play area in mm
display.canvasHeight: the height of the active canvas ('playarea') in pixels
display.canvasWidth: the width of the active canvas ('playarea') in pixels
pxPerMM: the conversion factor to convert pixel data into mm-results for the current monitor
(Note: the higher resolution of the current monitor
the more pixels cover the same absolute screen distance)
This factor is needed if you want to convert pixel data into absolute mm data or the other way around
distanceHomeButtonResponseButtonMM: the calculated distance (in mm) between center of homeButton and center of one of the response buttons
//accuracy:
propCorrect: proportion correct responses (across target and nontarget trials)
//reaction time data (response time measured relative to target onset)
//across correct and incorrect responses
meanRT: mean response time (in ms)
sdRT: standard deviation of response times (in ms)
medianRT: median response time (in ms)
minRT: minimum response time (in ms)
maxRT: maximum response time (in ms)
//reaction time data (response time measured relative to target onset)
//across correct responses
meanCorrRT: mean response time (in ms)
sdCorrRT: standard deviation of response times (in ms)
medianCorrRT: median response time (in ms)
minCorrRT: minimum response time (in ms)
maxCorrRT: maximum response time (in ms)
//reaction time data (response time measured relative to target onset)
//across incorrect responses
meanIncorrRT: mean response time (in ms)
sdIncorrRT: standard deviation of response times (in ms)
medianIncorrRT: median response time (in ms)
minIncorrRT: minimum response time (in ms)
maxIncorrRT: maximum response time (in ms)
//delay data
meanDelay: mean delay time (in ms)
sdDelay: standard deviation of delay times (in ms)
medianDelay: median delay time (in ms)
minDelay: minimum delay time (in ms)
maxDelay: maximum delay time (in ms)
___________________________________________________________________________________________________________________
EXPERIMENTAL SET-UP
___________________________________________________________________________________________________________________
Test: by default this script runs 1 testblock (Editable Parameter) with 30 trials each (Editable Parameter)
using the same two (red and black) joker cards. By default, half the uncovered jokers are red joker targets
(Editable Parameter). The script randomly samples a joker delay from 500-5000ms (Editable Parameter)
The script provides a brief resttrial (self-paced) after each block.
Trial Information:
-> each trial starts with a HomeButton press (reminder presented after 2s)
-> pressing the home button starts the delay period
(if the home button is released during this time for more than 250ms, participants
are asked to return to the home button and a new iti is randomly selected)
-> after the delay period is over, the joker card is turned over,
and the script waits for response (there is no time limit for making a response)
-> card animation for 1000ms
(if the home button is pressed at the end of the card animation, the next trial starts immediately
with the delay period)
___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited 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:
