User Manual: Inquisit Sperling's Classic Partial Report Procedure


__________________________________________________________________________________________________________________
	
											*Class Sperling Task*
___________________________________________________________________________________________________________________											
SCRIPT INFO

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 04-29-2014
last updated:  09-05-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 09-05-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements an approximation of the classic Sperling task to investigate iconic memory as described in:

Sperling, G. (1960). The information available in brief visual presentations. 
Psychological Monographs, 74(11), 1-29.

IMPORTANT NOTE: Sperling (1960) used a tachistoscope for his 7 studies. 
This script adapts his procedures to the computer screen. 

___________________________________________________________________________________________________________________
TASK DESCRIPTION
___________________________________________________________________________________________________________________
Participants focus on a fixation cross in the middle of the screen. When they feel ready, they can press
the Spacebar. One of 4 types of consonant letter matrices (2x3 = 33, 2x4 = 44, 3x3 = 333, 3x4= 444) appears in the 
center for a short duration.  For partial reports, a tone indicates which row of the matrix to 
concentrate on and participants are asked (in this script) to enter their recalled letter in provided textboxes.

The default set-up of this script only runs: 3x3 matrices.
To add different matrices to the default procedure, please go to the end of the script for more information.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
The default set-up of the entire script takes appr. 40 minutes to complete

Whole Report: 30 test trials of trial.w333 (3x3 matrices) ~ 15 minutes
Partial Report: 30 test trials of trial.p333 (3x3 matrics) ~ 10 minutes

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

(1) Raw data file: 'classicsperlingtask_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.
										
										
reportType:						1 = partial report; 
								2 = whole report (tested in blocked design in this script)
									
stimulusItem:					presented stimulusitems									
									
exposureDuration:				current exposure duration
signalDelay:					current signal delay
nrRows:						number of rows of the current matrix
nrColumns:						number of columns of the current matrix
training:						0 = actual test trials; 1 = training trials

row1String-
row3String:						stores the presented string of letters by matrix row

targetrow:						the row that should be recalled in partial reports (1-3)
soundFile:						stores the current sound file (relevant only for partial reports)

row1string_r -
row3StringR:					stores the recall response by row 
								(the string of letters of each matrix row as entered during recall)
				
countCorrectPos:				counts the correctly recalled letters (correct letter in correct position) 
								for the current matrix/row
									
countCorrect:					counts the correctly recalled letters (independent of position)

repeat:							0 = no letter is repeated in the recalled matrix ; 
								1 = there was at least one repeated letter in the recalled matrix
								=> if repeat = 1 the response is considered invalid 
								(is NOT included into the descriptive summary statistics)
						
									
(2) Summary data file: 'classicsperlingtask_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)

Note: The default set-up of this script only runs: 3x3 matrices.
									
mean_w33 -
meanW444:						mean number of actually recalled letters of the whole matrix by matrix size 
								for Whole Reports

meanP33-
meanP444:						mean number of correctly recalled letters in partial (p) reports by matrix size

estwP33-
estwP444:						estimated mean number of correctly recalled letters of the entire matrix 
								based on partial reports by matrix size
								=> mean number of correctly recalled letters in partial (p) reports * number of rows 
								of the whole matrix 

meanP33Row1-
meanP444Row3:					mean number of correctly recalled letters of a specific targetrow in partial (p) 
								reports by matrix size 
								(e.g. Mean Recall p33 Row1 => mean number of correctly recalled letters for 
								targetrow 1 for partial report for matrix 33 (2 rows, 3 columns)
							

* 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 
___________________________________________________________________________________________________________________	

By default, participants are asked to work throught the Whole Report (WR) procedure and the Partial Report (PR) 
procedure (counterbalanced by groupnumber). Go to section(s) EXPERIMENT/BLOCKS to learn more about how to change
the default settings.

Default procedure for ClassicSperlingTask.iqjs:
1 = generalinstructions (presents general instructions for the task)
2 = instructions_WR (presents instructions for the WP procedure)
3 = demo_WR (runs 1 33-matrix sequence)
4 = start (runs the start instructions)
5 = w333 (runs 30 trials with 3x3 matrices for whole reports)
6 = instructions_PR (presents instructions for the PP procedure)
7 = tonetraining (add a tone training; see more info below)
8 = demo_PR (runs 1 33-matrix sequence)
9 = start (runs the start instructions)
10 = p333 (runs 30 trials with 3x3 matrices for partial reports)

Tone Training for PR procedure: 
There are 3 tones used for the PR procedure in this script (-> item.signals).
The highest tone signals row 1 (= top); the intermediate tone signals row 2 
(regardless of whether there are 2 or 3 rows); 
the deepest tone signals row 3 (only used in matrices with 3 rows).
block.tonetraining introduces these tones to the participants and adds a brief tone training 
(a tone is played and participants
have to press 1, 2, 3 to indicate which row was signaled) with 15 trials (5 trials per tone). 
The tone training can be repeated as many times as participants want it to.

Demos: 
Before the actual test, participants are given one Demo trial for either the WR or the PR procedure.
Only 2x3 matrices are used for the demos. No feedback is given to participants.

Test: 
- By default, participants are asked to work throught the WR procedure and the PR procedure (counterbalanced
by groupnumber). Go to section EXPERIMENT to learn more about how to change this default setting.
- The first 10 trials in each test block are considered training trials and responses don't count 
towards summary variables.
- The default background of the screen for all trial sequences is black with a gray center field in which the 
matrices appear in black on white (size/screen location of matrices as well as color/size of 
exposure field can be edited 
via EDITABLE CODE -> Editable Parameters)
The matrices are removed by covering them up with the gray center field for 500ms.
- Participants are asked to enter their responses in provided textboxes.

Trial Sequence:
fixation cross (waits for spacebar response)
->delay of 500ms: letter matrix for 500ms (default)
->mask for 500ms (+signal)
-> response screen


The following changes can be implemented:
(1) Type of report (partial vs. whole): tested in blocked design => go to section EXPERIMENT 
and change the type of blocks run by the script. 
By default: whole and partial procedure are both run (order counterbalanced by groupnumber).

(2) Number of rows and columns (sizes of matrices): 
the script provides code to run 2 x 3 ('33'), 2 x 4 ('44'), 3 x 3 ('333'), 3 x 4 ('444') matrices. 
Go to section EXPERIMENT/BLOCKS to customize which matrices to run.
By default: only 3x3 matrices are run

(3) Matrix exposure duration: change under EDITABLE CODE -> Editable Lists
default: 500ms only

(4) Response delay duration (relevant for partial reporting): change under EDITABLE CODE -> Editable Lists
default: 0ms only

(5) Number of trials: change under EDITABLE CODE -> Editable Parameters !AND! under section BLOCKS
default: 30 per matrix

(6) Pre and Post-Exposure field size and color -> EDITABLE CODE -> Editable PARAMETERS

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________	
The matrices select randomly from 21 consonants (-> list.consonant) with no repeated letters.
The appearance of the matrices (size and location) can be fine-tuned via EDITABLE CODE -> Editable Parameters

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
Instructions are not original to the task. They are provided by Millisecond Software
as htm pages and simple page elements and can be edited either by changing
the provided html files or directly under Editable Instructions.
To edit html-files: open the respective documents in simple Text Editors such as TextEdit (Mac)
or Notepad (Windows).
___________________________________________________________________________________________________________________	
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.


/nrCriticalTrialsperMatrix:	number of critical (aka count towards descriptive summary statistics) trials
								per matrix (default: 30)
								!!!If this number is changed, go to section BLOCK and follow instructions 
								change the number of trials run during test blocks accordingly
								Note: Number should be divisible by 2 and 3.

/fixationCrossPosttrialPause:	pause (in ms) after fixation cross disappears and matrix is presented
								(default: 500ms)

Appearance of Matrices:
/boxHeight:						the height of the individual matrix boxes that contain the letters in percentage
								of canvas height (default: 15%)
								
fixationCrossHeight:			the height of the fixation cross in percentage of canvas height (default: 5%)

/xMatrix33:-
/yMatrix444:					the coordinates for the different matrices (33 -> 444)

Size/Color of the Pre and Post Exposure Fields:
/exposurefieldWidth:			width (in percentage of canvas width) of the exposure field (default: 70%)
/exposurefieldHeight:			height (in percentage of canvas height) of the exposure field (default: 70%)

/preexposurefieldR:			the red component of the preexposure field (default: 100)			
/preexposurefieldG:			the green component of the preexposure field (default: 100)		
/preexposurefieldB:			the blue component of the preexposure field (default: 100)		

/postexposurefieldR:			the red component of the postexposure field (default: 100)		
/postexposurefieldG:			the green component of the postexposure field (default: 100)		
/postexposurefieldB:			the blue component of the postexposure field (default: 100)		

/fixationColor:					the color of the fixation cross (default: black)