Return to the Automated Symmetry Span Task page
						
							   Automated Symmetry Span Task (ASSPAN)
SCRIPT INFO

Script Author: David Nitz (dave@millisecond.com) for Millisecond Software, LLC
last updated: 08-15-2016 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC

Script Copyright © 08-15-2016 Millisecond Software
Task Copyright (c) 2005 by Dr. Randall Engle: http://psychology.gatech.edu/renglelab/


BACKGROUND INFO

											*Purpose*
This script implements the Automated Symmetry Span Task (ASSPAN).

Working Memory Span Tasks Reference:
CONWAY, A.R.A., KANE, M.J.,BUNTING, M.F., D. ZACH HAMBRICK, D.Z., WILHELM, O., & ENGLE, R.W. (2005).
Working memory span tasks: A methodological review and user’s guide. Psychonomic Bulletin & Review
2005, 12 (5), 769-786.

											  *Task*
Participants are presented visual sequences of 3-7 red squares (default) in a 4x4 matrix 
that need to be recalled at the end. 
Each square in the sequence in preceded by a symmetry judgement of pixelated black and white images.
Square recall is tested by asking participants to click the sequence of the red squares in a provided
4 x 4 matrix. Recall of location AND order of squares matters.											  


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

(1) Raw data file: 'AutomatedSymmSpan_raw*.iqdat' (a separate file for each participant)

build:									Inquisit build
computer.platform:						the platform the script was run on
date, time, subject, group:				date and time script was run with the current subject/groupnumber 
blockcode, blocknum:					the name and number of the current block
trialcode, trialnum: 					the name and number of the currently recorded trial
											(Note: not all trials that are run might record data; by default data is collected unless /recorddata = false is set for a particular trial/block) 
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)
values.currentsetsize:					the size of the currently tested set of squares
list.TestSquareList.nextvalue:			stores the matrix location of the current square 
values.symmetryproblemcount:			tracks the number of symmetry problems presented 
picture.SymmetryProblem.currentitem: 	stores the currently presented Symmetry Problem 
values.symmetryaccuracy:				percent correct symmetry problems 
values.symmetrytotalerrors:				tracks the total number of symmetry errors (both speed and accuracy problems)
values.symmetryaccerrors:	 			tracks the symmetry problem errors due to accuracy (aka selected the incorrect answer)
values.symmetryspeederrors:				tracks the symmetry problem errors due to speed (aka was to slow to make a decision)
values.symmetrytimeout:					stores the time the symmetry problem is presented to participants
values.totalcorrectsquares: 			tracks the sum of all correctly recalled squares
values.totalrecalledsets:				tracks the number of all correctly recalled sets
values.sspan:							tracks the sum of all correctly recalled squares of correctly recalled sets

(2) Summary data file: 'AutomatedSymmSpan_summary*.iqdat' (a separate file for each participant)

script.startdate:						date script was run
script.starttime:						time script was started
script.subjectid:						subject id number
script.groupid:							group id number
script.elapsedtime:						time it took to run script (in ms)
computer.platform:						the platform the script was run on
/completed:								0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run)
values.sspan:							tracks the sum of all correctly recalled squares of correctly recalled sets
values.totalcorrectsquares: 			tracks the sum of all correctly recalled squares
values.totalrecalledsets:				tracks the number of all correctly recalled sets
values.symmetrytotalerrors:				tracks the total number of symmetry errors (both speed and accuracy problems)
values.symmetryspeederrors:				tracks the symmetry problem errors due to speed (aka was to slow to make a decision)
values.symmetryaccerrors:	 			tracks the symmetry problem errors due to accuracy (aka selected the incorrect answer)
values.symmetryaccuracy:				percent correct symmetry problems 

EXPERIMENTAL SET-UP
1 Practice Session (default):
	a) Practice of recalling sequences of squares of set sizes 2-3 in ascending order in a 4x4 matrix (4 trials)
	b) Practice of symmetry judgements of pixel images (15 trials)
	c) Combined practice of recalling sequences of squares (set size 2 only) and symmetry judgments: 
	each square is preceded by either a symmetrical or an asymmetrical pixel image (3 trials).
	Square recall is done by clicking the cells of a provided 4 x 4 matrix.

Test Session (default):
	15 Trials (15 = 3 repetitions of 5 set sizes; order of set sizes is randomly determined): 
	Recalling sequences of squares (set size 3-7): each square is preceded by either
	a symmetrical or an asymmetrical pixel image.
	Square recall is done by clicking the cells of a provided 4 x 4 matrix.

Scoring:
The program reports five values at the conclusion of the experiment: 
	
The first, SSPAN score, uses the traditional “absolute sspan” scoring method. 
It is the sum of all perfectly recalled sets. 
So, for example, if an individual recalled correctly 2 squares in a set size of 2,
3 squares in a set size of 3, and 3 squares in a set size of 4,
their SSPAN score would be 5 (2 + 3 + 0).

Total number correct is the total number of squares recalled in the correct position
(2 + 3 + 4 = 9 in the above example). 
	
Symmetry errors are reported as total number of errors, 
accuracy errors where the subject solved the operation incorrectly, 
and speed errors in which the subject ran out of time 
in attempting to solve a given operation.

STIMULI:
symmetry pixel images: check 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.


Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Security Statement | Employment