___________________________________________________________________________________________________________________ *SCREEN REQUIREMENT TESTING SCRIPT* ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 03-17-2020 last updated: 08-09-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements script that tests screen requirements for the ABCD remote testing sessions. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ This script checks basic requirements of testing devices (smart phone sizes) and presents general instructions for remote testing. ___________________________________________________________________________________________________________________ DATA OUTPUT DICTIONARY ___________________________________________________________________________________________________________________ The fields in the data files are: (1) Raw data file: 'remotetesting_instructions_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) information about the current screen size: screenWidthMM: screenHeightMM: 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. stimulusItem: the presented stimuli in order of trial presentation response: the participant's response (scancode of response buttons) correct: accuracy of response: 1 = correct response; 0 = otherwise latency: the response latency (in ms) (2) Summary data file: 'remotetesting_instructions_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) information about the current screen size: screenWidthMM: screenHeightMM: 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) ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ The script first checks if platform and screen size requirements are met. If they are not met, the script and entire batch is aborted. Otherwise, general instructions for remote testing are presented. ___________________________________________________________________________________________________________________ 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: /minimumScreenHeightMM: the minimum screen height required in mm (default: ) /minimumScreenWidthMM: the minimum screen width required in mm (default: ) /maximumScreenHeightMM: the maximum screen height allowed in mm (default: ) /maximumScreenWidthMM: the maximum screen width allowed in mm (default: ) Note: currently the script allows any kind of screen size /testSetting: = "remote" (should not change) ___________________________________________________________________________________________________________________ *ABCD Little Man Test* (Smart Phone Version) ___________________________________________________________________________________________________________________ SCRIPT INFO Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 08-24-2017 last updated: 04-02-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 04-02-2024 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script was programmed for and made available by the ABCD Research Consortium. This script implements a mental rotation task for children. Originally the task was programmed for ipads for inperson testing. This current version was updated/optimized for ABCD for running on smart phones to use for remote testing. It can be run on its own or in conjunction with script 'remotetesting_instructions.iqjs'. 'remotetesting_instructions.iqjs': script that tests that the screen sizing roughly fits a smart phone. The combined sequence is run by script 'batch.iqjs' A tablet version optimized for inperson testing is also available in the Millisecond Software library. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ Participants are presented figures that carry a suitcase in either the left or right hand. Figures can show their front or back and can be right side up or up side down. Participants work through 4 practice problems with the test administrator before working on 32 problems on their own. ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes appr. 5 minutes to complete ___________________________________________________________________________________________________________________ DATA OUTPUT DICTIONARY ___________________________________________________________________________________________________________________ The fields in the data files are: (1) Raw data file: 'littlemantest_smartphone_raw*.iqdat' (a separate file for each participant)* build: Inquisit build computer.platform: the platform the script was run on (win/mac/ios/android) information about the current screen size: expressions.screenWidthMM: expressions.screenHeightMM: date, time, subject, group, session: date and time script was run with the current subject/groupnumber/session number blockCode, blockNum: the name and number of the current block trialCode, trialNum: the name and number of the currently recorded trial (Note: not all trials that are run might record data; by default data is collected unless /recorddata = false is set for a particular trial/block) lmtStimulusXx: stores the currently presented image file lmtStimulusTypeXx: 1 Backward Down Left 2 Backward Down Right 3 Backward Up Left 4 Backward Up Right 5 Forward Down Left 6 Forward Down Right 7 Forward Up Left 8 Forward Up Right lmtCorrectButtonXx: stores the correct location of the suitcase: 0 = left; 1 = right response: stores the response button pressed: "leftbutton" vs. "rightbutton" vs. 0 => no response (Inquisit default response variable) lmtButtonPressedXx: stores the response button pressed: 0 = "left"; 1 = "right"; or "timedout" (custom response variable) lmtCorrectXx: accuracy of response: 1 = correct response; 0 = otherwise (wrong selection or timeout) lmRTXx: the response latency (in ms); measured from: onset of images until response or timeout Note: timeout latencies are stored as -1 homeButtonRT: the time (in ms) that it took to press the green home Button during trial.ITI (2) Summary data file: 'littlemantest_smartphone_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) information about the current screen size: expressions.screenWidthMM: expressions.screenHeightMM: 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) lmtScrAssessDate: currently simply stores the script.startDate (the local time is stored under script.startTime) lmtScrPropCorrect: proportion of correct responses lmtScrNumCorrect: absolute number of correct responses lmtScrNumWrong: absolute number of (active) error responses lmtScrNumTimedOut: absolute number of timeout (passive) errors. lmtScrAvgRT: average response time of correct and incorrect selections Note: timeouts latencies are excluded from this variable lmtScrRTCorrect: average only correct RT; calculation (Mean latency for correct =1) lmtScrRTWrong: average only wrong RT (= latencies of incorrect selections); Note (KB): timeout errors are excluded lmtScrEfficiency: Accuracy/ Reaction Time; calculation (lmt_src_prop_correct/lmtScr_rt_correct) lmtStimType1CorrectRT- lmtStimType8CorrectRT: latency of correct selections by stimulus type (1-8) lmtStimType1NumCorrect- lmtStimType8NumCorrect: number of correct selections by stimulus type (1-8) lmtStimType1WrongRT- lmtStimType8WrongRT: latency of error selections by stimulus type (1-8) lmtStimType1NumWrong- lmtStimType8NumWrong: number of error selections by stimulus type (1-8) lmtStimType1NumTimedOut- lmtStimType8NumTimedOut: number of timed-out selection trials by stimulus type (1-8) ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP - 1 demo problem (if incorrect, it can be repeated as often as necessary); no response deadline - 3 additional practice problems - demo and practice problems are presented in a fixed order - 32 test problems (presented in fixed order) Trial Sequence: homebutton needs to be pressed (changes color from white to gray) -> ITI: 1500ms -> stim (until response or timeout at 5s) -> Note: practice trials The error feedback is presented for at least 1000ms regardless of whether the home button is pressed beforehand or not. ITI is started only if the home button was pressed. ___________________________________________________________________________________________________________________ STIMULI ___________________________________________________________________________________________________________________ provided by ABCD Consortium, see section Editable Stimuli ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ provided by ABCD Consortium, see 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: /picSize: the proportional size of the little man images (default: 60%) /responseButtonSize: the proportional size of the response buttons (default: 8%) /iti: the duration (in ms) of the intertrial interval (default: 1500ms) /readyDuration: the duration (in ms) of the ready trial (default: 3000ms) /responseDeadline: a response deadline in ms (default: 5000ms)