User Manual: Inquisit Do You Remember Game


___________________________________________________________________________________________________________________	

										HuskerDu - Memory Game
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 06-23-2016
last updated:  02-23-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-23-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements a "HuskerDu" memory game

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
											  
Participants are presented with a 8x8 matrix of covered cards. They are asked to find matching cards by
repeatedly turning over 2 cards. If the 2 uncovered cards match, they are removed from the game. If they don't match,
they are turned over once more. The game is over if all card pairs have been found.

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

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

(1) Raw data file: 'huskerdu_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. 
																				
nrCards:						counts the number of cards in a game 
response:						the participant's response (e.g. selected matrix box)
latency: 						the response latency (in ms)
response_nrSelections: 			stores the number of times the currently uncovered card has been uncovered yet 
pairID:							stores the pair ID of the currently selected pic

matchKnownForFirstCard:			1 = both cards of this pair have been uncovered at this point; 
								0 = otherwise

match:							0 = no match between card1 and card2; 
								1 = match between card1 and card2
									
responseCategory:				"no match" (= not a match, but the match to the uncovered card has not been uncovered yet), 
								"MISS" (=failure to uncover the match to a card if that matching card has previously been uncovered at least once), 
								"lucky guess" (= a successful match when the matched card (2nd turned) had NOT been previously uncovered yet AND there is still a degree of uncertainty (p <= 0.5) left where it could be)
								"HIT"(=successful matching of a card if the match has previously been uncovered at least once OR p=1 to select the correct match)

card1:							itemnumber of the first uncovered card
card2:							itemnumber of the second uncovered card
countAttempts:					counts the number of match attempts
countMatches:					tracks the number of matches found  
						
countLuckyGuesses:				counts all Matches that happen if the matching card had not been previously selected yet 
								(and there is still a degree of uncertainty where it could be)
								
countMisses:					counts all Misses (=failure to match a card if the match has previously been uncovered at least once)

countHits:						counts all Hits (=success to match card if matching card has previously been turned over OR 
								no more uncertainty where it could be)
								
countNoMatches:					counts all No Matches that are not a Miss


(2) Summary data file: 'huskerdu_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))
									
totalCards:						Parameter: the number of cards in a game (needs to be an even number) (Min: 2- Max: 64) 

gameDuration:					stores the duration of the game (in ms); measured from time of matrix presentation to matching the last pair
countAttempts:					counts the number of match attempts
countMatches:					tracks the number of matches found  (number of success)
countLuckyGuesses:				counts all Matches that happen if the matching card had NOT been previously selected (and there was still a degree of uncertainty to where it could have been)
propLuckyGuesses: 				the proportion of Lucky Guesses (number of Lucky Guesses relative to all matching attempts)
countMisses:					counts all Misses (=failure to match a card if the match has previously been uncovered at least once)
propMisses:						the proportion of Misses (number of Misses relative to all matching attempts)
countHits:						counts all Hits (=success to match card if matching card has previously been turned over OR no more uncertainty where it could be)
propHits:						the proportion of Hits (number of Hits relative to all matching attempts)
countNoMatches:					counts all No Matches that are not a Miss
propNoMatches:					the proportion of NoMatches (number of No Matches relative to all matching attempts)

* 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 
___________________________________________________________________________________________________________________
- a predetermined number of items are randomly selected (max. 32 cards to make 32 pairs) and a 
pair identification number assigned
- the paired cards are distributed randomly across a 8 x 8 matrix

- script tracks "lucky guesses" (matches when the location of the matching card is not certain), "Hits" 
(match between cards when the location of the 2nd card had been previously uncovered or is not uncertain),
'misses' (missed matches when the match had been previously uncovered) and "no matches"
(no matches when the location of the 2nd card is still uncertain).

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software (by default: 100 images of flora and fauna)
can be edited under section Editable Stimuli

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

/totalCards = 64			the number of cards in a game (needs to be an even number) (Max: 64 => 8 x 8 matrix)