User Manual: Inquisit Cognitive Drug Research Computerized Assessment System (COGDRAS)


___________________________________________________________________________________________________________________	

										*Millisecond COGDRAS*
										Batch script to run a COGDRAS session
___________________________________________________________________________________________________________________	

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

Script Copyright © 04-11-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements Millisecond Software's version of the 
Cognitive Drug Research Computerized Assessment System (COGDRAS). 

The script runs 8 individual cognitive tests testing memory, attention and reaction times as a batch.
A final script collects all the relevant summary variables.

A starting script provides a brief overview of the testing session and practices the
response buttons. The default response buttons are:
Q = yes-key
P = no-key
(to change response buttons FOR THE ENTIRE batch go to section Editable Parameters in this script and
choose your response keys. Note that script ms_cogdras_training.iqjs has to be edited to reflect the 
change) 

To change the order of the tests OR remove any of the tests from the batch go to section
EXPERIMENT and follow further instructions.


COGDRAS Reference:
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

COGDRAS runs 8 cognitive tests in the following order:

1. Immediate Word Recognition Test (immediatewordrecognition_cogdras.iqjs)
2. Picture Presentation (picturepresentation_cogdras.iqjs)
3. Number Vigilance Test (numbervigilance_cogdras.iqjs)
4. Simple Reaction Time Test (simplereactiontime_cogdras.iqjs)
5. Choice Reaction Time Test (choicereactiontime_cogdras.iqjs)
6. Memory Scanning Test (memoryscanning_cogdras.iqjs)
7. Delayed Word Recognition Test (delayedwordrecognition_cogdras.iqjs)
8. Picture Recognition Test (picturerecognition_cogdras.iqjs)

Each test can be run within this batch script or as stand-alone tests.
Each test takes approx. 2-3 minutes to run.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 15-20 minutes to complete
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	
check individual scripts for more information
___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
check individual scripts for more information.
__________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
check individual scripts for more information and to edit instructions.



___________________________________________________________________________________________________________________	

							*Millisecond Software COGDRAS Start Script*
___________________________________________________________________________________________________________________	

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

Script Copyright © 04-11-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a start script with a short keyboard response training (introducing the YES/NO keys)
to start a Millisecond COGDRAS testing session.

Reference (for description of COGDRAS tests)
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.
___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants receive a brief overview of the testing session and get introduced to the 
YES-key and NO-key on their keyboards.

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

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

(1) Raw data file: 'ms_cogdras_start_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. 
										
stimulusItem:						the presented stimuli in order of trial presentation
response:							the participant's response (scancode of response buttons)
										16 = q
										25 = p
latency: 							the response latency (in ms)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - 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.


___________________________________________________________________________________________________________________	

										*Immediate Word Recognition*
										(subtest of COGDRAS)										
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-01-2020
last updated:  02-10-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-10-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a procedure to test Immediate Word Recognition.
Immediate Word Recognition is a subset of the 
Cognitive Drug Research Computerized Assessment System (COGDRAS).

Reference
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.
___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants view a list of 12 words, each presented for 3seconds.
Afterwards they are given 24 words (12 old, 12 new) and are asked to press a dedicated
YES-key for words previously seen and press a dedicated NO-key for new words.
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 3 minutes to complete

Note: the test can easily be aborted by pressing "Ctrl+Alt+A"
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONAIRY
___________________________________________________________________________________________________________________		
The fields in the data files are:

(1) Raw data file: 'immediatewordrecognition_cogdras_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. 
										
stimulusitem:						the presented words

response:							the participant's response (scancode of response buttons)
										16 = Q
										25 = P
										57 = spacebar
										
responseLabel:						"yes" vs. "no"	

responseCategory:					"Hit" (pressed yes-key for a target word)
									"Miss" (pressed no-key for a target word) = omission error
									"CR" (pressed no-key for a foil word) = correct rejection
									"FA" (pressed yes-key for a foil word) = commission error															
										
correct:							accuracy of response: 1 = correct response; 0 = otherwise
latency: 							the response latency (in ms); measured from: onset of words

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

inquisit.version: 					the Inquisit build/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)
									
IREC_ACC:							proportion correct recognition (across target and foil words) in Immediate Word Recognition Test 

IREC_RT:							mean response time (in ms) of correct responses (across target and foil words) 
									during recognition phase in Immediate Word Recognition Test	
		
IREC_hitRT:							mean response time (in ms) of correct responses for target words only
		
rHIT: 								the hitrate (proportion correct responses for target words => participant said 'yes' to target words)
rFA:								the false alarm rate (proportion of incorrect responses for foil words => participants said 'yes' to foil words) 

IREC_Aprime:						non-parametric measure of sensitivity in Immediate Word Recognition Test
									Range: 0 (all incorrect responses) -  0.5 (random responses) -  1 (all correct responses)
									For Aprime measure see: 
									Stanislaw, H. & Todorov, N. (1999). Calculation of signal detection theory measures.
									Behavior Research Methods, Instruments, & Computers, 1999, 31 (1), 137-149.
									Note: Nicholl et al (1995) used the non-parametric signal theory index
									(SI) presented by Frey and Colliver (1973) with a range of -1 (all incorrect) to 1 (all correct)
									
													
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

(1) Learning:
- 12 words are presented one-by-one in the middle of the screen; each is presented for 3s (editable parameter)

(2) Recognition Test
- 12 target words (from learning) and 12 foil (=new)) words are presented, one-by-one in the middle of the screen;
order is randomly determined
- participant respond by pressing 'Q' for yes (it's a target) or 'P' for no (it's a foil/not a target)
___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited under section Editable Stimuli

The current words provided in this script were taken from:
McEvoy, C. L., & Nelson, D. L. (1982). Category name and instance norms for 106 categories of various sizes. 
American Journal of Psychology, 95, 581-634.
Nairne, J. S. (1990). A feature model of immediate memory. Memory and Cognition, 18, 251-269.

Each of the 24 words come from a different category.
The words can easily be exchanged for others.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - 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.

//StimSize:
/ stimSize = 10%								//the proportional sizing of the words (default: 10%)

//Duration Parameters
/ firstStimDelay = 1000						//the delay (in ms) of the first stim after pressing spacebar to start
/ stimPresentationDuration = 3000			//the presentation duration (in ms) of each word (default: 3000ms)
/ isi = 0									//the interstimulus interval (in ms) (default: 0ms)

//Response Keys:
/ leftKey = "Q"								//the left response key (here: Q)
/ rightKey = "P"								//the right response key (here: P)
/ yesKey = parameters.leftKey				//the assignment of left/right key to the yesKey (here Q); left keys will appear on the left on touch screens
/ noKey = parameters.rightKey				//the assignment of left/right key to the noKey (here P); right keys will appear on the right on touch screens



___________________________________________________________________________________________________________________	

										*Picture Presentation*
										(subtest of COGDRAS)
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-09-2020
last updated:  02-10-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-10-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a picture presentation procedure as used in the 
Cognitive Drug Research Computerized Assessment System (COGDRAS). 

Reference
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants are presented 14 images (3s each) for a later memory task.
Note: the test can easily be aborted by pressing "Ctrl+Alt+A"
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 2 minutes to complete
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________		
The fields in the data files are:

(1) Raw data file: 'picturepresentation_cogdras_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. 
										
stimulusItem:						the presented images
latency: 							the response latency (in ms); measured from: onset of images
									(the latency will equal the duration of the images)
							
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

(1) Picture Presentation:
- 14 images are presented; order is randomly determined
- each image is presented for 3s (see duration parameters under section Editable Parameters)
___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited under section Editable Stimuli

The images provided with this script are digitalized versions (300px x 300px) of the pictures presented by:
Snodgrass, J. G., & Vanderwart, M. (1980). A standardized set of 260 pictures: Norms for name agreement, 
image agreement, familiarity, and visual complexity. Journal of Experimental Psychology:
Human Learning & Memory, 6, 174-215.

The size of the images can be edited under section Editable Parameters
___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - 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.

//StimSize:
/ stimSize = 40%								//the proportional sizing of the images (default: 40%)

//Duration Parameters
/ firstStimDelay = 1000						//the delay (in ms) of the first stim after pressing spacebar to start
/ stimPresentationDuration = 3000			//the presentation duration (in ms) of each image (default: 3000ms)
/ isi = 0									//the interstimulus interval (in ms) (default: 0ms)

//Response Keys:
/ leftKey = "Q"								//the left response key (here: Q)
/ rightKey = "P"								//the right response key (here: P)
/ yesKey = parameters.leftKey				//the assignment of left/right key to the yesKey (here Q); left keys will appear on the left on touch screens
/ noKey = parameters.rightKey				//the assignment of left/right key to the noKey (here P); right keys will appear on the right on touch screens



___________________________________________________________________________________________________________________	

										*Number Vigilance Task*
										(subtest of COGDRAS)
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-08-2020
last updated:  02-10-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-10-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements a computerized Number Vigilance Task, a measure of attention and cognitive control.
The Number Vigilance Task is used as a subtest of 
the Cognitive Drug Research Computerized Assessment System (COGRAS).
The Number Vigilance Task is a type of go/no go task with digits.

The implemented procedure is similar to the one published in:

Nicholl, C.G. et al (1995). The the Cognitive Drug Research Computerized Assessment System
in the evaluation of early dementia- is speed of the essence?
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206
___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants view a stream of digits presented in the middle of the screen, one at a time.
A new digit is presented ~750ms (for a presentation Rate of: 80 words/minute).
Whenever the digit is the same as the target digit (which is presented on the right of the screen
throughout the task), they have to press the 'Yes' key (here: Q-key). Otherwise they are instructed to not do 
anything but stay vigilant and wait for the next digit.								
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 3 minutes to complete

Note: the test can easily be aborted by pressing "Ctrl+Alt+A"
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________	
The fields in the data files are:

(1) Raw data file: 'numbervigilance_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. 
																			
digitType:							1 = target digit (current digit = target digit); 
									2 = foil digit (current digit <> target digit)
									
targetDigit:						the randomly selected target digit that is presented at the right of the screen
currentDigit:						the currently randomly selected digit that is presented in the center of the screen

response:							the participant's response (scancode of response button)
										16 = yes-key was pressed; 
										0 = no response
										
responseLabel:						"yes" vs. "" (empty)											
										
responseCategory:					"Hit" (pressed yes-key for a target)
									"Miss" (did not press yes-key for a target) = omission error
									"CR" (did not press yes-key for a nontarget) = correct rejection
									"FA" (pressed yes-key for a nontarget) = commission error	
									
correct:							accuracy of response: 
									1 = correct response; 
									0 = otherwise
									
latency: 							the response latency (in ms); measured from: onset of center digit


(2) Summary data file: 'numbervigilance_summary*.iqdat' (a sepaRate file for each participant)*

inquisit.version: 					the Inquisit build/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)

numberOfDigits:						the number of digits presented (targets and nontargets)								
numberOfTargets:					the number of targets presented
numberOfFoils:						the number of foils presented

propCorrect:						proportion correct responses (across targets and nontargets)
vigHit:								the number of hit responses (pressing spacebar for target digits)
vigFA:								the number of false alarms (pressing spacebar for foil digits)

vigAcc:								the hitRate (proportion of targets that were correctly responded to) in Number Vigilance Test
vigMissRate:						the miss rate (proportion of targets that were not responded to)
vigFARate:							the false alarm Rate (proportion of non targets that were responded to)
vigCrRate:							the correct rejection rate

dPrime:					d' = sensitivity index calculated as difference btw. z score of hit rate and z-score of false alarm rate
						=> Range (in this script): 
						-5.1516586840152740479 <= dprime <= 5.1516586840152740479 (=perfect performance)
						=> The higher the value, the better signals (=targets) were overall distinguished 
						from noise (=nontargets) and thus the better participant paid attention
						(d' = 0: chance performance; negative d-primes: participant treated nontargets as targets and targets as nontargets)
									
c: 						c-criterion in signal detection:The absolute value of c provides an indication of the strength of
						the response bias/response style
						negative: participant more likely to report that signal (go stims) is present (liberal response style);
						may favor faster responding in speed-accuracy trade-off response paradigms
						positive: favoring caution (conservative response style)
						
//response Times:						
vigRT:					the mean response time (in ms) of correctly responding to a target in Number Vigilance Test
						
						
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

Target Digit: is sampled randomly at the start of the script.
The same target is throughout the test.

1. Test Block:
- number of test trials can be set under section Editable Parameters (default: 90)
- proportion of target trials can be set under section Editable Parameters (default: 30%)
- order of target and foil trials is random (constraint: first trial is a foil trial)
- selection of foil digits is random with replacement
- SOA and digit presentation duration can be set under section Editable Parameters
(SOA: 750ms; digit presentation duration: 750ms)

Trial Sequence: 
* target is presented throughout the blocks to the right on the screen
* each block starts with the target presented alone for duration SOA

current digit presentation (750ms), response window = SOA = 750ms ->current digit presentation

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
target = randomly determined digit from 0 to 9, presented in black font on the right side of the screen
current digit = digit from 0 to 9, presented in black font in the center of the screen
both digits are equal in size (size can be set under section Editable Parameters)
___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - 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.

//StimSize
/ stimSize = 20%								//the proportional size of the digits on screen (default: 20%)

//Duration Parameters
/ firstStimDelay = 1000						//the delay (in ms) of the first stim after pressing spacebar to start

/ digitSOATest = 750						//the stimulus onset asynchrony (in ms) during test trials (default: 750ms)
											//Note: participants have the entire SOA to respond
											//Note: 1 word/750ms => 80 words/minute

/ digitPresentationTimeTest = 750			//the presentation duration (in ms) of the current trial digit (default: 750ms)
											//Note: if the presentation duration is longer than SOA, the presentation duration is 
											//automatically reduced to SOA

//Experimental Design Parameters:
/ nrTestTrials = 90							//the number of test trials run (default: 90)

/ targetRate = 0.3							//the proportion of targets during the test (and practice) (default: 0.3 => 30%)
											//Note: the proportion of targets should result in an integer
											//Example: 90 test trials * 0.3 targets = > 27 targets

//Response Keys: Note this script only requires the YES-key
/ leftKey = "Q"								//the left response key (here: Q)
/ rightKey = "P"								//the right response key (here: P)
/ yesKey = parameters.leftKey				//the assignment of left/right key to the yesKey (here Q); left keys will appear on the left on touch screens
/ noKey = parameters.rightKey				//the assignment of left/right key to the noKey (here P); right keys will appear on the right on touch screens




___________________________________________________________________________________________________________________	

										*Simple Reaction Time Task*
										(subtest of COGDRAS)								
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-08-2020
last updated:  02-10-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-10-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a simple Reaction Time Time Task, a subset of the 
Cognitive Drug Research Computerized Assessment System (COGDRAS).

Reference
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants are asked to press a certain response key (here: Q) whenever the word YES appears in the middle of
the  screen.
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 2 minutes to complete

Note: the test can easily be aborted by pressing "Ctrl+Alt+A"
__________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________		
The fields in the data files are:

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

countTrials:						custom counter of test trials (those that present word "YES")
										
stimulusItem:						the presented stimuli in order of trial presentation
response:							the participant's response (scancode of response buttons)
										16 = Q
										
responseLabel:						"yes"									

latency: 							the response latency (in ms); measured from: onset of word YES

iti:								the intertrial interval (in ms) run at the end of the current trial

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

inquisit.version: 					the Inquisit build/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)
									
srtRT:								the mean response time (in ms) in the Simple Reaction Time test		
									(measured from onset of word 'YES' in the center of the screen)
							
							
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

1. Test
- 20 trials (editable parameters)

Trial sequence:
- word YES appears (wait for response) -> random iti (1000-2500ms) -> word YES....

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited under section Editable Stimuli

The word YES - size can be set under section Editable Parameters

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - 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:

//StimSize:
/ stimSize = 20%								//the proportional sizing of the yes-word on screen (default: 20%)

//Experimental Design Parameters:
/ nrTestTrials = 20							//the number of test trials run (default: 20)

//Response Keys: note only the yes-key is used in this script
/ leftKey = "Q"								//the left response key (here: Q)
/ rightKey = "P"								//the right response key (here: P)
/ yesKey = parameters.leftKey				//the assignment of left/right key to the yesKey (here Q); left keys will appear on the left on touch screens
/ noKey = parameters.rightKey				//the assignment of left/right key to the noKey (here P); right keys will appear on the right on touch screens



___________________________________________________________________________________________________________________	

										*Choice Reaction Time Task*
										(subtest of COGDRAS)								
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-08-2020
last updated:  02-10-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-10-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a Choice Reaction Time Task, a subset of the 
Cognitive Drug Research Computerized Assessment System (COGDRAS).

Reference
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants are asked to press a certain response key (here: Q) whenever the word YES appears in the middle of
the  screen or press another response key (here: P) whenever the word NO appears.
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 2 minutes to complete

Note: the test can easily be aborted by pressing "Ctrl+Alt+A"
__________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________		
The fields in the data files are:

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

countTrials:						custom counter of test trials (those that present word "YES")
										
stimulusItem:						the presented stimuli in order of trial presentation
response:							the participant's response (scancode of response buttons)
										16 = Q
										
responseLabel:						"yes" or "no"								

correct:							1 = correct response
									0 = error response

latency: 							the response latency (in ms); measured from: onset of word YES

iti:								the intertrial interval (in ms) run at the end of the current trial


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

inquisit.version: 				the Inquisit build/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)

crtAcc:						the overall proportion correct responses in the Choice Reaction Time test (across yes/no trials)
									
crtRT:							the mean response time (in ms) of correct responses in the Choice Reaction Time test (across yes/no trials)	
								(measured from onset of word 'YES'/'NO' in the center of the screen)
							
							
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

1. Test
- 20 trials (editable parameters)
- half the trial present YES, the other half NO (order is randomly determined, see list.trialselector)

Trial sequence:
- word YES/NO appears (wait for response) -> random iti (1000-2500ms) -> word YES....

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited under section Editable Stimuli

The word YES/NO - size can be set under section Editable Parameters

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - 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:
//StimSize:
/ stimSize = 20%								//the proportional sizing of the yes/no-word on screen (default: 20%)

//Experimental Design Parameters:
/ nrTestTrials = 20							//the number of test trials run (default: 20)

//Response Keys:
/ leftKey = "Q"								//the left response key (here: Q)
/ rightKey = "P"								//the right response key (here: P)
/ yesKey = parameters.leftKey				//the assignment of left/right key to the yesKey (here Q); left keys will appear on the left on touch screens
/ noKey = parameters.rightKey				//the assignment of left/right key to the noKey (here P); right keys will appear on the right on touch screens



___________________________________________________________________________________________________________________	

											*Memory Scan Task*
											(subtest of COGDRAS)												
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-09-2020
last updated:  02-10-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-10-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a Memory Scan Task, a subset of the 
Cognitive Drug Research Computerized Assessment System (COGDRAS).

Reference
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants view an initial triplet of digits (presented serially, one after other).
They then view a series of 18 digits and have to decide whether the digit was one of the three by pressing
a Yes or a No-key.

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

Note: the test can easily be aborted by pressing "Ctrl+Alt+A"
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________		
The fields in the data files are:

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

trialCode:							"target" vs. "foil"
targetDigits:						the three target digits
										
stimulusItem:						the presented digits

response:							the participant's response (scancode of response buttons)
										16 = Q
										25 = P
										57 = spacebar
										
responseLabel:						"yes" vs. "no"	

responseCategory:					"Hit" (pressed yes-key for a target digit)
									"Miss" (pressed no-key for a target digit) = omission error
									"CR" (pressed no-key for a foil digit) = correct rejection
									"FA" (pressed yes-key for a foil digit) = commission error															
										
correct:							accuracy of response: 1 = correct response; 0 = otherwise
latency: 							the response latency (in ms); measured from: onset of words

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

inquisit.version: 					the Inquisit build/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)
									
msAcc:								proportion correct recognition (across old and new words) in Immediate Word Recognition Test 

msRT:								mean response time (in ms) of correct responses (across old and new words) 
									during recognition phase in Immediate Word Recognition Test	
		
msHitRT:							mean response time (in ms) of correct responses for old words only
		
rHIT: 								the hitrate (proportion correct responses for old words => participant said 'yes' to old words)
rFA:								the false alarm rate (proportion of incorrect responses for new words => participants said 'yes' to new words) 

msAPrime:							non-parametric measure of sensitivity in Immediate Word Recognition Test
									Range: 0 (all incorrect responses) -  0.5 (random responses) -  1 (all correct responses)
									For Aprime measure see: 
									Stanislaw, H. & Todorov, N. (1999). Calculation of signal detection theory measures.
									Behavior Research Methods, Instruments, & Computers, 1999, 31 (1), 137-149.
									Note: Nicholl et al (1995) used the non-parametric signal theory index
									(SI) presented by Frey and Colliver (1973) with a range of -1 (all incorrect) to 1 (all correct)									
							
							
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

(1) Target Digit Learning
- three digits are randomly (without replacement) selected from 1-9
Note: this script places the following constraint on the sampling process:
The last sampled digit cannot be the third of three consecutive digits.
Example: targetdigit = 4, targetdigit2 = 3
=> the third targetdigit cannot be 2 nor 5.

- each digit is presented for 2500ms (duration parameters editable, see section Editable Parameters)

(2) MS Test
- 18 trials: digits 1-9 are randomly selected 
Note: trial 1-9 randomly samples digit 1-9 (without replacement); trial 10-18 randomly samples 1-9 (without replacement)
=> 6 target trials; 12 foil trials (target:foil = 1:2)
- digits are presented as long as needed to make response

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited under section Editable Stimuli

The size of the presented digits can be set under section Editable Parameters
___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - 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:

//StimSize:
/ stimSize = 20%								//the proportional sizing of the yes/no-word on screen (default: 20%)

//Experimental Design Parameters:
/ nrTestTrials = 18							//the number of test trials run (default: 18)

//Duration Parameters:
/ firstStimDelay = 1000						//the delay (in ms) of the first stim after pressing spacebar to start
/ soa = 2500									//stimulus onset asynchrony (in ms) of the target triplets (default: 2500ms)
/ stimDuration = 2500						//the duration (in ms)	that each target digit is presented (default: 2500ms)	
											//Note: stimDuraton cannot exceed SOA

//Response Keys:
/ leftKey = "Q"								//the left response key (here: Q)
/ rightKey = "P"								//the right response key (here: P)
/ yesKey = parameters.leftKey				//the assignment of left/right key to the yesKey (here Q); left keys will appear on the left on touch screens
/ noKey = parameters.rightKey				//the assignment of left/right key to the noKey (here P); right keys will appear on the right on touch screens




___________________________________________________________________________________________________________________	

										*Delayed Word Recognition*
										(subtest of COGDRAS)										
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-09-2020
last updated:  02-10-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-10-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a procedure to test Delayed Word Recognition.
Delayed Word Recognition is a subset of the 
Cognitive Drug Research Computerized Assessment System (COGDRAS).

Reference
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.
___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants are given 24 words (12 old, 12 new) in randomized order and are asked to press a dedicated
YES-key for words previously seen and press a dedicated NO-key for new words.
The 'old' words were previously presented during the Immediate Word Recognition Task.
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 2 minutes to complete

Note: the test can easily be aborted by pressing "Ctrl+Alt+A"
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONAIRY
___________________________________________________________________________________________________________________		
The fields in the data files are:

(1) Raw data file: 'delayedwordrecognition_cogdras_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. 
										
stimulusitem:						the presented words

response:							the participant's response (scancode of response buttons)
										16 = Q
										25 = P
										57 = spacebar
										
responseLabel:						"yes" vs. "no"	

responseCategory:					"Hit" (pressed yes-key for a target word)
									"Miss" (pressed no-key for a target word) = omission error
									"CR" (pressed no-key for a foil word) = correct rejection
									"FA" (pressed yes-key for a foil word) = commission error															
										
correct:							accuracy of response: 1 = correct response; 0 = otherwise
latency: 							the response latency (in ms); measured from: onset of words

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

inquisit.version: 					the Inquisit build/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)
									
DREC_ACC:							proportion correct recognition (across target and foil words) in delayed Word Recognition Test 

DREC_RT:							mean response time (in ms) of correct responses (across target and foil words) 
									during recognition phase in delayed Word Recognition Test	
		
DREC_hitRT:							mean response time (in ms) of correct responses for target words only
		
rHIT: 								the hitrate (proportion correct responses for target words => participant said 'yes' to target words)
rFA:								the false alarm rate (proportion of incorrect responses for foil words => participants said 'yes' to foil words) 

DREC_Aprime:						non-parametric measure of sensitivity in delayed Word Recognition Test
									Range: 0 (all incorrect responses) -  0.5 (random responses) -  1 (all correct responses)
									For Aprime measure see: 
									Stanislaw, H. & Todorov, N. (1999). Calculation of signal detection theory measures.
									Behavior Research Methods, Instruments, & Computers, 1999, 31 (1), 137-149.
									Note: Nicholl et al (1995) used the non-parametric signal theory index
									(SI) presented by Frey and Colliver (1973) with a range of -1 (all incorrect) to 1 (all correct)
									
													
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

(1) Recognition Test
- 12 target words (from previous Immediate Word Recognition Test) and 12 foil (=new)) words are presented, 
one-by-one in the middle of the screen; order is randomly determined
- participant respond by pressing 'Q' for yes (it's a target) or 'P' for no (it's a foil/not a target)
___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited under section Editable Stimuli

The current words provided in this script were taken from:
McEvoy, C. L., & Nelson, D. L. (1982). Category name and instance norms for 106 categories of various sizes. 
American Journal of Psychology, 95, 581-634.
Nairne, J. S. (1990). A feature model of delayed memory. Memory and Cognition, 18, 251-269.

The 12 target words are the same targets words as used in the Inquisit Immediate Word Recognition Test script
(immediatewordrecognition_cogdras.iqjs)

The words can easily be exchanged for others.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - 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.

//StimSize:
/ stimSize = 10%							//the proportional sizing of the words (default: 10%)

//Duration Parameters
/ firstStimDelay = 1000						//the delay (in ms) of the first stim after pressing spacebar to start

//Response Keys:
/ leftKey = "Q"								//the left response key (here: Q)
/ rightKey = "P"								//the right response key (here: P)
/ yesKey = parameters.leftKey				//the assignment of left/right key to the yesKey (here Q); left keys will appear on the left on touch screens
/ noKey = parameters.rightKey				//the assignment of left/right key to the noKey (here P); right keys will appear on the right on touch screens




___________________________________________________________________________________________________________________	

										*Picture Recognition*
										(subtest of COGDRAS)
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-09-2020
last updated:  02-10-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-10-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a procedure to test Picture Recognition.
Picture Recognition is a subset of the 
Cognitive Drug Research Computerized Assessment System (COGDRAS).

Reference
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants are given 28 pictures (14 old, 14 new) in randomized order and are asked to press a dedicated
YES-key for pictures previously seen and press a dedicated NO-key for new pictures.
The 'old' words were previously presented during the Picture Presentation Phase.

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

Note: the test can easily be aborted by pressing "Ctrl+Alt+A"

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

(1) Raw data file: 'picturerecognition_cogdras_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. 
										
stimulusItem:						the presented pictures

response:							the participant's response (scancode of response buttons)
										16 = Q
										25 = P
										57 = spacebar
										
responseLabel:						"yes" vs. "no"	

responseCategory:					"Hit" (pressed yes-key for a target picture)
									"Miss" (pressed no-key for a target picture) = omission error
									"CR" (pressed no-key for a foil picture) = correct rejection
									"FA" (pressed yes-key for a foil picture) = commission error															
										
correct:							accuracy of response: 1 = correct response; 0 = otherwise
latency: 							the response latency (in ms); measured from: onset of pictures


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

inquisit.version: 					the Inquisit build/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)
																		
dpicAcc:							proportion correct recognition (across target and foil pictures) in Delayed Picture Recognition Test 

dpicRT:							mean response time (in ms) of correct responses (across target and foil pictures) 
									during recognition phase in Delayed Picture Recognition Test	
		
dpicHitRT:							mean response time (in ms) of correct responses for target pictures only
		
rHIT: 								the hitrate (proportion correct responses for target pictures => participant said 'yes' to target pictures)
rFA:								the false alarm rate (proportion of incorrect responses for foil pictures => participants said 'yes' to foil pictures) 

dpicAPrime:						non-parametric measure of sensitivity in Delayed Picture Recognition Test
									Range: 0 (all incorrect responses) -  0.5 (random responses) -  1 (all correct responses)
									For Aprime measure see: 
									Stanislaw, H. & Todorov, N. (1999). Calculation of signal detection theory measures.
									Behavior Research Methods, Instruments, & Computers, 1999, 31 (1), 137-149.
									Note: Nicholl et al (1995) used the non-parametric signal theory index
									(SI) presented by Frey and Colliver (1973) with a range of -1 (all incorrect) to 1 (all correct)							
							
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

(1) Delayed Picture Recognition Test
- 28 trials: 14 target ('old') pictures and 14 foil ('new') pictures; order randomized

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited under section Editable Stimuli

The images provided with this script are digitalized versions (300px x 300px) of the pictures presented by:
Snodgrass, J. G., & Vanderwart, M. (1980). A standardized set of 260 pictures: Norms for name agreement, 
image agreement, familiarity, and visual complexity. Journal of Experimental Psychology:
Human Learning & Memory, 6, 174-215.

The size of the images can be edited under section Editable Parameters.
The 14 'old' pictures are assumed to have been presented by script picturepresentation_cogdras.iqjs
___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - 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:

//StimSize:
/ stimSize = 40%								//the proportional sizing of the words (default: 40%)

//Duration Parameters
/ firstStimDelay = 1000						//the delay (in ms) of the first stim after pressing spacebar to start

//Response Keys:
/ leftKey = "Q"								//the left response key (here: Q)
/ rightKey = "P"								//the right response key (here: P)
/ yesKey = parameters.leftKey				//the assignment of left/right key to the yesKey (here Q); left keys will appear on the left on touch screens
/ noKey = parameters.rightKey				//the assignment of left/right key to the noKey (here P); right keys will appear on the right on touch screens



___________________________________________________________________________________________________________________	

							*Millisecond Software COGDRAS Summary Script*
							(helper script to collect summary data)
___________________________________________________________________________________________________________________	

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

Script Copyright © 04-11-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script collects summary data from Millisecond Software's version of the 
Cognitive Drug Research Computerized Assessment System (COGDRAS). 

Reference
Nicholl, C.G. et al (1995). THE COGNITIVE DRUG RESEARCH COMPUTERIZED ASSESSMENT SYSTEM IN SPEED OF THE ESSENCE?
THE EVALUATION OF EARLY DEMENTIA. 
INTERNATIONAL JOURNAL OF GERIATRIC PSYCHIATRY, VOL. 10: 199-206.
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONAIRY
___________________________________________________________________________________________________________________		
The fields in the data files are:

(1) Data file: 'mscogdras_summary_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


//Immediate Word Recognition Test:

IREC_ACC:							proportion correct recognition (across target and foil words) in Immediate Word Recognition Test 

IREC_RT:							mean response time (in ms) of correct responses (across target and foil words) 
									during recognition phase in Immediate Word Recognition Test	
		
IREC_hitRT:							mean response time (in ms) of correct responses for target words only
		
IREC_Aprime:						non-parametric measure of sensitivity in Immediate Word Recognition Test
									Range: 0 (all incorrect responses) -  0.5 (random responses) -  1 (all correct responses)
									For Aprime measure see: 
									Stanislaw, H. & Todorov, N. (1999). Calculation of signal detection theory measures.
									Behavior Research Methods, Instruments, & Computers, 1999, 31 (1), 137-149.
									Note: Nicholl et al (1995) used the non-parametric signal theory index
									(SI) presented by Frey and Colliver (1973) with a range of -1 (all incorrect) to 1 (all correct)


//Number Vigilance Test:

VIG_ACC:							the hitrate (proportion of targets that were correctly responded to) in Number Vigilance Test
VIG_FA:								the number of false alarm responses in Number Vigilance Test
VIG_FArate:							the false alarm rate in Number Vigilance Test
VIG_RT:								the mean response time (in ms) of correctly responding to a target in Number Vigilance Test


//Simple Reaction Time Test:

SRT_RT:								the mean response time (in ms) in the Simple Reaction Time test		
									(measured from onset of word 'YES' in the center of the screen)
									
//Choice Reaction Time Test:
crtAcc:							the overall proportion correct responses in the Choice Reaction Time test (across yes/no trials)
									
crtRT:								the mean response time (in ms) of correct responses in the Choice Reaction Time test (across yes/no trials)	
									(measured from onset of word 'YES'/'NO' in the center of the screen)	
		

//Memory Scan Test:

MS_ACC:								proportion correct recognition (across old and new words) in Immediate Word Recognition Test 

MS_RT:								mean response time (in ms) of correct responses (across old and new words) 
									during recognition phase in Immediate Word Recognition Test	
		
MS_hitRT:							mean response time (in ms) of correct responses for old words only
		
MS_Aprime:							non-parametric measure of sensitivity in Immediate Word Recognition Test
									Range: 0 (all incorrect responses) -  0.5 (random responses) -  1 (all correct responses)
									For Aprime measure see: 
									Stanislaw, H. & Todorov, N. (1999). Calculation of signal detection theory measures.
									Behavior Research Methods, Instruments, & Computers, 1999, 31 (1), 137-149.
									Note: Nicholl et al (1995) used the non-parametric signal theory index
									(SI) presented by Frey and Colliver (1973) with a range of -1 (all incorrect) to 1 (all correct)
							
					
//Delayed Word Recognition Test:	
				
DREC_ACC:							proportion correct recognition (across target and foil words) in Delayed Word Recognition Test 

DREC_RT:							mean response time (in ms) of correct responses (across target and foil words) 
									during recognition phase in Delayed Word Recognition Test	
		
DREC_hitRT:							mean response time (in ms) of correct responses for target words only
		
DREC_Aprime:						non-parametric measure of sensitivity in Delayed Word Recognition Test
									Range: 0 (all incorrect responses) -  0.5 (random responses) -  1 (all correct responses)
									For Aprime measure see: 
									Stanislaw, H. & Todorov, N. (1999). Calculation of signal detection theory measures.
									Behavior Research Methods, Instruments, & Computers, 1999, 31 (1), 137-149.
									Note: Nicholl et al (1995) used the non-parametric signal theory index
									(SI) presented by Frey and Colliver (1973) with a range of -1 (all incorrect) to 1 (all correct)
									
//Delayed Picture Recognition:	

DPIC_ACC:							proportion correct recognition (across target and foil pictures) in Delayed Picture Recognition Test 

DPIC_RT:							mean response time (in ms) of correct responses (across target and foil pictures) 
									during recognition phase in Delayed Picture Recognition Test	
		
DPIC_hitRT:							mean response time (in ms) of correct responses for target pictures only
		
rHIT: 								the hitrate (proportion correct responses for target pictures => participant said 'yes' to target pictures)
rFA:								the false alarm rate (proportion of incorrect responses for foil pictures => participants said 'yes' to foil pictures) 

DPIC_Aprime:						non-parametric measure of sensitivity in Delayed Picture Recognition Test
									Range: 0 (all incorrect responses) -  0.5 (random responses) -  1 (all correct responses)
									For Aprime measure see: 
									Stanislaw, H. & Todorov, N. (1999). Calculation of signal detection theory measures.
									Behavior Research Methods, Instruments, & Computers, 1999, 31 (1), 137-149.
									Note: Nicholl et al (1995) used the non-parametric signal theory index
									(SI) presented by Frey and Colliver (1973) with a range of -1 (all incorrect) to 1 (all correct)