User Manual: Inquisit Self-Esteem Matrix Task


___________________________________________________________________________________________________________________	

								*** Self-Esteem Matrix Task ***
								*** Attentional bias re-training***
								*** ABMT - attentional bias modification task***
								*** Visual search attentional training task ****
								
								BATCH SCRIPT
___________________________________________________________________________________________________________________	

//Note: this batch file can be run to counterbalance the stimuli selection (experimental vs. control) 
of the Inquisit sematrixtask task:
-> odd groupnumbers run experimental stimuli
-> even groupnumbers run control stimuli 



___________________________________________________________________________________________________________________	

								*** Self-Esteem Matrix Task ***
								*** Attentional bias re-training***
								*** ABMT - attentional bias modification task***
								*** Visual search attentional training task ****
___________________________________________________________________________________________________________________	

Script and stimuli generously shared by Dr. Stephane Dandeneau. Thank you!
last updated:  03-29-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script runs the Self-Esteem Matrix Task by:

Dandeneau, S.D., & Baldwin, M. W. (2004). The Inhibition of socially rejecting information 
among people with high versus low self-esteem: The Role of Attentional bias and the effects 
of bias reduction training. Journal of Social and Clinical Psychology, Vol. 23(4), 584-602.

Dandeneau, S. D., Baldwin, M. W., Baccus, J. R., Sakellaropoulo, M., & Pruessner, J. C. (2007). 
Cutting stress off at the pass: Reducing stress and hypervigilance to social threat by manipulating attention. 
Journal of Personality and Social Psychology, 93(4), 651-666. 

___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________	

Participants view a 4x4 matrix of images and are instructed to find a target stim as fast as possible 
(visual search task).
In the experimental condition, the target is a smiling face (all other images are frowny faces).
In the control condition, the target is a 5-petal flower (all other images are 7-petal flowers).

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 7 minutes to complete
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:

(1) Raw data file: 'sematrixtask_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. 
										
taskType:							1 = experimental condition (with faces); 
									2 = control condition (with flowers)
											Note: assignment is counterbalanced by groupnumber											
																						
response:							the participant's final (correct) response	
	
correct:							the correctness of the INITIAL response (1 = correct; 0 = incorrect)
											Note: participants can only move on if they select the target, however,
											the accuracy of the initial selection is stored.
											
latency: 							the response latency of the final response (in ms)

picture.target.currentItem:			the currently selected target <picture
/ targetStim:						stores the itemnumber of the current target stimulus

/ targetPosition:					positions 1-16 in a 4 x 4 matrix
											Row1: 1-4
											Row2: 5-8
											Row3: 9-12
											Row4: 13-16
											
trial.taskTrial.totalCount:				counts all trials taskTrial run by this script 
trial.taskTrial.totalCorrectCount:		counts all initially correct taskTrials run by this script 
trial.taskTrial.totalErrorCount:		counts all initially incorrect taskTrials run by this script
trial.taskTrial.totalPercentCorrect:	percent correct of initially correct taskTrials
trial.taskTrial.totalMeanLatency:		mean latency (in ms) of all taskTrials

(2) Summary data file: 'sematrixtask_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)

taskType:							1 = experimental condition (with faces); 2 = control condition (with flowers)
									Note: assignment is counterbalanced by groupnumber
										
trial.taskTrial.totalCount:				counts all trials taskTrial run by this script 
trial.taskTrial.totalCorrectCount:		counts all initially correct taskTrials run by this script 
trial.taskTrial.totalErrorCount:		counts all initially incorrect taskTrials run by this script
trial.taskTrial.totalPercentCorrect:	percent correct of initially correct taskTrials
trial.taskTrial.totalMeanLatency:		mean latency (in ms) of all taskTrials


___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
2 conditions: experimental vs. control (assignment by parameters.taskType)
Note: this script can be combined with script sematrixtaskbatch.iqjs to counterbalance groups by 
group number assignment

Experimental Condition: 4x4 matrix with 16 images
* face stimuli
-> 1 target: smiling face
-> 15 distractors: frowny faces

Control Condition: 4x4 matrix with 16 images
* drawings of flowers
-> 1 target: 5 petal flower
-> 15 distractors: 7 petal flowers

General:
* 4 blocks of 28 trials = 112 trials; after each block there is a rest trial
* 16 different actors => each actor is provided as a target stim (smiling) and as a distractor stim (frowny)
* position of target randomly determined with the constraint that the targets appear in each cell equally often 
(default: 7 times in each of the 16 cells)
* 16 different targets: randomly determined (7 repetitions of each target-> 112 trials)
* 15 distractors: all faces that are not used as the target are used as distractors; they are 
randomly assigned to the remaining 15 cell positions

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
see section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
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:

/ stimSize:					sets the size of stim <pictures in proportion to the canvas height (default: 21.25%)
							Note: canvas is defined under section DEFAULTS below
/ leftMargin-
/ topMargin:				sets the screen positions of the left and top margins of the matrix relative to 
							the canvas height and width (default: 10%)
							
/ taskType:					1 = experimental stims
							2 = control stims


___________________________________________________________________________________________________________________	

								*** Experimental Stimuli for Self-Esteem Matrix Task ***
___________________________________________________________________________________________________________________	

This script is a helper script for sematrixtask.iqjs.
It provides the stimuli used for the experimental condition.



___________________________________________________________________________________________________________________	

								*** Self-Esteem Matrix Task ***
								*** Attentional bias re-training***
								*** ABMT - attentional bias modification task***
								*** Visual search attentional training task ****
___________________________________________________________________________________________________________________	

Script and stimuli generously shared by Dr. Stephane Dandeneau. Thank you!
last updated:  03-29-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script runs the Self-Esteem Matrix Task by:

Dandeneau, S.D., & Baldwin, M. W. (2004). The Inhibition of socially rejecting information 
among people with high versus low self-esteem: The Role of Attentional bias and the effects 
of bias reduction training. Journal of Social and Clinical Psychology, Vol. 23(4), 584-602.

Dandeneau, S. D., Baldwin, M. W., Baccus, J. R., Sakellaropoulo, M., & Pruessner, J. C. (2007). 
Cutting stress off at the pass: Reducing stress and hypervigilance to social threat by manipulating attention. 
Journal of Personality and Social Psychology, 93(4), 651-666. 

___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________	

Participants view a 4x4 matrix of images and are instructed to find a target stim as fast as possible 
(visual search task).
In the experimental condition, the target is a smiling face (all other images are frowny faces).
In the control condition, the target is a 5-petal flower (all other images are 7-petal flowers).

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 7 minutes to complete
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:

(1) Raw data file: 'sematrixtask_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. 
										
taskType:							1 = experimental condition (with faces); 
									2 = control condition (with flowers)
											Note: assignment is counterbalanced by groupnumber											
																						
response:							the participant's final (correct) response	
	
correct:							the correctness of the INITIAL response (1 = correct; 0 = incorrect)
											Note: participants can only move on if they select the target, however,
											the accuracy of the initial selection is stored.
											
latency: 							the response latency of the final response (in ms)

picture.target.currentItem:			the currently selected target <picture
/ targetStim:						stores the itemnumber of the current target stimulus

/ targetPosition:					positions 1-16 in a 4 x 4 matrix
											Row1: 1-4
											Row2: 5-8
											Row3: 9-12
											Row4: 13-16
											
trial.taskTrial.totalCount:				counts all trials taskTrial run by this script 
trial.taskTrial.totalCorrectCount:		counts all initially correct taskTrials run by this script 
trial.taskTrial.totalErrorCount:		counts all initially incorrect taskTrials run by this script
trial.taskTrial.totalPercentCorrect:	percent correct of initially correct taskTrials
trial.taskTrial.totalMeanLatency:		mean latency (in ms) of all taskTrials

(2) Summary data file: 'sematrixtask_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)

taskType:							1 = experimental condition (with faces); 2 = control condition (with flowers)
									Note: assignment is counterbalanced by groupnumber
										
trial.taskTrial.totalCount:				counts all trials taskTrial run by this script 
trial.taskTrial.totalCorrectCount:		counts all initially correct taskTrials run by this script 
trial.taskTrial.totalErrorCount:		counts all initially incorrect taskTrials run by this script
trial.taskTrial.totalPercentCorrect:	percent correct of initially correct taskTrials
trial.taskTrial.totalMeanLatency:		mean latency (in ms) of all taskTrials


___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
2 conditions: experimental vs. control (assignment by parameters.taskType)
Note: this script can be combined with script sematrixtaskbatch.iqjs to counterbalance groups by 
group number assignment

Experimental Condition: 4x4 matrix with 16 images
* face stimuli
-> 1 target: smiling face
-> 15 distractors: frowny faces

Control Condition: 4x4 matrix with 16 images
* drawings of flowers
-> 1 target: 5 petal flower
-> 15 distractors: 7 petal flowers

General:
* 4 blocks of 28 trials = 112 trials; after each block there is a rest trial
* 16 different actors => each actor is provided as a target stim (smiling) and as a distractor stim (frowny)
* position of target randomly determined with the constraint that the targets appear in each cell equally often 
(default: 7 times in each of the 16 cells)
* 16 different targets: randomly determined (7 repetitions of each target-> 112 trials)
* 15 distractors: all faces that are not used as the target are used as distractors; they are 
randomly assigned to the remaining 15 cell positions

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
see section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
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:

/ stimSize:					sets the size of stim <pictures in proportion to the canvas height (default: 21.25%)
							Note: canvas is defined under section DEFAULTS below
/ leftMargin-
/ topMargin:				sets the screen positions of the left and top margins of the matrix relative to 
							the canvas height and width (default: 10%)
							
/ taskType:					1 = experimental stims
							2 = control stims


___________________________________________________________________________________________________________________	

								*** Experimental Stimuli for Self-Esteem Matrix Task ***
___________________________________________________________________________________________________________________	

This script is a helper script for sematrixtask.iqjs.
It provides the stimuli used for the experimental condition.