User Manual: Inquisit Forbidden Fruit Task


___________________________________________________________________________________________________________________	

								Forbidden Fruit Task
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 01-17-2024
last updated:  01-31-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-31-2024 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of the Forbidden Fruit Task by FitzGibbon et al. (2020).
The Forbidden Fruit Task investigates people's tendency to seek out information that was previously 
'forbidden' to them.

Reference:											

FitzGibbon, L., Ogulumus, C., Fastrich, G. M., Lau, J. K. L., Aslan, S., Lepore, L., & Murayama, K. (Preprint). 
Understanding the forbidden fruit effect: People's desire to see what is forbidden and unavailable. 
https://doi.org/10.31219/osf.io/ndpwt

https://osf.io/preprints/osf/ndpwt

CC-By Attribution 4.0 International
___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

Participants see 10 (default) decks of cards with colorful padlock icons. 
One of the padlocks is locked for the first 3 trials (it is unlocked for the last trial)
Participants work through 4 deck choices. Once a deck is selected, 6 cards depicting some nice scenes
are revealed via a card dealing simulation. The categories are selected from 16 possible ones and are
randomly assigned to each deck.
Afterwards participant are asked how much they liked the revealed cards.
At task conclusion, participants are asked if they could select the previously locked icon on the screen.
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 5 minutes to complete

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

(1) Raw data file: 'forbiddenfruittask_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:					with the current subject id
group: 						with the current group id
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. 
								
//parameter:																
numberOfDecksOnScreen:		the set number of decks on screen 


phase: 						"practice" vs. "test"
deckCounter:				counts the number of decks selected
lockedCategory:				the assigned picture category (0-15) to the locked category (Note: during practice the category is N/A)
lockedColor: 				the color of the locked deck
lockedDeck: 				number of locked deck
lockedPositionX: 			the horizontal percentage coordinate of the locked deck 
lockedPositionY: 			the vertical percentage coordinate of the locked deck

//custom DVs:
selectedDeck: 				the number of the currently selected deck
selectedColor: 				the color of the currently selected deck
selectedLockedCounter: 		tracks how often the locked deck is selected during the current phase (including the last trial)

valid: 						1 = valid selection; 
							0 = otherwise

currentRating: 				the rating of the currently uncovered deck category (range 0-4)
							0 = very sad - 4 = very happy

selectedPreviouslyLocked:	1 = the previously locked deck was selected on trial 4; 
							0 = otherwise

recallAcc:					1 = the previously locked deck was correctly identified during memory test 
							0 = otherwise

//built-in DVs for the currently data-recording trial:
response:					the response of participant 
correct:					correctness of response (1 = correct, 0 = error)
latency:					response latency (in ms)

//deck information (for all 10 possible decks)
deck1Index: 				the assigned padlock itemnumber (empty for decks that are not presented)
deck1Condition: 			1 = open deck; 2 = locked deck
deck1Color: 				the color of deck1
deck1Category: 				the assigned picture category to deck1 (0-15, Note: during practice the category is N/A)
deck1Selected: 				1 = deck1 was selected during the current phase; 0 = otherwise
deck1Rating: 				if deck1 was selected: rating (0-4) of deck1
picture.deck1.hPosition:	the horizontal percentage coordinate of deck1
picture.deck1.vPosition:	the vertical percentage coordinate of deck1								


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

lockedCategory:				the assigned picture category (0-15) to the locked category (Note: during practice the category is N/A)
lockedColor: 				the color of the locked deck
lockedDeck: 				number of locked deck
lockedPositionX: 			the horizontal percentage coordinate of the locked deck 
lockedPositionY: 			the vertical percentage coordinate of the locked deck

selectedLockedCounter: 		tracks how often the locked deck was selected during the test phase (including the last trial)

selectedPreviouslyLocked:	1 = the previously locked deck was selected on trial 4; 
							0 = otherwise

recallAcc:					1 = the previously locked deck was correctly identified during memory test 
							0 = otherwise

expressions.meanRating: 	the mean rating for the four revealed categories
list.ratings.item(1)-		the individual ratings for revealed category on trial1 to trial4
list.ratings.item(4)							
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

Basic setup for Practice/Test: 1 trial (with 4 deck choices)
Participants see 10 (parameter) decks with colorful padlocks. One of the padlocks is locked for the first 3 trials.
The color of the locked padlock is decided beforehand via a spinner simulation.
Participants work through 4 deck choices. Once a deck is selected, 6 (practice: 1) cards are revealed 
via a card dealing simulation. 
The cards can be viewed for 5seconds (default).
Already selected decks get color-desaturated.  For the last deck choice, the locked deck is opened up.

(1) Practice: 1 Trial (4 choices)
- participants get textual cues such as "Choose a lovely deck" whenever the next deck choice is up
- if participants select an already selected deck, a note appears above the deck "already selected"
- on the last trial, a note appears on the previously locked deck that states that this deck can now be selected.
("This deck is not forbidden anymore")
- only one card is revealed when a deck is selected
NOTE: during practice, the same four images are used for each participant (they are simply revealed in random order).
These images are NOT used during the test trials.

(2) Test: 1 Trial (4 choices)
- only a reminder of how many choices are left provided (if locked deck is selected before the last choice, 
nothing happens. Same with previously selected decks)
- six cards per deck are revealed for 5seconds (default)
- participants are asked how they liked the cards via a 5-point Likert scale with emojis icons 
after each reveal
- at the end of the trial, a memory test is given: all decks are returned (full color with open padlocks) 
and participants are asked to select the previously locked one.

//////////////////////////////////////////
Category Assignment to Decks (Test only)
//////////////////////////////////////////
The 16 categories are randomly assigned to each of the 10 decks
=> the locked deck is a randomly chosen category (should not be qualitatively different than the rest)


//////////////////////////////////////////
Deck Position Assignments (Test & Practice)
//////////////////////////////////////////
Decks are randomly assigned to one of 20 possible screen positions.
Within each of the 5x4 matrix positions, the position is randomly jiggled.

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________

categorie stimuli for the test phase shared by FitzGibbon et al (2020) under the CC-By Attribution 4.0 International License:
https://osf.io/rxptk/

remaining stimuli (card, padlocks & practice stimuli) downloaded from:
https://pixabay.com/ and edited by Millisecond Software

Stimuli can be exchanged under section Editable Stimuli
___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________

Instructions are not original to FitzGibbon et al (2020).
They are provided by Millisecond Software - can be edited under section '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:


//design parameters:
/ numberOfDecksOnScreen = 10				//The number of decks presented on page (choose from: 6-10)

//timing parameters
/ spinnerRevealDuration_inms = 2000			//the duration (in ms) that the spinner result is revealed
/ cardRevealDuration_inms = 5000			//the duration (in ms) that all cards are revealed