User Manual: Inquisit Symbol Counter Task


___________________________________________________________________________________________________________________	

										*SYMBOL COUNTER TASK*
___________________________________________________________________________________________________________________	

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

Script Copyright © 10-19-2023 Millisecond Software
___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the Symbol Counter Task to study allocation of attentional resources 
within working memory.

The implemented procedure is based on:

Garavan, H., Ross, T.J., Li, S.J., & Stein, E.A. (2000). A parametric manipulation of central executive 
functioning. Cereb Cortex, 10, 585-92.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
	
Participants are presented 18 sequences of small and big squares and have to keep a separate count for each
of the two squaretypes. Afterwards, participants are asked to select the count for each squaretype out of 
20 possible options and receive feedback.

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

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

(1) Raw data file: 'symbolCountertask_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. 
										
									
squareNumber:					the current length (number of squares presented)
switchIntensity:				the currently selected switchIntensity (1 = low; 2 = medium; 3 = high)
switchFrequency:				the calculated switch frequency (based on squareNumber and switchIntensity)
switchPositions:				a string variable that stores all switchPositions in order from lowest to highest
symbolOrder:					string variable that stores the order of the presented symbols (1 = small; 2 = big )
countSymbol1:					counts the number of symbol1 (small squares) cards that have been presented
countSymbol2,:					counts the number of symbol2 (big squares) cards that have been presented

dropdown.countSymbol1.response:		the participant's count of symbol 1 (small squares) cards
dropdown.countSymbol2.response: 	the participant's count of symbol 2 (big squares) cards

correctCount1:					1 = participant counted symbol1 cards correctly; 
								0 = participant did not count symbol1 cards correctly
									
correctCount2:					1 = participant counted symbol2 cards correctly; 
								0 = participant did not count symbol2 cards correctly
									
correct:						1 = both of participant's count are correct; 
								0 = otherwise
									
rt:								latency of response in ms (selecting the two counts)


(2) Summary data file: 'symbolCountertask_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)

totalCorrect:					number of times participants was correct on both counts
pctTotalCorrect:				percentage of times participant was correct on both counts

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
6 number of sequential squares x 3 types of switchFrequencies (high, medium, low) = 18 trial sequences

* Number of Squares: 	11, 12, 13, 14, 15, 16
* Switch Frequencies: 	number of times the sequence switches from one symbol to the other

						high -> floor(number of squares /2); e.g. floor(15/2) = 7
						medium -> floor (number of squares/4); e.g. e.g. floor(15/4) = 3
						low -> 1

TRIAL SEQUENCE:

trial.start <selects number of squares/switchFrequency> -> 
<utility trials that assemble list.switchPositions> -> 
trial.presentSquares (loops until all squares are presented) 
-> surveyPage.symbolCount 
-> trial.feedback 
-> trial.rest

*observed trial sequence (default):
	repeat for as many squares as need to be shown (trial.presentSquares)
	* fixation cross for 100ms
	* square for 1500ms

	Then:
	* select correct counts out of 20 possible options (0-20); maximum time to accomplish this is 
	12s (surveyPage.symbolCount)
	* receive feedback in the form of correct counts for 1000ms (trial.feedback)
	* rest for a predetermined amount of time before next trial starts (a clock presents number of seconds) 
	(trial.rest)
		=> 18 trials divided into 2 parts by a longer rest

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
	
2 types of black squares: small vs big
presented in form of pictures that can be easily substituted by others

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________

Instructions are not original to the task. They are provided by Millisecond Software
as htm/html pages and can be edited by changing the provided htm/html files.
To edit htm/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.

The parameters you can change are:

/symbol1Label:					the label of symbol1 (here: SMALL Square)
/symbol2Label:					the label of symbol2 (here: BIG Square)
								Note: if you use different symbols, change the labels below

/pictureHeight:					the height of the symbol picture (default: 50%)

Duration Parameters:			
/fixationCrossPresentation:			fixation cross duration (default: 100ms)
/cardPresentationDuration:			duration of card presentation (default: 1500ms)
/responseDuration:				time participants have to select countnumbers (default: 12000ms)
/feedbackDuration:				time feedback (here: correct counts) is presented  (default: 1000ms)
/restDurationRegular:				time of the resting trial (default: 15000ms) between trial sequence
/restDurationLong:				time of rest in between the first 9 trials and the second 9 trials (default: 120000ms)
/showCorrectCounts:				debug element: 
								if set to true: correctCounts are presented in red during the count selection trial
								false = counts are not presented (default).
/skipPractice:						false = a practice sequence is run (default); true = no practice is given