Skip to main content

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
PropertyNameField TypeCardinalityNotes
instituteidInstitute Ididentifier1..*
instituteShortcodeInstitute ShortcodeString1..*
idIdidentifier1..1
subectIdSubject Ididentifier1..1
diagnosticReportIdDiagnostic Report Ididentifier1..1Diagnostic Report
performerTypePerformer Typeenum1..1patient | practitionerrelatedPerson
performerIdPerformer Ididentifier1..1The Id of a Patient, Practitioner, or a Related Person
valueValuestring0..1
questionnaireIdQuestionnaire Ididentifier1..1
domainDomainenum1..1complexity | normedseverityaverageinterpretedcompositerawpatientAdjustment
populationPopulation Mnemonicstring0..1Human readable name for population normed on
validityValidityenum1..1invalid | validnot_applicablenot_administered

Domain Values and Descriptions​

DomainDescription
complexityInternal Mirah scorer type for showing subject complexity
normedBased on normative data for a population
severityInternal Mirah scorer type for showing subject severity
averageCurrently only used as part of goals scoring
interpretedA categorical score with no numerical meaning
compositeCombined of many other data, currently used by the CAMS
rawRaw score value
patientAdjustmentUsed to set the per-patient adjustment on the CAMS