User Manual: Inquisit Mr. Peanut Test of Visualspatial Memory in Children (Location)


___________________________________________________________________________________________________________________	

									MR PEANUT TEST (MrPeanut-P)
							- a test of visuo-spatial memory in children-	
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 01-22-2015
last updated:  02-25-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-25-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script runs a computerized version of the "MrPeanut task-P", a task of visuo-spatial memory 
for children.

The implemented procedure is based on the following publications:

(1) DE RIBAUPIERRE, Anik, BAILLEUX, Christine. Development of attentional capacity in
childhood: A longitudinal study. In: Weinert, F.E. & Schneider, W. Memory performance and
competencies: Issues in growth and development. Mahwah NJ : Lauwrence Erlbaum,
1995. p. 45-70

and 

(2) Morra S. (1994). Issues in working memory measurement: Testing for M capacity. 
International Journal of Behavioral Development, 17, 143-159 (see MrCucumber Test)

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants see a clown figure called "Mr Peanut" who decorates himself with purple
stickers (in this script: 14 possible locations) for a set amount of time. 
Then Mr Peanut disappears and reappears without stickers. Participants are asked to click on the locations 
of the stickers as they recall them. Incorrect selections can be corrected (selecting a body part that 
already has a sticker results in sticker deletion). Recall for one image is over if a "Done"
button is selected. This is NOT a timed task.

In this script: 2 ways of testing (see section Editable Values -> parameters.progressivetesting)

1) progressive testing (see Morra, 1994): levels (1-7) are tested progressively. Participants get 3 trials per level.
If a level is successfully mastered (at least one correct attempt per level), participants move up a level.
If all 3 attempts per level fail, the test concludes. A values.progressivetotalscore is calculated based on the
rules outlined by Morra (1994):
* for consecutive levels for which participant gets over 50% (for 3 trials -> 2/3) of the trials correct -> assign 1
* for remaining levels: add 1/3 point (depends on parameters.trialsperlevel) for each correct response per level
The order of the images is predetermined for the progressive testing mode (default setting)

2) all 21 images (7 levels * 3 images/level) are tested according to settings of list.indexsequence
(see section Editable Lists -> Test Lists for more information) (either in random order or in a pre-determined order).
This set-up is more in line with De Ribaupierre & Bailleux (1995).

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 10 minutes to complete
(depends on number of levels tested)

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

(1) Raw data file: 'mrpeanut_p_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. 
																				
										
Parameter-progressivetesting:	true (1) (default setting) = levels are tested progressively with 3 trials per level (if all three attempts fail at a level, the test concludes)
								false (0) = 21 images are tested (7 levels * 3 images per level) in a random order
									
attempts/
totaltrials:					tracks the number of attempts/trials started across levels

picpresentationtime:			duration in ms that current Mr Peanut is presented
index:							the currently selected image index number
										1, 2, 3 => 3 images for level 1
										4, 5, 6 => 3 images for level 2
										7, 8, 9 => 3 images for level 3
										10, 11, 12 => 3 images for level 4
										13, 14, 15 => 3 images for level 5
										16, 17, 18 => 3 images for level 6
										19, 20, 21 => 3 images for level 7
										
level:							current level tested (1-7)
count_stickers:					counts the number of stickers placed on the current Mr Peanut
countcorr_stickers:				counts the correctly placed stickers per attempt on the current Mr Peanut

errorattempt:					1 = error; (overall error evaluation)
								0 = correct (placement of the correct number of stickers was correct)
																										
consecutivescoring:				tracks whether consecutive scoring still applies to the current level
correctperlevel:				sums up the correct responses per level										
									
progressivetotalscore:			scoring for progressive testing: (see Morra, 1994)
								* for consecutive levels for which participant gets over 50% (for 3 trials -> 2/3) 
								of the trials correct -> assign 1
								* for remaining levels: add 1/3 point for each correct response per level 
								(depends on Parameter-trialsperlevel)
										
correctattempts: 				calculates the number of correct attempts										
										
finallevel:						highest successful (at least one correct response) level
responsestring:					stores all the selected body parts of the current picture in the order they were selected/de-selected
stop:							1 = stop condition has been met; 0 = otherwise


Information about the currently presented image:
nr_stickers:					stores the number of stickers of the currently presented Mr Peanut
leg_L -
arm_L: 							variables that store whether the currently presented Mr Peanut presented the following stickers
								1 = a sticker was presented on respective body part
								0 = no sticker on body part was presented
leg_R_selected-
arm_L_selected:					1 = respective body part was decorated by participant with a sticker; 
								0 = body part was not decorated by participant							


(2) Summary data file: 'mrpeanut_p__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)
									
Parameter-progressivetesting:	true (1) (default setting) = levels are tested progressively with 3 trials per level (if all three attempts fail at a level, the test concludes)
								false (0) = 21 images are tested (7 levels * 3 images per level) in a random order
									
Parameter-maxlevel:				maximumm number of levels tested (default: 7)
finallevel:						highest successful (at least one correct response) level
totaltrials:					tracks the number of trials across levels
errorattempts:					calculates the number of incorrect attempts
correctattempts:				the number of correct attempts

progressivetotalscore:			scoring for progressive testing: (see Morra, 1994)
								* for consecutive levels for which participant gets over 50% (for 3 trials -> 2/3) 
								of the trials correct -> assign 1
								* for remaining levels: add 1/3 point for each correct response per level 
								(depends on Parameter-trialsperlevel)

	
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

1. Instructions: includes a training to point to the sticker positions while the decorated Mr Peanut is still visible
2. Practice (3 trials):
-> Incorrect trials are repeated until correct
3. Test: 7 levels with 3 trials each
-> trial.presentpic: retrieves relevant sticker information for this picture and decorates the empty Mr. Peanut picture accordingly.
The duration of trial.presentpic can be set separately for each level under section "Editable Values".
-> trial.recall: lets participants select the 14 different body parts.
Selections can be changed until the "done" button is selected.
-> trial.summary: assesses the accuracy of the responses

DV (progressive testing): values.progressivetotalscore (see Morra, 1994)
scoring for progressive testing: 
* for consecutive levels for which participant gets over 50% (for 3 trials -> 2/3) of the trials correct -> assign 1
* for remaining levels: add 1/3 (depends on parameters.trialsperlevel) point for each correct response per level 

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
under Editable Code -> Editable Stimuli -> item.mrPeanut
See section "Editable Lists" for lists that control the number and location of stickers for 
practice and test sessions. Lists can be edited if different sticker arrangements should be run.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software under Editable Code -> Editable Instructions
The instructions are based on those used by Dr. S. Morra.

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

/progressivetesting:				true (default setting) = levels are tested progressively with 3 trials per level (if all three attempts fail at a level, the test concludes)
									false = 21 images are tested (7 levels * 3 images per level) in a random order

/picpresentationtime1-
/picpresentationtime7:				the time the current picture is presented in ms depending on level (default: 1000ms per sticker)

/recalldelay:						delay of recall trial in ms (default: 1000ms) to wipe out iconic memory
/iti:								the intertrial interval

/stickerheight:						controls the size of the response buttons; in % of canvas height (default: 10%)

/trialsperlevel:					number of images per level (default: 3)
										!Note: this should only be edited if the sticker lists under section "Editable Lists" are changed accordingly
										
/maxlevel:							maximumm number of levels tested (default: 7)
										!Note: this should only be edited if the sticker lists under section "Editable Lists" are changed accordingly