User Manual: Inquisit Serial Probe Recognition Task


___________________________________________________________________________________________________________________	

									*SERIAL PROBE RECOGNITION TASK*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 03-20-2015
last updated:  10-10-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 10-10-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script runs a Serial Probe Recognition Task, a memory task used for memory research with
animal populations, e.g. Sands & Wright (1980).

Sands, S. F., & Wright, A. A. (1980). Serial probe recognition performance by a rhesus monkey and a human 
with 10- and 20-item lists. Journal of Experimental Psychology: Animal Behavior Processes, 6, 386–396.

The default set-up runs the procedure for people (no feedback markers are sent; 
positive auditory feedback for correct responses).
To send feedback markers, please go to 
a) section Editable Values and set feedback durations and
b) trial.feedback and follow further instructions.

___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________	
Computer presents lists of 10 picture stimuli; each stimuli is presented for 1s with a 800ms interstimulus
interval in the top half of the computer monitor. 1s after the last list stimulus is presented, a probe
is presented in the lower part of the computer monitor. Participants have 2s to decide whether
the probe was part of the list.
Half the probes are negative (the probe was not part of the list);
half the probes are positive (the probe was part of the list) with each probe position (1-10) 
being represented equally often. 

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

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

(1) Raw data file: 'serialproberecognition_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.
										
currentProbePosition:			stores the position of the probe in the set
probestim:						stores the itemnumber of the probestim
stimulusItem:					the presented stimuli in order of trial presentation
response:						the participant's response
correct:						the correctness of the response (1 = correct; 0 = incorrect)
latency: 						the response latency (in ms)

currentProbePosition:			stores the position of the probe in the set
probestim:						stores the itemnumber of the probestim

(2) Summary data file: 'serialproberecognition_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 (across positive and negative probe trials)
								positive probe trial: probe is part of set
								negative probe trial: probe is not part of set
									
propCorrectNegProbe:			overall proportion correct for negative probe trials
propCorrectPosProbe:			overall proportion correct for positive probe trials

propCorrectProbe1-
propCorrectProbe10:			proportion correct responses for positive probe trials; 
								separate for each probeposition


___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
1 Block of 140 trial sequences
* 70 positive probe trials (7 per each of the 10 probe positions)
* 70 negative probe trials

The order of negative and positive probes (and probe positions) are randomly determined.
The items presented in each list are randomly selected.

trial sequence
* trial.start_positiveprobe/negativeprobe: resets crucial variables before each list starts and selects current probeposition
* trial.stimpresentation_positiveprobe: presents the list of 10 stimuli (each pic is presented for 1000ms with an isi of 800ms)
* trial.start_positiveprobe/negativeprobe: 1000ms after the last list item: presents the probe and waits for response for max.2000ms 
* trial.feedback: presents only positive audio feedback (4000hz sound) by default; to send feedback port information 
	-> go to trial.feedback and follow further instructions

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
in this script: 
210 images of animals, flowers, vegetables, and fruits (collected from the internet)
- 140 of these get randomly selected to be the list stimuli
=> results in repeats of stimuli after 14 lists (of 10 items) have been presented
(each item is repeated 10 times)
=> to avoid any repeats use: 1400 (+ 70 for the negative probes) list pictures for 140 trial sequences 
(or use shorter lists and/or fewer trials)

- 70 (default: parameters.nr_trials/2) of these 210 stims are randomly selected to be the negative probes (these are not used for the lists)
=> no repeats of negative probes

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
generic instructions provided by Millisecond Software.
To change, go to 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:

/nrStims:									number of stimuli in a set
												Note: by default this script calculates summary variables for up to 10 possible probe positions
												Note: if this number is changed, go to list.probeposition and change possible probe positions

/nrTrials:									number of trials to run

/stimDuration:								presentation duration of each of the stimuli in ms (default: 1000ms)
/regularIsi:								interstimulus interval between stimuli presentation in ms (default: 800ms)
/lastIsi:									time between last stimulus and probe presentation in ms (default: 1000ms)
/probeDuration:								duration of probe trial in ms (default: 2000ms)
/getReadyDuration:							duration (in ms) of get-ready trial (default: 5000ms)
/iti:										intertrial interval in ms (default: 500ms)

/positiveFeedbackDuration:					duration of positive feedback in ms (default: 200ms)
/negativeFeedbackDuration:					duration of negative feedback in ms
												Note: to send positive or negative feedback markers go to trial.feedback and follow instructions