Skip to main content

Grid Memory

A spatial working memory task from the m2c2kit library. Participants see dots placed on a grid, perform an interference task, and then recall the dot locations from memory.

Example URL commands​

# Plain launch (debug mode: results shown on-screen)
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-grid-memory@0.8.33/

# Customized assessment parameters (values shown are the defaults)
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-grid-memory@0.8.33/?number_of_dots=3&preparation_duration_ms=500&blank_grid_duration_ms=500

# Production: submit results to your server
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-grid-memory@0.8.33/?token=<TOKEN>&callback_url=<CALLBACK_URL>

Session parameters​

Handled by the launch wrapper (results submission and optional sensors), not by the assessment itself.

ParameterTypeDefaultDescription
callback_urlstring—URL to POST results to when the assessment ends.
pidstring—Optional participant identifier. Echoed verbatim into the results: top-level pid next to token in the callback POST, inside data, and in the embed-mode postMessage. Useful when the callback endpoint does not mint per-participant tokens, or to link multi-session designs (e.g. FNAME-Pairs learning vs. delayed) from the URL alone.
tokenstring—Authentication token for results submission. When absent (along with callback_url), the assessment runs in debug mode and displays results on-screen instead of submitting them.

Assessment parameters​

Every parameter below can be set directly as a URL query parameter — the launch wrapper forwards all query parameters to the assessment.

ParameterTypeDefaultURLDescription
number_of_dotsinteger3✅Number of dots to present.
preparation_duration_msnumber500✅How long the 'get ready' message before each trial is shown, milliseconds.
blank_grid_duration_msnumber500✅How long a blank grid is shown before the dots appear, milliseconds.
interference_duration_msnumber8000✅How long the grid of interference targets is shown, milliseconds.
interference_transition_animationbooleantrue✅Should the transitions between dot presentation, interference, and recall be animated slide transitions?
dot_present_duration_msnumber3000✅How long the dots are shown, milliseconds.
number_of_interference_targetsinteger5✅How many targets to show in the interference phase.
number_of_trialsinteger12 (site override; package default 4)✅How many trials to run.
show_trials_complete_scenebooleantrue✅After the final trial, should a completion scene be shown? Otherwise, the game will immediately end.
instruction_typestringlong✅Type of instructions to show, 'short' or 'long'.
instructionsobject or nullnull✅When non-null, an InstructionsOptions object that will completely override the built-in instructions.
show_quit_buttonbooleanfalse✅Should the activity quit button be shown?
show_fpsbooleanfalse✅Should the FPS be shown?
show_locale_pickerbooleanfalse✅Should the icon that allows the participant to switch the locale be shown?
scoringbooleanfalse✅Should scoring data be generated? Default is false.
seedstring or nullnull✅Optional seed for the seeded pseudo-random number generator. When null, the default Math.random() is used.

Generated from dist/modules/@m2c2kit/assessment-grid-memory@0.8.33/dist/index.js and dist/assessments/@m2c2kit/assessment-grid-memory@0.8.33/index.js. Do not edit by hand.