User Manual: Inquisit Subtest 11: Match Emotional Prosody to Emotional Face


___________________________________________________________________________________________________________________	

								*Comprehensive Affective Testing System - Reduced (CATS-R)*
								*subtest11: MATCH EMOTIONAL PROSODY TO EMOTIONAL FACE*
								*Mouse or Touch Input*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-29-2020
last updated:  02-17-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-17-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements subtest11 'MATCH EMOTIONAL PROSODY TO EMOTIONAL FACE' of 
the Comprehensive Affective Testing System - Reduced (CATS-R).

The CATS and CATS-R were created by:
Sarah G. Schaffer, PhD
Karen B. Froming, PhD
Amanda L. Gregory, PhD
C. Michael Levy, PhD
Paul Ekman, PhD


Reference for Means and Standard Deviations used to calculate z-scores:

Emotion Processing: The Comprehensive Affective Testing System. User Manual.
Published 2006 by Psychology Software Inc


___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

subtest11: MATCH EMOTIONAL PROSODY TO EMOTIONAL FACE

Participants are asked to select the facial expression (5 choices) that reflects the
emotion of a person reading a neutral sentence. (12 trials)

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 2 minutes to complete
___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________		
The default data stored in the data files are:

(1) Raw data file: 'catsr_subtest11_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

subtest:							"subtest11"									

//if the subtest is run via a batch script that collects gender/age/taskOrder information:									
age:								the age of the participant 								
gender:								Female; Male; Other
taskOrder:							the selected task order	

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. 
										
trialCount:							trial counter																				
subtest11_testitem:					the index of the selected image 
testitem:							the presented audio file
correctResponse:					the dedicated correct response (= correct image from left (1) to right (5))
selectedResponse:					1-5 
correct:							accuracy of response: 1 = correct response; 0 = otherwise					 
RT:									cumulative response latency: measured from onset of image until 'nextButton' is pressed


(2) Summary data file: 'catsr_subtest11_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)
									
subtest:							"subtest11"									

//if the subtest is run via a batch script that collects gender/age/taskOrder information:									
age:								the age of the participant 								
gender:								Female; Male; Other
taskOrder:							the selected task order								
																	
									
T11_rawscore:					the number of correct responses in subtest11	
T11_rawscore_corrected:			the number of correct responses in subtest11, corrected
								(Note: in this subtest rawscores do not get corrected)
								
T11_zscore:						the z-score for the corrected T11_rawscore	
								(z-scores get calculated based on Age Means:
								age < 40 = age group 20-39
								41 < age < 60 = age group 40-59
								60 > age = age group 60-79
								(if no age is provided the population mean and standard deviation is used)
									
T11_propCorrect:					proportion correct responses in subtest11
T11_RT:							mean response time (in ms) in subtest11; measured from onset of image until 'nextButton' is pressed									
T11_corrRT:						mean response time (in ms) of CORRECT responses in subtest11; measured from onset of image until 'nextButton' is pressed							

+ results from individual questions							
* separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section
"DATA" and follow further instructions

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

1 Testblock of 12 trials
- emotions tested; happy (3), sad (3*), angry (3), frightened (3*)
The order of the statements is predetermined.

Participants can select any of the 5 face options. Responses can be changed until 'next' is pressed.
If button 'repeat' is pressed, the statements get repeated.

Note: By setting parameters.showAdvanceButton to true, a '?'-button appears in the upper right corner.
If pressed, the next scheduled test item is skipped.

*Note: The Inquisit script runs a different soundfile for subtest 11 question 4 (T11_4) than the original CATS-R.
The original CATS-R plays soundfile 
"subtest11_fourth namep8 the dog ran to the door frightened.wav" but scores selection of a sad face as
correct. Millisecond decided to replace the sentence with 'subtest11_fourth_theshirtwasnew_sad.wav' to keep the
frequency distribution of correct sad, angry, happy, frightened selections equal.

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
can be edited under section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - can be 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: