User Manual: Inquisit Subtest 8: Select Affect


___________________________________________________________________________________________________________________	

								*Comprehensive Affective Testing System - Reduced (CATS-R)*
								*subtest8: SELECT AFFECT*
								*Mouse or Touch Input*
								
								(Polish version)
___________________________________________________________________________________________________________________	

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

Script Copyright © 04-10-2023 Millisecond Software

Polish translation generously provided by Nina Prucnal
___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements subtest8 'SELECT AFFECT' 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	
___________________________________________________________________________________________________________________	

subtest8: SELECT AFFECT

Participants are presented with 5 faces (all from the same actor) and are asked to identify a face 
with a specific emotion. (6 trials)
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 2 minutes to complete
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________		
The fields in the data files are:

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

//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
subTest8Instructions:				trial instructions																					
subTest8TestItem:					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_subtest8_polish_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:							"subtest8"									

//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								
																	
									
t8RawScore:					the number of correct responses in subtest8	
t8RawScoreCorrected:			the number of correct responses in subtest8, corrected
								(Note: in this subtest rawscores do not get corrected for gender)
								
t8ZScore:						the z-score for the corrected T8_rawscore
								(Note: z-scores get calculated using the overall mean and standard deviation)								
									
t8PropCorrect:					proportion correct responses in subtest8
t8RT:							mean response time (in ms) in subtest8; measured from onset of image until 'nextButton' is pressed									
t8CorrRT:						mean response time (in ms) of CORRECT responses in subtest8; 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 6 trials
- emotions tested; happy, sad, angry, frightened, surprised, disgusted
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.

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
can be edited under section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software (based on originals)- can be edited under section Editable Instructions
The verbal *wav files were created using the listening feature of Google Translate.
The files can easily be replaced by your own.

You can control whether to run the audio instructions via 
editable parameter 'runAudioInstructions' - see section Editable Parameters for more information
___________________________________________________________________________________________________________________	
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: