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


___________________________________________________________________________________________________________________	

								MR PEANUT TASK (MrPeanut-C)
				- a test of visuo-spatial memory in children with color component-
										(German version)
___________________________________________________________________________________________________________________	


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

Script Copyright © 10-03-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	
This script runs a computerized version of the "MrPeanut task-C", a task of visuo-spatial memory 
of colored information 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 view a clown figure called "Mr Peanut" who decorates himself with colorful
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 
select a sticker color and 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. 15 minutes to complete
(depends on level)

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

(1) Raw data file: 'mrpeanut_c_german_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
countcorr_colors:				counts the correct colors chosen
countcorr_colorstickers: 		counts the correctly placed stickers of the correct color per attempt

errorattempt:					1 = error; (overall error evaluation)
								0 = correct (color and 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_color -
nose_color: 					variables that store whether the currently presented Mr Peanut presented the following stickers
								color name = a colored sticker of that color was presented on respective body part
								0 = no sticker on body part was presented
								
leg_l_selectedColor-
nose_selectedColor:				color name = body part was decorated with a sticker of that color; 
								0 = body part was not decorated								
																
presentedColors_list:			a string variable containing all the presented colors
selectedColors_list:			a string variable containing all the selected colors


(2) Summary data file: 'mrpeanut_c_german_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 select colors and point to the sticker positions (with the mouse) 
while the decorated Mr Peanut is still visible. At this point in practice, only correct selections 
are accepted (if incorrect stickers are selected, they are NOT placed on the empty Mr Peanut)

2. Practice (3 trials):
-> participants have to select colors and place the stickers on the empty Mr Peanut
-> Participants can correct sticker placements by selecting already placed stickers. This re-selection
results in the deletion of this particular sticker.
-> a practice trial lasts until the 'done' button is selected
-> Incorrect attempts 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".
A posttrialpause of 1000ms (editable parameter; can be increased or decreased) is added to wipe out iconic memory.
-> trial.recall: lets participants select the 14 different body parts.
Selections can be changed until the "done" button is selected.
Note: participants can select up to 14 stickers for each trial.
-> trial.summary: assesses the accuracy of the responses (both locations AND sticker colors have to be correctly recalled and 
the number of selected stickers has to match the number of presented stickers)

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 point (depends on parameters.trialsperlevel) 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:
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/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