User Manual: Inquisit Decision Games

												
___________________________________________________________________________________________________________________	

			*SOCIAL ECONOMIC GAMES: SOCIAL ECONOMIC GAMES: COMBINED RESPONSE AND DICATOR GAMES*
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 11-01-2012
last updated:  02-21-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-21-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script implements a sequence of socio-economic decision games called the  'Dicator Game' 
and the 'Response Game' about the allocation of monetary resources.
In the Dictator Game participants get the choice to allocate money in either a more pro-social 
or less pro-social manner without having to take a possible response of their opponent into account.
In the Response Game participants have to make their choices under the  assumption that they would allocate
the money after their opponent has decided to leave the choice up to them.

The implemented procedure is based on:

Brocklebank, S., Lewis, G.J, & Bates, T.C. (2011). Personality accounts for stable preferences and expectations 
across a range of simple games. Personality and Individual Differences, 51, 881-886.

The script combines the code from the DictatorGame.iqx and ResponseGame.iqx scripts that can be downloaded separately
and allows experimenters to customize a sequence of Dictator and Response Games.

___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________
										*Dictator Game Task*
A participant (= Player B) gets to allocate money (resources) to another Player A and herself that is presented
in a decision tree format. Participant (Player B) has the choice to allocate the money in a more or less "prosocial" 
manner.

										*Response Game Task*
Participant (Player B) gets to allocate money to herself and player A (aka computer) in either a a more or 
less prosocial manner. In the response game, the participant's choice is made under the assumption that player A 
(aka computer) chooses the "in" choice.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 6 minutes to complete
(if no task duration is provided, please contact Millisecond Software

___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________	
The default data stored in the data files are:

(1) Raw data file: 'DecisionGames_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.
																			
gametype:							stores whether a Dictator game, a ResponseA game (making A choice), or a ResponseB game (making B choice) is played

Avalue_Out-Bvalue_RightR: 			contain the out/in, left/right amounts (RESPONDER GAME)
Avalue_LeftD-Bvalue_RightD:			contains the designated left and right A and B values for the Dictator Game

branch:								1 = designated "left" and "out" amounts displayed on left; 
									2 = designated "left" and "out" amounts displayed on right
									
responsebranch:						the actually selected response branch A1 (choice A on the left) or A2 (choice A on the right), 
									B1 (choice B on the left) or B2 (choice B on the right)
											!!!! Note: if the participant selected a designated 'left' amount but the amount
											was presented on the right, Responsebranch = B2 but Response = left (designated 'left' amount)
											If a participant always selects the designated 'left' values, Response = left for all trials,
											but Responsebranch will reflect the actual branch chosen.
											
response:							the participant's response: 
										Dicator Game: "in" vs. "out"
										Response Game: "left" vs. "right"
										
latency: 							the response latency (in ms)

count_Out:							sums up all Out choices
count_In:							sums up all In choices
count_LeftR/count_RightR:			sums up all Left/Right choices for Response Games
count_LeftD/count_RightD:			sums up all Left/Right choices for Dictator Games

coplayerchoice:						helper variable that determines whether the computer makes an out-left (= 1) /in-right (=0)choice 
											(only relevant to determine the total)
											
totalParticipant:					the total amount Participant owns
totalComputer:						the total amount the computer owns


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

count_Out:							sums up all Out choices
count_In:							sums up all In choices
count_LeftR/count_RightR:			sums up all Left/Right choices for Response Games
count_LeftD/count_RightD:			sums up all Left/Right choices for Dictator Games
totalParticipant:					the total amount Participant owns
totalComputer:						the total amount the computer owns

///selected parameter settings:
show_opponentpic:					1 = (default) a picture of an opponent is displayed on decision tree screen 
									(fine tune picture under STIMULUS -> picture.OpponentA or picture.OpponentB]
									0 = no opponent picture is displayed 
									
showParticipantTotal:				1 = show win status of Participant (default); 
									0 = do not show win status of participant
										
showComputerTotal:					1 = show win status of Computer; 
									0 = do not show win status of computer (default)

computerdecisionrule:				1 = coplayer (aka computer) always makes designated 'out'/'left' choice (default); 
									2 = coplayer always makes designated 'in'/'right' choice; 
									3 = coplayer makes a random choice, dictated by list.randomchoice
									NOTE: list.randomchoice is set for 12 Response Games (default)
										
posttrialpause:						sets the posttrialpause for the trials

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________
(A) Order of Games played
SHARED CODE -> list.trialorder governs the order in which Dictator and Response Games (Variant A and Variant B) 
are played (see Editable Lists)
The default list plays 18 (6 Dictator Games, 6 Response Games Variant A, 6 Response Games Variant B) games in the order 
used by Brocklebank et al (2011) (=sequentially) but can be easily edited.
If the default number of trials is changed, edit SHARED CODE -> block.decisiongames accordingly 
and potentially RESPONSE GAME CODE -> LISTS (RESPONSE GAME) -> list.randomchoice

(B) Within-participant control of response keys:
Presentation of designated 'out'/'left' amounts randomized without replacement within participants.
Of the 18 games (default), 9 randomly determined trials will display the designated 'out'/'left' choices on the actual left branch, 
the remaining 9 will display them on the actual right branch.
!!!NOTE:
=> values.responsebranch reflects the actual branch chosen by the participant (A1, A2, B1, B2)
=> 'Response' reflects designated 'out'/'left or 'in'/'right' choices

(C) Amounts allocated:
The amounts allocated are dictated by lists. The amounts provided are the ones used by Brocklebank et al (2011) .
They can easily be edited.
a) Response game amounts:
REPONSE GAME CODE -> LISTS (RESPONSE GAME) -> Lists for Response Game A / Lists for Response Game B
b) Dictator game amounts:
DICTATOR GAME CODE -> LISTS (DICTATOR GAME)	

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
The script provides one picture. Change the selection and selectionmode under
RESPONSE GAME CODE -> STIMULI -> Opponent Picture(s)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
Instructions are not original to the task. They are provided by Millisecond Software
as htm/html pages and can be edited by changing the provided htm/html files.
To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac)
or Notepad (Windows).

Instructions can be edited under RESPONSE GAME CODE -> INSTRUCTIONS and DICTATOR GAME CODE -> INSTRUCTIONS
The provided instructions have been inspired by instructions used in these games in the economics social
decision making literature (and use some of the original wording) but have been adapted for this script.
	
___________________________________________________________________________________________________________________	
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:
/pictureintro:					1 = a separate picture introduction of the co-player is displayed before decision tree screens come up
								(fine tune picture under STIMULUS -> picture.opponentpic]
								0 = no separate picture introduction of the co-player (default)
								!!!Note: if default value is changed BUT parameters.show_opponentpic = 1; please change selectionmode of 
								picture.opponent (DICTATUR GAME CODE) and picture.opponenta/picture.opponentb (RESPONDE GAME CODE)
/show_opponentpic:				1 = a picture of an opponent is displayed on decision tree screen (fine tune picture under STIMULUS -> picture.OpponentA or picture.OpponentB]
								0 = no opponent picture is displayed (default)
/showParticipantTotal:			1 = show win status of Participant (default); 
								0 = do not show win status of participant
/showComputerTotal:				1 = show win status of Computer; 
								0 = do not show win status of computer (default)
/computerdecisionrule:			1 = coplayer (aka computer) always makes designated 'out'/'left' choice; 
								2 = coplayer always makes designated 'in'/'right' choice; 
								3 = coplayer makes a random choice, dictated by list.randomchoice (default)
								NOTE: list.randomchoice is set for 12 Response Games (default)
/posttrialpause:				sets the posttrialpause for the trials