Return to the Attentional Cueing Procedure page
						
									ATTENTIONAL CUEING

SCRIPT INFO

Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 04-22-2013
last updated: 08-15-2016 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC

Copyright © 08-15-2016 Millisecond Software


BACKGROUND INFO

											*Purpose*
This script implements the Attentional Cueing Procedure as described in:

Koster,E.H.W, Crombez,G., Van Damme, S., Verschuere, B. & De Houwer, J. (2004). Does Imminent Threat Capture 
and Hold Attention? Emotion, 4, 312–317.


											  *Task*
Participants are asked to press a left or right key if they detect a small black square (=target) to the left or 
the right of a fixation cross. Cue stimuli (rectangles in two different colors) precede the presentation of the target
and predict in the majority of trials the location of the target. After a baseline in which the cues are
not paired with an aversive/neutral tone, the same task is presented in an acquisition stage in which
the cues predict the occurence of an aversive/neutral tone and take on the role of a CS+ (paired with aversive sound = UCS) 
or CS- (paired with neutral sound). The color of the CS+ is counterbalanced across participants.
After the acquisition stage participants rate to what extent 
a) the CS+ and CS- predicted the UCS, 
b) the UCS was perceived as aversive, and 
c) the UCS was feared.


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

(1) Raw data file: 'AttentionalCueing_raw*.iqdat' (a separate file for each participant)

build:							Inquisit build
computer.platform:				the platform the script was run on
date, time, subject, group:		date and time script was run with the current subject/groupnumber 
/condition:						1 = practice; 2 = baseline; 3 = prepare acquisition; 4 = acquisition_final stage
blockcode, blocknum:			the name and number of the current block
/sequence_index:				stores the listnumber of the chosen sequence
/nexttrial:						stores which trial to present next for baseline/acquisition
trialcode, trialnum: 			the name and number of the currently recorded trial
									(Note: not all trials that are run might record data) 
/reinforcement:					1 = reinforced trial;  0 = not reinforced
response:						the participant's response
correct:						the correctness of the response (1 = correct; 0 = error)
latency: 						the response latency (in ms)

Summary Variables:

/CS1valid_countcorr:			count correct responses in CS1 valid condition
/sumrt_CS1valid:				sum of the latencies of correct CS1 valid trials
etc. for all conditions

/catch_counterr:				counts error catch trials
/catch_countcorr:				counts correct catch trials
/sumrt_catch:					sums up latencies of ERROR catch trials

/B_CS1valid_countcorr:          stores the results for Baseline Condition= 0
/B_sumrt_CS1valid = 0
etc for all conditions 

/A_CS1valid_countcorr:			stores the results for Acquisition Stage
/A_sumrt_CS1valid = 0
etc for all conditions

Summary Variables:

/CS1valid_countcorr:					count correct responses in CS1 valid condition
/sumrt_CS1valid:						sum of the latencies of correct CS1 valid trials
etc. for all conditions

/catch_counterr:						counts error catch trials
/catch_countcorr:						counts correct catch trials
/sumrt_catch:							sums up latencies of ERROR catch trials

/B_CS1valid_countcorr:                  stores the results for Baseline Condition= 0
/B_sumrt_CS1valid = 0
etc for all conditions 

/A_CS1valid_countcorr:					stores the results for Acquisition Stage
/A_sumrt_CS1valid = 0
etc for all conditions


(2) Summary data file: 'AttentionalCueing_summary*.iqdat' (a separate file for each participant)

script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				subject id number
script.groupid:					group id number
script.elapsedtime:				time it took to run script (in ms)
computer.platform:				the platform the script was run on
/completed:						0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run)
* mean reaction times (only for correct trials) for CS1valid/CS1invalid/CS2valid/CS2invalid conditions
for B = Baseline Stage and A = Acquisition Stage
* error percentages for CS1valid/CS1invalid/CS2valid/CS2invalid conditions
for B = Baseline Stage and A = Acquisition Stage
* mean reactions for incorrect responses for catch trials 
for B = Baseline Stage and A = Acquisition Stage
* error percentages for catch trials for 
for B = Baseline Stage and A = Acquisition Stage

/CS1_effectivenessrating:				stores the rating of (0-10) of the effectiveness of CS+ to predict UCS
/CS2_effectivenessrating:				stores the rating of  (0-10) of the effectiveness of CS- to predict UCS
/UCS_aversive:							stores the rating (0-10) of the aversiveness of the UCS
/UCS_fear:								stores the rating (0-10) of the perceived fear of UCS


(2) EXPERIMENTAL SET-UP
8 experimental conditions: 2 validity of cue location (target in same/target in different location) x 2 locations (left, right) x 2 types of cues (CS+, CS-); tested within
Blocks:
1. Practice Block: 10 trials, randomly chosen from amongst the 8 experimental conditions, no sounds
2. Baseline: 54 trials (24 CS+, 24 CS-, 3 catch trials, 3 digit trials), no sounds
	=> 75% valid, 25% invalid trials (18 valid, 6 invalid trials for each CS), Koster et al (2004) 
	- 8 different experimental trials
			*fixation cross (500ms) -> cue (200ms)->about 14ms after offset of cue: targetpresentation (until response)
			(if paired with sound: 200ms after responding => sound is played for 200ms)
	- catch trials: cue presentation is not followed by a target and does not require a response (any positive
	response is scored as incorrect); if no response occurs trial times out after a set timeperiod (editable parameter)
	Koster et al (2004) did not report the trialduration of the catch trial.
	- digit trials: instead of a fixation cross, a digit is presented for 200ms; participants are asked to 
	say the digit out loud (by default: responses are NOT recorded); trial times out after a set timeperiod (editable parameter)

3. Acquisition: 
	a) presentation of 2 randomly chosen CS1 trials in which the cue is followed by UCS
	b) 108 trials (48 CS+, 48 CS-, 6 catch trials, 6 digit trials)
		=> 75% valid, 25% invalid trials (36 valid, 12 invalid for each CS)
		=> 75% of CS are followed by sound (e.g. 27 valid trials are followed by sound for each CS; 9 invalid trials are followed by sound for each CS)
4. Manipulation check (rating of: effectiveness of CS+; perceived aversiveness of UCS; perceived fear of UCS)


NOTE ON TRIAL ORDER:
Koster et al (2004) reported to have presented the experimental trials in a fixed random order
that was subject to the following constraints
- no more than 3 consecutive trials with cues of the same type
- no more than 3 consecutive trials in which the target location was the same

This script offers a pool of 20 random trial order sequences (for baseline/acquisition) that follow those
constraints. By default, this script randomly selects one of the sequences for each participant.
To use the same sequence for all participants, go to section LISTS and follow instructions.

!Note: catch trials in this script randomly choose either color, so there is the possibility
that catch trials can interfere with the "no more than 3 repeats of the same colored cue".

STIMULI:
Koster et al (2004) report specific cm dimensions of stimuli, such as distances of stimuli
to the fixation cross (9.2cm), sizes of display rectangles (6.5 x 4.8cm)* and target square (1.1cm) for
a 43cm monitor.
To fine tune those dimensions for your screen, please go to EDITABLE PARAMETERS and change
the corresponding values. The sizes used in this script are proportional to the screen size.

*the height/width of the rectangles reported in Koster et al (2004) may be swapped as the reported sizes 
(='landscape' rectangles) contradict the layout of the display rectangles displayed in Figure 1 (='portrait' format). 
This script uses a larger height than width ('portrait format') corresponding to the display in Figure 1.

the sounds used by this script are NOT original. For originals, please, contact Koster et al.
UCS: generated with Audacity, whitenoise, 200ms, amplitude 0.8
neutral: generated with Audacity, tone, 200ms, 1000Hz, amplitude 0.05

INSTRUCTIONS
The instructions used in this script are not originals. For originals, please, contact Koster et al.
Please fine-tune under EDITABLE CODE -> Editable Instructions

EDITABLE CODE:
check under EDITABLE CODE 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:

stimuli dimensions:
/fixationcross_height:						sets the height of the fixation cross in canvas height % (default: 10%)
/digit_height:								sets the height of the digits for the digit trials in canvas height % (default: 3%)
											
											Note: fine-tune the display rectangles/targets for your monitor
/rectangle_height:							sets the height of the display rectangle in canvas height % (default: 30%)
/rectangle_width:							sets the width of the display rectangle in canvas height % (default: 15%)
/targetsize:								sets the target size in canvas height % (default: 5%)

Coordinates of displays/targets:			Note: Fine tune coordinates for your monitor
/leftrectangle_x:							x-coordinate of the left display rectangle (default: 20%)
/rightrectangle_x:							x-coordinate of the right display rectangle (default: 80%)

/CS_color1:									sets the two colors (default: magenta, green)
/CS_color2:

Responsekeys:
/responsekey1								scancode of the left response key (default: 30)
/responsekey_label1							label of the left response key ("A")
/responsekey2:							   	scancode of the right response key (default: 38)
/responsekey_label2							label of the right response key ("L")

durations:
/sounddelay:								delay between response and playing of sounds in ms (default: 200ms)
/catchduration:								duration of the catch trial in ms (default: 1500ms)
/digitduration:								duration of the digit trial in ms (default: 1500ms)

Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Security Statement | Employment