Symbol Search
A processing speed task from the m2c2kit library. Participants see a set of symbol pairs at the top of the screen and must quickly identify which of two bottom pairs matches one of the top pairs.
- Duration: ~60 s
- Source: m2c2kit
- Deployed version:
assessment-symbol-search@0.8.33 - Launch URL: https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-symbol-search@0.8.33/
Example URL commands
# Plain launch (debug mode: results shown on-screen)
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-symbol-search@0.8.33/
# With camera recording
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-symbol-search@0.8.33/?webcam=1
# With eye tracking
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-symbol-search@0.8.33/?webgazer=1
# Customized assessment parameters (values shown are the defaults)
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-symbol-search@0.8.33/?number_of_top_pairs=3&lure_percent=0.5&left_correct_percent=0.5
# Production: submit results to your server
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-symbol-search@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. |
webcam | string | — | Set to 1 or true to enable optional camera recording. Participants see a consent prompt; if they accept, the front camera records and the video is saved locally to their device at session end. |
webgazer | string | — | Set to 1 or true to enable browser-based eye tracking via WebGazer.js. Participants see a consent prompt, then a 5-point gaze calibration. Gaze coordinates are recorded throughout the task and exported as a CSV file at session end. Can be combined with webcam=1. |
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 |
|---|---|---|---|---|
number_of_top_pairs | integer | 3 | ✅ | Number of pairs to be shown on top. (1-4) Allowed values: 1, 2, 3, 4. |
lure_percent | number | 0.5 | ✅ | Percentage of lure trials. Number from 0 to 1. A lure trial is when the incorrect symbol pair on the bottom contains exactly one symbol that is found on the top.(1 unique symbol). A non-lure trial is when the incorrect symbol pair contains exactly zero symbols that match the top. (2 unique symbols.) |
lure_position_on_card | string | either | ✅ | If a lure trial, must the lure symbol occupy the top position on the the card, the bottom, or either? If either, then the lure symbol will be equally distributed across trials to be in the top and bottom positions. Allowed values: "top", "bottom", "either". |
left_correct_percent | number | 0.5 | ✅ | Percentage of trials where the left pair is the correct answer. Number from 0 to 1. |
countdown_duration_ms | number | 3000 | ✅ | Duration of the countdown phase, milliseconds. Multiples of 1000 recommended. |
after_countdown_transition_duration_ms | number | 500 | ✅ | Duration, in milliseconds, of the slide in animation after the countdown phase. |
number_of_trials | integer | 12 (site override; package default 20) | ✅ | How many trials to run. |
interstimulus_animation | boolean | true | ✅ | Should new trials slide in from right to left? |
interstimulus_interval_duration_ms | number | 500 | ✅ | If interstimulus_animation == true, the duration, in milliseconds, of the slide in animation after each trial. Otherwise, the duration, in milliseconds, to wait after a trial has been completed until a new trial appears. |
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_trials_complete_scene | boolean | false (site override; package default true) | ✅ | After the final trial, should a completion scene be shown? Otherwise, the game will immediately end. |
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? |
scoring | boolean | false | ✅ | Should scoring data be generated? Default is false. |
scoring_filter_response_time_duration_ms | array | [100,10000] | ✅ | When scoring, values of response_time_duration_ms less than the lower bound or greater than the upper bound are discarded. This array contains two numbers, the lower and upper bounds. |
seed | string or null | null | ✅ | Optional seed for the seeded pseudo-random number generator. When null, the default Math.random() is used. |
Generated from dist/modules/@m2c2kit/assessment-symbol-search@0.8.33/dist/index.js and dist/assessments/@m2c2kit/assessment-symbol-search@0.8.33/index.js. Do not edit by hand.