User Manual: Inquisit Facial Display of Emotions Rating


___________________________________________________________________________________________________________________	

									FACE EMOTION PARADIGM
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 11-11-2013
last updated:  06-13-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 06-13-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements a Face Emotion Paradigm; a task for Emotion Recognition of different
ethnic groups. The implemented procedure is based on:

Beaupre´, M.G., Hess, U. (2005). Cross-cultural emotion recognition among Canadian ethnic groups. 
Journal of Cross-Cultural Psychology 36, 355–370.

Note: this script runs with placeholder stimuli. To get access to the original stimuli, please
contact Dr. Ursula Hess directly.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are presented pictures of people with different facial expressions.
Afterwards they are asked to 
1) rate the facial expression on 10 emotion dimensions/profiles 
2) rate the likelihood of the daily occurrence of the presented facial expression

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 45 minutes to complete

___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________	
The fields in the data files are:

(1) Raw data file: 'faceemotion_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.
																		
parameters.group:					1 = run with half design set 1
									2 = run with half design set 2								
																
emotion:							stores the current emotion (e.g. "anger")

ethnicity:							stores the ethnicity of the current encoder (default)
									1 = Subsaharan African
									2 = Chinese
									3 = French Canadian
									Note: not accurate for practice trials
									
gender:								stores the gender of the current encoder (default)
									1 = Female
									2 = Male
									Note: not accurate for practice trials
									
enCoder:							stores the "itemnumber" of the current encoder (1-12)
intensity:							stores the current intensity level of the emotion
									Note: by default, this script runs only 1 intensity level
										
stimulusItem:						stores the current stimulus (picture)

emotionAccuracy:					1 = target category was rated the highest of all categories in the emotion profile task
									0 = otherwise

									Note: values.emotion_accuracy
									Beaupre´, M.G., Hess, U. (2005): "The level of accuracy was calculated
									from the intensity scales such that when the target scale received the highest score, 
									judgment was considered as accurate and a score of 1 was given; otherwise, a score of 0 was
									given." (p.359/360)
								
dailyOccurence:					the selected probability that presented emotion is presented on a daily basis

slider.anger.response - 
slider.surprise.response:			the selected responses for the 10 questions of the emotion profile tasks


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

group:								1 = run with half design set 1
									2 = run with half design set 2
								
propEmotionAccuracy: proportion of emotion profile responses that rated the target emotion the highest
									 (across all emotions; not counting neutral)
									 

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________

(A )Complete design:
3 encoder ethnicities (e.g. French Canadian, Subsaharan Africans, Chinese) x 2 genders x 6 emotions (anger, happiness, sadness, fear, disgust, shame)
x 4 encoders = 144 trials

Half design: the total set was broken down into 2 sets in Beaupre´& Hess (2005). Each set was made up of expressions by 2 males and 2 females from each cultural group (not 4).
=> 3 encoder ethnicities (French Canadian, Subsaharan Africans, Chinese) x 2 genders x 6 emotions (anger, happiness, sadness, fear, disgust, shame)
x 2 encoders = 72 trials
=> sets were counterbalanced between participants in Beaupre´ & Hess (2005).

!NOTE: this script implements only the half design. To run the complete design, dublicate the script with the second set of stimuli and set
Editable Parameters -> parameters.group = 2.

!NOTE: this script runs only 1 intensity level for each emotion. To add more intensity levels, go to section Editable Stimuli and follow
further instructions

!NOTE: this script runs 3 encoder ethnicities. To add more, follow instructions under section Editable Stimuli


(B) SET-UP
- 1 practice block with 2 emotion trials (e.g. encoders not of the current set)
- 1 test block: selects one of the 6 emotion trials randomly without replacement

Trial Sequence: 72 trials (half design)
Picture (default: 5000ms) -> Emotion Profile (order of questions is random) -> Daily Occurrence question -> Intertrial Interval (default: 0ms)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
this script runs with placeholder stimuli. To get access to the original stimuli, please
contact Dr. Ursula Hess directly. The stimuli can be edited under section Editable Stimuli.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
The instructions are not original and can be easily edited unter 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:
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:

/group:									1 = run with half design set 1
										2 = run with half design set 2

/pictureHeight:							set the height (width will be adjusted automatically) of the pictures (default: 50% of screen height)

durations:
/stimulusDuration:						set the duration of the stimuli (pictures) in ms (default: 5000ms)
/iti:									set the duration of the intertrial interval in ms (default: 0ms)

/emotionProfileInstruction:			edit the instructions for the emotionprofile task
/dailyoccurrenceInstruction:			edit the instructions for the daily-occurrence task