User Manual: Inquisit Comprehensive Affect Testing System - Reduced Battery (CATS-R) in Polish


___________________________________________________________________________________________________________________	

								*Comprehensive Affective Testing System - Reduced (CATS-R)*
								*START script*
								*Mouse or Touch Input*	
		
								(Polish Version: runs subtest1, 2, and 8 only)
___________________________________________________________________________________________________________________	

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

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the START script to run 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

Note: The Polish version runs subtest1, 2, and 8 only (and in that order)

___________________________________________________________________________________________________________________
TEST SET UP	
___________________________________________________________________________________________________________________

The Comprehensive Affective Testing System - Reduced (CATS-R) consists of 13 subtests:

subtest1: Identity Discrimination
subtest2: Affect Discrimination
subtest3: Nonemotional Prosody Discrimination
subtest4: Emotional Prosody Discrimination
subtest5: Name Affect
subtest6: Name Emotional Prosody
subtest7: Match Affect
subtest8: Select Affect
subtest9: Conflicting Prosody - Attend to Prosody
subtest10: Conflicting Prosody - Attend to Meaning
subtest11: Match Emotional Prosody to Emotional Face
subtest12: Match Emotional Face to Emotional Prosody
subtest 13: 3 Faces Test

Note: The Polish version runs subtest1, 2, and 8 only (and in that order)

This START script is a batch script that automatically runs

(1) cats_taskselection.iqjs: this script collects demographic information

(2) a batch of the three Polish subtests
Note: the individual subtests cats_subtest1_polish.iqjs to cats_subtest8_polish.iqjs can be run
as single scripts as well.

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




___________________________________________________________________________________________________________________	

								*Comprehensive Affective Testing System - Reduced (CATS-R)*
								*Demographic Information and Test Selection Script*
								*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 is part of Millisecond Software's implementation of the
'Comprehensive Affective Testing System - Reduced (CATS-R)' Task.

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

___________________________________________________________________________________________________________________
SCRIPT OVERVIEW	
___________________________________________________________________________________________________________________	

This script collects demographic information

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

(1) Raw data file: 'catsr_taskselection.iqdat'

date, time:							date and time script was run with the current group/subjectnumber 
subject, group, session:	  		 with the current subject/groupnumber/session id
build:								the Inquisit build 

q*_response:						response given (in assigned values)
									
q*_latency:							how much time (in ms) the participant spent on the surveyPage with this particular 
									question (the last time this particular surveyPage was visited)


(2) Summary data file: 'catsr_taskselection_summary.iqdat' (Inquisit Lab: one data file per 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)
									
gender:								the entered gender of the participant 
age:								the entered age of the participant		
handedness:							left;right;ambidextrous

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



___________________________________________________________________________________________________________________	

								*Comprehensive Affective Testing System - Reduced (CATS-R)*
								*Subtest1: Identity Discrimination*
								*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 subtest1 'Identity Discrimination' 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	
___________________________________________________________________________________________________________________	

Subtest1: Identity Discrimination

Participants are presented with 2 faces of either the same actor or different actors.
They have to decide whether the faces are of the same person of whether the faces are of different people.
Participants work through 12 trials.
(Note: faces of the same people are always the exact same image)
___________________________________________________________________________________________________________________	
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_subtest1_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:							"subtest1"									

//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																				
subTest1TestItem:					the index of the selected image 
testItem:							the presented image

correctResponse:					the dedicated correct response: 
									1 = same
									2 = different									
									
selectedResponse:					'same' or 'different'
 
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_subtest1_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:							"subtest1"									

//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										
									

t1RawScore:					the number of correct responses in subtest2	
t1RawScoreCorrected:			the number of correct responses in subtest2, corrected
								(Note: in this subtest raw scores do not get corrected for gender)
								
t1ZScore:						the z-score for the corrected T1_rawscore
								(Note: in this script the overall mean and standard deviation are used)
									
t1PropCorrect:					proportion correct responses in subtest1
t1RT:							mean response time (in ms) in subtest1; measured from onset of image until 'nextButton' is pressed									
t1CorrRT:						mean response time (in ms) of CORRECT responses in subtest2; 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
- 6 trials with identical faces
- 6 trials different faces
The order of the images is predetermined.

Participants can select button 'same' or 'different'. Responses can be changed until 'next' is pressed.
If button 'repeat' is pressed, nothing happens in this script as the images are still on screen.

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:


___________________________________________________________________________________________________________________		

								*Comprehensive Affective Testing System - Reduced (CATS-R)*
								*Subtest2: AFFECT DISCRIMINATION*
								*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 subtest2 'AFFECT DISCRIMINATION' 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	
___________________________________________________________________________________________________________________	

Subtest2: AFFECT DISCRIMINATION

Participants are presented 12 pairs of vertically stacked faces and have to decide whether the faces
are of the same person of whether the faces are of different people.
The two faces always come from the same actor but the emotion the actor is showing may or may not be
the same (i.e., Happy, Sad, Angry, Frightened, Surprised, Disgusted, or Neutral)

___________________________________________________________________________________________________________________	
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_subtest2_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:							"subtest2"									

//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																				
subTest2TestItem:					the index of the selected image 
testItem:							the presented image

correctResponse:					the dedicated correct response: 
									1 = same
									2 = different									
									
selectedResponse:					'same' or 'different'

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_subtest2_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:							"subtest2"									

//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								
																	
									
t2RawScore:					the number of correct responses in subtest2	
t2RawScoreCorrected:			the number of correct responses in subtest2, corrected
								(Note: in this subtest rawscores get corrected for males over 39 by adding +1 to the rawscore)
								
t2ZScore:						the z-score for the corrected T2_rawscore	
								(Note: z-scores get calculated using the overall mean and standard deviation)
									
t2PropCorrect:					proportion correct responses in subtest2
t2RT:							mean response time (in ms) in subtest2; measured from onset of image until 'nextButton' is pressed									
t2CorrRT:						mean response time (in ms) of CORRECT responses in subtest2; 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
- 6 trials with identical faces
- 6 trials different faces
The order of the images is predetermined.

Participants can select button 'same' or 'different'. Responses can be changed until 'next' is pressed.
If button 'repeat' is pressed, nothing happens in this script as the images are still on screen.

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:


___________________________________________________________________________________________________________________	

								*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: