Return to the Short Child Flanker Test with Fish page
___________________________________________________________________________________________________________________	

								SHORT FISH FLANKER TEST - designed for touchscreens
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 03-28-2018
last updated:  11-04-2019 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 11-04-2019 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements an short fish version of the Flanker Test based on 
the NIH toolbox Fish Flanker Test used for children 3-6

http://www.healthmeasures.net/explore-measurement-systems/nih-toolbox/intro-to-nih-toolbox/cognition

The Inquisit Short Fish Flanker Test is designed to use on touchscreen devices but instructions
will adapt if no touchscreen is detected (in those cases the mouse is used instead)

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants see 5 fish in the middle of the screen inside a box. They have to decide whether the central fish 
points right or left. The surrounding fish (=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. 4 minutes to complete

___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________	
The default data stored in the data files are:

(1) Raw data file: 'shortfishflankertest_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
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.countPracticeBlocks:			counts the number of practice runs
values.blockcount:					number of blocks run
values.trialcount: 						counts all trials run 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)
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: 'shortfishflankertest_summary*.iqdat' (a separate file for each participant)

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:					Testblock Count																
values.countPracticeBlocks:			counts the number of practice runs
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
																
expressions.propcorrect:				overall proportion correct (test trials only) 
expressions.meanrt:					overall mean latency (in ms) of correct responses (test trials only)
									
expressions.propcorrect_congruent:  			proportion correct across congruent test trials 
expressions.meanrt_incongruent:				mean latency (in ms) of all correct-valid responses to congruent trials
expressions.propcorrect_incongruent:  			proportion correct across incongruent test trials 
expressions.meanrt_incongruent:				mean latency (in ms) of all correct-valid responses to incongruent trials

__________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
2 flanker congruence (congruent vs. incongruent), tested within

1-3 Practice Blocks: each block runs 4 trials with visual and audio 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)
- script is aborted after 3 unsuccessful practice runs (maximum number of practice runs editable under section Editable Parameters)

1 Test Block: runs 10 congruent (5 left, 5 right) and 10 incongruent trials (5 left, 5 right)
(number of trials can be edited under section Editable Parameters)

Trial Sequence:
-> iti (default: 2000ms): presents only the response buttons
-> presents fixation star for parameters.fixationDuration (default: 1000ms)
-> presents 'middle' text/audio reminder (default: 1000ms)
-> presents the target and flanker and waits for response (default: response Timeout = 1750ms) Note: the selected response button is highlighted for 100ms
-> homeBase

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
stimuli: 5 fish pointing right or left (flanker, flanker, target, flanker, flanker)
Fish can be edited under section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
Instructions are similar to the NIH toolbox Fish 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:

/fixationDuration:						the duration (in ms) of the star at the beginning of each trial (default: 1000ms)
/reminderDuration:					the duration (in ms) of the 'middle' reminder (default: 1000ms)
											Note: the duration of the audio file is about 450ms.
/responseTimeout:					the response Timeout (ms); measured from onset of fish (default: 1750ms)
											Note: to allow for infinite response time, remove /response = timeout(parameters.responseTimeout)
											from all relevant trials
/errorFeedbackDuration:				the duration (in ms) of error feedback during practice (default: 5000ms)
/correctFeedbackDuration:				the duration (in ms) of correct feedback during practice (default: 2000ms)
/iti:									intertrial interval (in ms): trial only represents the response button (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
Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Privacy Statement | Security Statement | GDPR
Website Security Test