User Manual: Inquisit BeanFest


___________________________________________________________________________________________________________________	

										BeanFest
___________________________________________________________________________________________________________________

last updated:  02-17-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC
Script Copyright © 02-17-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________

The script implements the 'Bean Fest Paradigm' developed by Fazio et al (2004) to study attitude formation
and subsequent generalization.

Reference:

Fazio, R. H., Eiser, J. R., & Shook, N. J. (2004). Attitude formation through exploration: 
Valence asymmetries. Journal of Personality and Social Psychology, 87, 293-311.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are presented beans of various oval shapes with various speckles and they have to learn which 
of these beans to choose to gain points and which of these beans to reject to avoid the loss of points.
Participants either accept or reject a bean using 2 keys on the keyboard.
A test phase presents familiar and novel beans.

This script uses points and full feedback. 
Participants start with 100 points and gain or lose 10 points with each bean. 
There is no time penalty. Each of these parameters can be easily modified. 

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

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

(1) Raw data file: 'beanfest_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. 
										
response:						the participant's response (scancode of response buttons)
										32 = D;
										37 = K;
										
latency: 						the response latency (in ms); measured from: onset of picture
totalpoints:					stores the total points
currentbean:					stores the current bean image
values.currentbeanvalue:		assigns the current beanvalue according to group


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

totalpoints:				stores the total points earned (Note: in the default set up no total points are earned/lost during test block)


___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

Beans vary along 2 dimensions:
1. circular -> oval (in 10 steps)
2. number of speckles: 1-10
=> 100 possible combinations
=> 6 regions with 5-7 beans (36 beans total) are selected for the Learning Phase (Fazio et al, 2004, p.295).
=> 3 regions add points; 3 regions subtract points (if chosen)
!!!NOTE: by using groupids '1' and '2', the regions are counterbalanced

(I) Learning Phase: 
A. Practice: 6 trials; one bean randomly selected from each of the 6 regions
B. 1. Learningblock: 
The first 12 trials present 2 beans from each region.
The remaining 24 trials present the remaining beans in a random order
C. 2. Learningblock: all 36 beans presented in random order (block is repeated as many times as specified by parameters.maxlearningtrials)

(II) Test Phase (in this script):
100 trials: tests all learning beans and new beans (=remaining beans)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
100 beans that vary along the dimensions circular shape and number of speckles (see under EDITABLE STIMULI)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
see under 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:

- startingpoints: the number of points the participant starts with at the beginning of the game
- maxpoints: the maximum number of points that a participant can have
- timeout: the number of milliseconds the participant is given to respond to a bean
- positivebeanvalue: the number of points gained by eating a good bean
- negativebeanvalue: the number of points lossed by eating a bad bean
- timevalue: the number of points lost on each trial as a function of time
- feedbackduration: length of time in ms that feedback remains on the screen
- fullfeedback: whether to display hypothetical effect of rejected beans