User Manual: Inquisit Behavioural Laterality Battery Finger Tapping Task


___________________________________________________________________________________________________________________	

										*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:  02-22-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-22-2022 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 FILE INFORMATION 
___________________________________________________________________________________________________________________		
The default data stored 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		
count_completedSequences:			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	

meanCompletedSequences_RH:	mean number of completed sequences with the right hand (RH) for the number of complete rounds run
meanCompletedSequences_LH:	mean number of completed sequences with the left hand (LH) for the number of complete rounds run	

propCorrect_RH:				proportion correct taps for the right hand (across all RH blocks)
propCorrect_LH:				proportion correct taps for the left hand (across all LH blocks)

meanTappingRT_RH:			mean tapping latency (in ms) across all correct and incorrect taps for the right hand

meanTappingCorrRT_RH:		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

meanTappingRT_LH:			mean tapping latency (in ms) across all correct and incorrect taps for the left hand

meanTappingCorrRT_LH:		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
										
									
numberTaps_RH:				number of correct and incorrect taps for the right hand (across all RH blocks)
numberCorrTaps_RH:			number of correct taps for the right hand (across all RH blocks)
numberTaps_LH:				number of correct and incorrect taps for the left hand (across all LH blocks)
numberCorrTaps_LH:			number of correct taps for the left hand (across all LH blocks)
						
* 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 
___________________________________________________________________________________________________________________	

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: