User Manual: Inquisit Yoni Test


___________________________________________________________________________________________________________________	

										*YONI-TEST*
___________________________________________________________________________________________________________________	

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

Script Copyright © 11-01-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script runs the Yoni-Test to assess cognitive and affective ToM (Theory of Mind) based on:

Shamay-Tsoory, S.G. & Aharon-Peretz, J. (2007). Dissociable prefrontal networks for cognitive
and affective theory of mind: A lesion study. Neuropsychologia, 45, 3054–3067.

original Yoni-test with slides and instructions can be found at:
http://sans.haifa.ac.il/Downloads.html	

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants view slides with a Yoni face in the middle and 4 objects (and occasionally faces) in each of the 4
screen quadrants. Participants are encouraged to click the object that makes the most sense in relation 
to provided statements such "Yoni thinks of ___________"  as well as Yoni gazes (or the gazes of faces next to the 4 objects).

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

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

(1) Raw data file: 'yonitest_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.
										
index:							contains the itemnumber of the current slide

condition:						contains the condition tied to the current slide 
								(e.g. cognitive, affective, physical)
									
faceExpression:					contains the facial expression of Yoni tied to the current slide 
								(e.g. happy, neutral, sad)
									
eyes:							contains Yoni's eye gaze in relation to the correct answer for the current slide 
								(e.g. 'misleading', 'leading', 'non')
									
order:							1 = first order; 2 = second order
								Note: see under EXPERIMENTAL SET-UP the explanation for first/second order statements

verbs:							contains the verbs used for the current slide
correctAnswer:					contains the correct answers tied to the current slide
image:							contains the current image presented
response:						the participant's response 
correct:						the correctness of the response (1 = correct; 0 = otherwise)
latency: 						the response latency (in ms); measured from onset of image


(2) Summary data file: 'yonitest_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)
									
propCorrect:					overall proportion correct
meanRT:							overall mean correct latency (in ms)
sdRT:							overall standard deviation of correct latencies

propCorrectC: 					proportion correct in condition 'cognitive' (across orders and phases)
meanRTC:						mean correct latency (in ms) in condition 'cognitive' (across orders and phases)
sdRTC:						standard deviation of correct latencies in condition 'cognitive' (across orders and phases)

propCorrectA: 					proportion correct in condition 'affective' (across orders and phases)
meanRTA:						mean correct latency (in ms) in condition 'affective' (across orders and phases)
sdRTA:						standard deviation of correct latencies in condition 'affective' (across orders and phases)

propCorrectP: 					proportion correct in condition 'physical' (across orders and phases)
meanRTP:						mean correct latency (in ms) in condition 'physical' (across orders and phases)
sdRTP:						standard deviation of correct latencies in condition 'physical' (across orders and phases)

_+ separate variables for first (1) and second order (2) C/A/P conditions across phases
+ separate variables for first (1) and second order (2) C/A/P conditions by phase

_________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
3 judgment conditions:

1) Cognitive Judgments: 
A) first order: Yoni is thinking of___________________; directed Yoni gaze towards target
B1) second order: Yoni is thinking of the fruit that ____________ wants; directed Yoni gaze towards target
B2) second order: Yoni is thinking of the fruit that ____________ wants; non-directed gaze (Yoni looks straight ahead)

2) Affective Judgments: (all possible combination of love/does not love)
A) first order: Yoni loves___________________; directed Yoni gaze towards target
B1) second order: Yoni loves the fruit that ____________ loves ; directed Yoni gaze towards target
B2) second order: Yoni loves the fruit that ____________ loves; non-directed gaze (Yoni looks straight ahead)

3) control condition: Physical Judgments: !gaze information not relevant for this condition
A1) first order: Yoni is next to__________; directed gaze but misleading
A2) first order: Yoni is next to__________; non-directed gaze (Yoni looks straight ahead)
B1) second order: Yoni is next to the fruit that ___________ is next to; directed gaze but misleading
B2) second order: Yoni is next to the fruit that ___________ is next to; non-directed gaze (Yoni looks straight ahead)

Script runs 3 phases:
Phase A: runs first order trials of condition "cognitive", "affective", and "physical"
in a mixed design (8 trials each).

Phase B: runs a mixture of first order "cognitive" and "affective" (4 trials each) trials and
second order affective trials (24) in a mixed design. Object categories differ from Phase A/C.

Phase C: runs second order trials of condition "cognitive" (24 trials), "affective" (12 trials), and "physical"
(6 trials) in a mixed design.

!!!Note: The phases are coded independently of each other in this script.
This allows for increased flexibility in selecting the phases of interest.
By default, this script runs phaseA-phaseC in order. Changes can be made under
section EDITABLE PARAMETERS.

!!!Note: By default, the order of the slides is predetermined (run in the same order as the original Yoni test)
and the same for each participant. 
In this script, the order of the slides in each phase can be randomized under EDITABLE LISTS.

___________________________________________________________________________________________________________________	
STIMULI/INSTRUCTIONS
___________________________________________________________________________________________________________________

original Yoni-test with slides and instructions can be found at:
http://sans.haifa.ac.il/Downloads.html	
see section Editable Stimuli

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

/runPhaseA:						true (1): script runs Phase A (default)
									false (0): script skips Phase A
								
/runPhaseB:						true (1): script runs Phase B (default)
									false (0): script skips Phase B
								
/runPhaseC:						true (1): script runs Phase C (default)
									false (0): script skips Phase C