___________________________________________________________________________________________________________________ *Finger Tapping Task (Keyboard Input)* - used by the Behavioural Laterality Battery- ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 01-21-2021 last updated: 06-14-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 06-14-2023 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements a Finger Tapping Task similar to the one used by the Behavioural Laterality Battery (Parker et al, 2020). The Fingertapping Task assesses manual preference. Reference //Behavioural Laterality Battery: Adam J. Parker , Zoe V. J. Woodhead , Paul A. Thompson & Dorothy V. M. Bishop (2020): Assessing the reliability of an online behavioural laterality battery: A pre-registered study, Laterality, DOI: 10.1080/1357650X.2020.1859526 To link to this article: https://doi.org/10.1080/1357650X.2020.1859526 https://gorilla.sc/openmaterials/104636 ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ Participants are asked to press a specific key-sequence (e.g. TUMB) as often as possible during 30s. They are tested with their left and right hand (different key sequences) ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes appr. 10 minutes to complete ___________________________________________________________________________________________________________________ DATA OUTPUT DICTIONARY ___________________________________________________________________________________________________________________ The fields in the data files are: (1) Raw data file: 'blb_fingertappingtask_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. ///parameter settings: timeout: the block timeouts (in ms) numberOfRounds: the number of RH-LH rounds to run //Data: startHand: the first hand: RH vs. LH hand: the current hand: RH vs. LH countRounds: the round counter currentSequence: the currently tapped key-sequence at the end of the trial (Note: only stores correct button presses) correctSequence: the current correct response key sequence to tap countCompletedSequences: counts the number of sequences completed currentButton: the number (1-4) of the current button to be pressed (see response key assignment under section Editable Parameters) correctKey: the correct key to be pressed response: the participant's response (scancode of response button) responseText: the label of the response button pressed selectedButton: the number (1-4) of button that was selected by participant correct: accuracy of response: 1 = correct response (the correct button was pressed); 0 = one of the three currently incorrect response keys was pressed latency: the response latency (in ms) corrRT: stores the time (in ms) that it takes from one correct response to the next calculated as: the latency (in ms) of current correct response + previously stored values.incorrRT incorrRT: stores the sum of all incorrect response times (in ms) in between correct responses; resets with a correct response (2) Summary data file: 'blb_fingertappingtask_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) //parameter settings: timeout: the block timeouts (in ms) numberOfRounds: the number of RH-LH rounds to run //Data: /countRounds: the number of RH-LH rounds that were run /startHand: the first hand: RH vs. LH meanCompletedSequencesRH: mean number of completed sequences with the right hand (RH) for the number of complete rounds run meanCompletedSequencesLH: mean number of completed sequences with the left hand (LH) for the number of complete rounds run propCorrectRH: proportion correct taps for the right hand (across all RH blocks) propCorrectLH: proportion correct taps for the left hand (across all LH blocks) meanTappingRTRH: mean tapping latency (in ms) across all correct and incorrect taps for the right hand meanTappingCorrRTRH: mean tapping latency (in ms) for correct taps for the right hand Note: this is based on values.corrRT which measures the time intervals (in ms) inbetween correct responses meanTappingRTLH: mean tapping latency (in ms) across all correct and incorrect taps for the left hand meanTappingCorrRTLH: mean tapping latency (in ms) for correct taps for the left hand Note: this is based on values.corrRT which measures the time intervals (in ms) inbetween correct responses numberTapsRH: number of correct and incorrect taps for the right hand (across all RH blocks) numberCorrTapsRH: number of correct taps for the right hand (across all RH blocks) numberTapsLH: number of correct and incorrect taps for the left hand (across all LH blocks) numberCorrTapsLH: number of correct taps for the left hand (across all LH blocks) ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ This script runs 4 rounds of alternating RH-LH (LH-RH) blocks. The order depends on selected groupnumbers: odd groupnumbers: start with RH even groupnumbers: start with LH Participants hear a 'start' sound and see a timer appear on the screen. They then have 30s to type as many TUMB-sequences as they can with their right hand or type as many WRVX-sequences with their left hand (depends on block). Incorrect Responses* get recorded, but script 'waits' for a correct response to move ahead in the sequence. Example: T U U M B (counts as a completed sequence) *Incorrect Responses: by default => one of the three currently incorrected response keys was pressed Should all keys be potentially valid responses, go to trial.drumming and follow instructions for /validresponse ___________________________________________________________________________________________________________________ STIMULI ___________________________________________________________________________________________________________________ provided by Millisecond Software - can be edited under section Editable Stimuli ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ provided by Millisecond Software. The instructions are based on the ones used by the Behavioural Laterality Battery (Parker et al 2020). The instructions can edited in the provided htm-file as well as 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: