Subtrial
Per-stage detail for trials composed of successive, dependent stages, each with its own stimulus → response → outcome cycle (e.g., the two-step task). The trial row in Response remains THE unit and carries the trial-level (aggregate or final) response and evaluation; each Subtrial row is a miniature trial anatomy for one stage.
note
Simple single-stage trials need no rows here (subtrial_count = 1 in the Response table).
note
The stage count of a trial is derived: subtrial_count = max subtrial_index among the trial's rows.
note
Do not confuse stages with the pieces of one response: a digit-span trial recalling "3-5-7" is ONE subtrial with response_count = 3 in the Response table; a two-step trial is TWO subtrials, each with its own stimulus and outcome.
Key
| Field | Type | Requirement | Description |
|---|---|---|---|
| subtrial_id | PRIMARY KEY | required | Primary key; each subtrial row has its own identifier, unique within the table. |
Context
| Field | Type | Requirement | Description |
|---|---|---|---|
| trial_index | id | required | Refers to the trial_index in the Response table and indicates which trial this stage belongs to. |
| response_id | id | optional | Refers to the response_id in the Response table for the parent trial's response row. |
| subtrial_index | index | required | The 1-based order of this stage within its trial (i.e., the first stage of a trial has subtrial_index = 1). |
| task_index | index | optional | When multitask_type is not empty, refers to the individual task this stage belongs to, so the same mechanism serves compound and concurrent multitasking. See task_index in the Response table. |
When
| Field | Type | Requirement | Description |
|---|---|---|---|
| onset | float | optional | Duration between the start of the trial and the start of this stage, in seconds. |
| duration | float | optional | How long this stage lasted, from its onset, in seconds. |
Stimulus
| Field | Type | Requirement | Description |
|---|---|---|---|
| stimulus_id | id | optional | The stimulus (or stimulus set/sequence) presented in this stage. |
Expectation
| Field | Type | Requirement | Description |
|---|---|---|---|
| expected_response_option_index | integer | optional | The index of the option the subject is expected to choose in this stage. Same conventions as the Response table's field of the same name. |
Response
| Field | Type | Requirement | Description |
|---|---|---|---|
| response_option_index | integer | optional | The index of the option the subject chose in this stage, starting from 1; 0 means none of the options was chosen. Same conventions as the Response table's field of the same name. |
| response_description | string | optional | A description of the subject's response in this stage; typically the description of the chosen option. |
| response_numeric | float | optional | A numeric value associated with this stage's response (e.g., a typed number or the numeric meaning of the selected option). |
| response_time | float | optional | The duration, in seconds, between the earliest possible time this stage's response could have been completed and the moment it was actually completed. |
Evaluation
| Field | Type | Requirement | Description |
|---|---|---|---|
| correct | boolean | optional | Whether this stage's response matches the expected response. |
| accuracy | float | optional | A task-dependent accuracy measure for this stage, ranging from 0 to 1 (inclusive). |
| score | float | optional | A numeric value associated with this stage's response in a given context. |
| evaluation_label | enum | optional | Evaluation label for this stage's response (e.g., correct, error, hit, miss). Same conventions as the Response table's field of the same name. |
Outcome
| Field | Type | Requirement | Description |
|---|---|---|---|
| outcome_description | string | optional | The observable consequence of this stage's response (e.g., the two-step's stage-1 transition, or stage-2 reward). |
| outcome_numeric | float | optional | A numeric value describing the observable consequence of this stage's response (e.g., +3 points). |