Color Dots
A processing speed task from the m2c2kit library. Participants briefly see an array of colored dots, then after a short blank interval must recall the color of a specific dot. Measures speed and accuracy of color–location binding.
- Duration: ~60 s
- Source: m2c2kit
- Deployed version:
assessment-color-dots@0.8.33 - Launch URL: https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-color-dots@0.8.33/
Example URL commands
# Plain launch (debug mode: results shown on-screen)
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-color-dots@0.8.33/
# Customized assessment parameters (values shown are the defaults)
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-color-dots@0.8.33/?fixation_duration_ms=500&dot_diameter=48&number_of_dots=3
# Production: submit results to your server
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-color-dots@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.
| Parameter | Type | Default | Description |
|---|---|---|---|
callback_url | string | — | URL to POST results to when the assessment ends. |
pid | string | — | 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. |
token | string | — | 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.
| Parameter | Type | Default | URL | Description |
|---|---|---|---|---|
fixation_duration_ms | number | 500 | ✅ | How long fixation scene is shown, milliseconds. |
dot_colors | array | [{"colorName":"black","rgbaColor":[0,0,0,1]},{"colorName":"green","rgbaColor":[0,158,115,1]},{"colorName":"yellow","rgbaColor":[240,228,66,1]},{"colorName":"blue","rgbaColor":[0,114,178,1]},{"colorName":"orange","rgbaColor":[213,94,0,1]},{"colorName":"pink","rgbaColor":[204,121,167,1]}] | ✅ | Array of colors for dots. |
dot_diameter | number | 48 | ✅ | Diameter of dots. |
number_of_dots | integer | 3 | ✅ | How many dots to present. Must be at least 3. |
dot_present_duration_ms | number | 1000 | ✅ | How long the dots are shown, milliseconds. |
dot_blank_duration_ms | number | 750 | ✅ | How long to show a blank square after dots are removed, milliseconds. |
color_selected_hold_duration_ms | number | 500 | ✅ | How long to show a square with the dot colored by the user's choice, before advancing to next scene, milliseconds. |
number_of_trials | integer | 12 (site override; package default 5) | ✅ | How many trials to run. |
show_trials_complete_scene | boolean | true | ✅ | After the final trial, should a completion scene be shown? Otherwise, the game will immediately end. |
instruction_type | string | long | ✅ | Type of instructions to show, 'short' or 'long'. Allowed values: "short", "long". |
instructions | object or null | null | ✅ | When non-null, an InstructionsOptions object that will completely override the built-in instructions. |
show_quit_button | boolean | false | ✅ | Should the activity quit button be shown? |
show_fps | boolean | false | ✅ | Should the FPS be shown? |
show_locale_picker | boolean | false | ✅ | Should the icon that allows the participant to switch the locale be shown? |
seed | string or null | null | ✅ | Optional seed for the seeded pseudo-random number generator. When null, the default Math.random() is used. |
scoring | boolean | false | ✅ | Should scoring data be generated? Default is false. |
Generated from dist/modules/@m2c2kit/assessment-color-dots@0.8.33/dist/index.js and dist/assessments/@m2c2kit/assessment-color-dots@0.8.33/index.js. Do not edit by hand.