___________________________________________________________________________________________________________________ VISUAL SEARCH ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 01-24-2014 last updated: 10-31-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 10-31-2023 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements a Visual Search paradigm used in a 'Threat' context. Reference: Becker. M.W. (2009). Panic Search: Fear Produces Efficient Visual Search for Nonthreatening Objects. Psychological Science, 20, 435-437. Note: this script runs with placeholder stimuli ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ After the presentation of one of three cue types (happy, fearful, neutral) participants are presented a search screen with 3, 6 or 9 pictures randomly arranged in a circle and are asked to indicate as fast as possible whether a target picture (e.g. picture of a house) is present or not. ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes appr. 22 minutes to complete ___________________________________________________________________________________________________________________ DATA OUTPUT DICTIONARY ___________________________________________________________________________________________________________________ The fields in the data files are: (1) Raw data file: 'visualsearch_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 such as feedback trials. Thus, trialNum may not reflect the number of main trials run per block. cueCondition: 1 = happy, 2= fearful, 3 = neutral trialType: targetpresent vs. targetAbsent setSize: stores current setSize cueItem: stores the current cue target: stores the current target item response: the participant's response (scancode of response button) reponseKey: the translated response scancode responseType: Hit, Miss, FA (False Alarm), CR (Correct Rejection) correct: the correctness of the response (1 = correct; 0 = otherwise) latency: the response latency in ms; measured from onset of images stimuliLocations: stores the distractor/target itemnumbers and their circle positions (position 1 => 12 o'clock position, then clockwise) (2) Summary data file: 'visualsearch_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) propCorrectOverall: proportion correct across all test trials meanRTOverall: mean correct latency (in ms) across all test trials propCorrectCue1: proportion correct across all cue1 test trials meanRTCue1: mean correct latency (in ms) across all cue1 test trials propCorrectCue2: proportion correct across all cue2 test trials meanRTCue2: mean correct latency (in ms) across all cue2 test trials propCorrectCue3: proportion correct across all cue3 test trials meanRTCue3: mean correct latency (in ms) across all cue3 test trials ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ Design: 3 cue types (happy, fearful, neutral) x 3 set sizes (3, 6, 9) x 2 trialTypes (target present vs. target absent), tested within By default, the 3 cue types are run in a blocked design with 108 trials each (Becker, 2009) => 18 trials per setSize x trialType condition The order of the blocks is counterbalanced by groupnumber (see EXPERIMENT). Set size, trialType, and distribution of distractors/targets are randomized within each block. cues: randomly sampled (without replacement) from 6 possible pictures per cue type; after 6 random drawings the pool resets. targets: randomly sampled (without replacement) from 38 targets (default); after 38 random drawings the pool resets. distractors: randomly sampled (without replacement) from 46 distractors (default); after 46 random drawings the pool resets. Practice: this script offers a practice block of parameters.practiceTrials trials (default: 10). It runs parameters.practiceTrials in a mixed design and provides error feedback. NOTE: In this script, the task could also be run in a mixed design by setting parameters.blockedCues = false (section Editable Parameters) ___________________________________________________________________________________________________________________ STIMULI ___________________________________________________________________________________________________________________ This script runs with PLACEHOLDER STIMULI. Insert your stimuli under item.cue1/item.cue2/item.cue3 and item.distractors and item.targets. Targets and distractors are arranged in a circle with 9 possible positions. To fine tune presentation of the distractor/target display circle on different monitors, check section Editable Parameters -> parameters.pictureHeight/parameters.radiusScreenProportion ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ Instructions are provided by Millisecond Software and are not original to Becker (2009). They can be easily 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: responseKeys: /responseKeyTargetPresent: the target present responseKey (default: "Y"), the left response key /responseKeyTargetAbsent: the target absent responseKey (default: "N"), the right response key /blockedCues: true: the three cue types are run in a blocked design (default -> Becker, 2009) false: the three cue types are run in a mixed design /trialNumber: the number of visual searches per block /fontSize: the font height (percentage of canvas height) of the Ready cue (default: 10%) /fontSizeFixation: the font height (percentage of canvas height) of the fixation cross (default: 5%) /cueHeight: the height of the cue picture (percentage of canvas height) (default: 30%) Note: fine-tune display of target/distractor circle by editing these parameters below: /pictureHeight: the height of the target/distractor pictures (percentage of canvas height) (default: 15%) /radiusScreenProportion: the radius of the circle proportional to canvas height (default: 0.4) Duration Parameters: /readyDuration: duration of ready hint in ms (default: 750ms) /cueDuration: duration of cues in ms (default: 300ms) /fixationDuration: duration of fixation cross in ms (default: 600ms)