Return to the Listening Span Task page
						
								Automated "Listening" Span Task (ALSPAN) 
SCRIPT INFO

last updated: 01-20-2016 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC
Copyright © 01-20-2016 Millisecond Software

This script is based on the Automated Reading Span Task (ARSPAN) Inquisit script

Copyright for the ARSPAN: Task Copyright (c) 2005 by Dr. Randall Engle
http://psychology.gatech.edu/renglelab/

Inquisit programming for the ARSPAN: 
	David Nitz (nitz.david@gmail.com for Millisecond Software, LLC.
		
Auditory stimuli addition for the ALSPAN: 
	K.Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC.


BACKGROUND INFO

											*Purpose*
This script implements a listening version of the Automated Reading Span Task (ARSPAN)

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 listen to sequences of letters ranging from 3-7 letters (default) that need to be recalled at the end.
Each letter in the sequence in preceded by an auditory semantic categorization test ("sentence makes sense? yes or no") of 
sentences. Letter recall is tested by asking participants to selecte letters from a provided letter matrix.											  
									
DATA FILE INFORMATION: 
The default data stored in the data files are:

(1) Raw data file: 'AutomatedLSPAN_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) 
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)

/currentsetsize: 						the number of letters to recall for the current problem
text.letters.currentitem: 				the currently presented letter
/sentenceproblemcount: 					counts the number sentences in a given block
/sentencetimeout: 						duration (in ms) after which the sentence disappears (for test block: calculated for each participant based on average performance during practice)
text.PracSentenceProblem.currentitem: 	the currently presented practice sentence
text.SentenceProblem.currentitem: 		the currently presented test sentence
/sentenceaccuracy: 						percentage of correctly classified sentences within the current block
/sentencetotalerrors: 					counts number of any errors (speed or accuracy) made during sentence classification within the current block
/sentenceaccerrors: 					counts the number of incorrectly classified sentences within the current block
/sentencespeederrors: 					counts the number of times participant ran out of time when reading the sentence within the current block
/recalledletters: 						the number of letters recalled of the current problem
/lspan:									The lspan (listening span) score, uses the traditional "absolute rspan" scoring method (. 
										It is the sum of all perfectly recalled sets. 
										So, for example, if an individual recalled correctly 2 letters in a set size of 2,
										3 letters in a set size of 3, and 3 letters in a set size of 4,
										their lspan score would be 5 (2 + 3 + 0).
/totalcorrectletters: 					the total number of letters recalled in the correct position.
/totalrecalledsets: 					the number of correctly recalled sets

(2) Summary data file: 'AutomatedLSPAN_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)
/lspan:									The lspan score (listening span), uses the traditional "absolute rspan" scoring method. 
										It is the sum of all perfectly recalled sets. 
										So, for example, if an individual recalled correctly 2 letters in a set size of 2,
										3 letters in a set size of 3, and 3 letters in a set size of 4,
										their lspan score would be 5 (2 + 3 + 0).
/totalcorrectletters: 					the total number of letters recalled in the correct position.
/sentencetotalerrors: 					counts number of any errors (speed or accuracy) made during sentence classification during the test block
/sentencespeederrors: 					counts the number of times participant ran out of time when reading the sentence during the test block
/sentenceaccerrors: 					counts the number of incorrectly classified sentences during the test block


EXPERIMENTAL SET-UP

1 Practice Session (default):
	a) Practice of recalling sequences of letters of set sizes 2-3 in ascending order (4 trials)
	b) Practice of the semantic categorization task (15 trials)
	c) Combined practice of recalling sequence of letters (set size 2 only); each letter is 
	preceded by an auditory semantic categorization task (3 trials)
	Recall is done by picking out letters from a provided letter matrix.

Test Session (default):
	15 Trials (15 = 3 repetitions of 5 set sizes; order of set sizes is randomly determined): 
	Recalling sequences of letters (set size 3-7); each letter is preceded by an auditory semantic categorization task;
	Recall is done by picking out letters from a provided letter matrix.

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

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

STIMULI
Stimuli can be edited under section Editable Stimuli

INSTRUCTIONS
Instructions 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:

/ learninginterval:					duration (in ms) of the letter presentation trials
/ startsentencetimeout:				start duration (in ms) of the sentence presentation trials
										Note: the duration is adjusted for the test trials based on practice performance

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