Data Export - Observations
Observation
Generated by the Bulk Data Export system.
The order of columns is subject to change. When parsing files, please ensure to use headers rather than positional parsing to ensure you are reading the data correctly.
What this export contains
One row per observation, a score or derived value calculated from a questionnaire, for example the total score on a PHQ-9. It carries the value, score type, domain and validity. This is where the numeric results of assessments live.
Example questions this export can answer
- Pull PHQ-9, GAD-7 or other scale scores over time for a patient or population
- Track average severity scores by site, provider or diagnosis
- Build your own symptom-trajectory analysis from raw score values
| Property | Name | Field Type | Cardinality | Notes | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| instituteid | Institute Id | identifier | 1..* | |||||||
| instituteShortcode | Institute Shortcode | String | 1..* | |||||||
| id | Id | identifier | 1..1 | |||||||
| subectId | Subject Id | identifier | 1..1 | |||||||
| diagnosticReportId | Diagnostic Report Id | identifier | 1..1 | Diagnostic Report | ||||||
| performerType | Performer Type | enum | 1..1 | patient | practitioner | relatedPerson | |||||
| performerId | Performer Id | identifier | 1..1 | The Id of a Patient, Practitioner, or a Related Person | ||||||
| value | Value | string | 0..1 | |||||||
| questionnaireId | Questionnaire Id | identifier | 1..1 | |||||||
| domain | Domain | enum | 1..1 | complexity | normed | severity | average | interpreted | composite | raw | patientAdjustment |
| population | Population Mnemonic | string | 0..1 | Human readable name for population normed on | ||||||
| validity | Validity | enum | 1..1 | invalid | valid | not_applicable | not_administered |
Domain Values and Descriptions
| Domain | Description |
|---|---|
| complexity | Internal Mirah scorer type for showing subject complexity |
| normed | Based on normative data for a population |
| severity | Internal Mirah scorer type for showing subject severity |
| average | Currently only used as part of goals scoring |
| interpreted | A categorical score with no numerical meaning |
| composite | Combined of many other data, currently used by the CAMS |
| raw | Raw score value |
| patientAdjustment | Used to set the per-patient adjustment on the CAMS |