Lab Results
Source Object: Lab Results
Overview and Usage: The "Lab Results" source object within the athena EHR system plays a vital role in managing and storing laboratory test results. It contains detailed information about various lab tests and their outcomes. Key data fields include:
- Analytes (Abnormal Flag, HL7 Code, HL7 Name, Analyte Date, Analyte Datetime, Analyte ID, Analyte Name, Description, LOINC, Note, Observation Identifier, Reference Range, Result Status, Status, Units, Value): These fields store comprehensive data about the specific lab tests and their results, including abnormal flags, units, and reference ranges.
- Attachment Exists: Indicates whether attachments or additional documents are associated with the lab results.
- Description: Provides a brief description or summary of the lab results.
- Exact Duplicate Document ID: Stores the unique identifier of an exact duplicate document, if any.
- Facility ID: Identifies the healthcare facility where the lab tests were conducted.
- Internal Note: Allows for internal notes or comments related to the lab results.
- Interpretation Template: Refers to any predefined templates used for interpreting the lab results.
- Is Reviewed by Provider: Indicates whether the lab results have been reviewed by a healthcare provider.
- Lab Result Date and Datetime: Specifies the date and time when the lab results were obtained.
- Lab Result ID: A unique identifier for the lab result.
- Lab Result LOINC: Contains the LOINC (Logical Observation Identifiers, Names, and Codes) for standardizing lab test results.
- Lab Result Note: Provides additional notes or comments associated with the lab results.
- Order ID: Identifies the original order or request associated with these lab results.
- Patient Note: Allows for patient-specific notes or comments regarding the lab results.
- Performing Lab Address (Address1, Address2, City, Name, State, Zip): Indicates the address and location of the lab that conducted the tests.
- Priority: Specifies the priority level assigned to the lab results.
- Provider ID: Identifies the healthcare provider or clinician responsible for interpreting or discussing the lab results.
- Result Status: Describes the status of the lab results (e.g., preliminary, final, verified).
- Superseded Document ID: If applicable, references any documents that superseded or replaced these lab results.
Developers can leverage the "Lab Results" source object to build applications that allow healthcare professionals to view, interpret, and communicate lab test results effectively. This object streamlines the management of diagnostic information, ensuring that clinicians can make informed decisions based on accurate data.
Mapping Table
| Data Field | Example Value | Source Data Field Description | Source Field Data Type | Source Data Field Cardinality | Mapped FHIR++ Resource | Mapped FHIR Data Field | Augmented Mapping | Associated Coding System | Associated FHIR Data Field Extension | Mapping Context |
|---|---|---|---|---|---|---|---|---|---|---|
| analytes | - | Individual lab result observations/analytes. | Object | 0..* | Observation | - | - | - | - | Contained |
| analytes.abnormalflag | - | Status indicator of the measurement relative to normal (low, high, normal, abnormal). | String | 0..1 | Observation | interpretation | - | - | - | Contained |
| analytes.abnormalhl7code | - | The HL7 code related to the abnormal flag. | String | 0..1 | Observation | extension[*].valueString | - | - | abnormal-hl7-code | Contained |
| analytes.abnormalhl7name | - | The HL7 description related to the abnormal flag. | String | 0..1 | Observation | extension[*].valueString | - | - | abnormal-hl7-name | Contained |
| analytes.analytedate | - | Date when this observation was recorded. | String | 0..1 | Observation | extension[*].valueDate | - | - | analyte-date | Contained |
| analytes.analytedatetime | - | The date and time when this observation was recorded. Returned in mm/dd/yyyy hh24:mi:ss format. | String | 0..1 | Observation | effectiveDateTime | - | - | - | Contained |
| analytes.analyteid | - | athena ID for the given lab result observation/analyte. | Number | 0..1 | Observation | id | - | - | - | Contained |
| analytes.analytename | - | Name / description specific to this analyte. | String | 0..1 | Observation | code.coding[*].code.display | - | - | - | Contained |
| analytes.description | - | General description of the lab result test. | String | 0..1 | Observation | extension[*].valueString | - | - | description | Contained |
| analytes.loinc | - | Logical Observation Identifiers Names and Codes ID, if available. | String | 0..1 | Observation | code.coding[*].code | system=http://loinc.org | LOINC | - | Contained |
| analytes.note | - | Additional note for this analyte, if applicable. | String | 0..1 | Observation | note[*].text | - | - | - | Contained |
| analytes.observationidentifier | - | Local lab ID for the given lab result observation/analyte. | String | 0..1 | Observation | Observation.code.extension[*].valueString | - | - | observation-identifier | Contained |
| analytes.referencerange | - | Reference range of values accepted as normal for this observation. | String | 0..1 | Observation | Observation.referencerange[].low.value ,Observation.referencerange[].high.value | - | - | - | Contained |
| analytes.resultstatus | - | The status of the result (e.g., "final\ "preliminary\ "corrected\ etc.). | String | 0..1 | Observation | status | - | - | - | Contained |
| analytes.status | - | DEPRECATED -- use "abnormalflag" instead. Status indicator of the measurement relative to normal (low, high, normal, abnormal). | String | 0..1 | Observation | - | - | - | - | Contained |
| analytes.units | - | Units for this analyte entry, if provided by the lab. | String | 0..1 | Observation | Observation.referencerange[].low.unit ,Observation.referencerange[].high.unit | - | - | - | Contained |
| analytes.value | - | Value recorded for this observation. | String | 0..1 | Observation | valueQuantity.value | - | - | - | Contained |
| attachmentexists | - | This flag depicts if the lab result has a scanned document attachment or not. | String | 0..1 | DiagnosticReport | extension[*].valueString | - | - | attachment-exists | Top Level |
| description | - | Description for this lab result. | String | 0..1 | DiagnosticReport | code.coding.[*].display , code.text | - | - | - | Top Level |
| exactduplicatedocumentid | - | The exactduplicatedocumentid of the document. | Integer | 0..1 | DiagnosticReport | extension[*].valueString | - | - | exact-duplicate-document-id | Top Level |
| facilityid | - | The ID of the clinical provider associated with this clinical document. Clinical providers are a master list of providers throughout the country. These include providers as well as radiology centers, labs and pharmacies. | Integer | 0..1 | DiagnosticReport | extension[*].valueInteger | - | - | facility-id | Top Level |
| internalnote | - | The 'Internal Note' attached to this document. | String | 0..1 | DiagnosticReport | extension[*].valueString | - | - | internal-note | Top Level |
| interpretationtemplate | - | The interpretation template added to the lab result. | Object | 0..1 | DiagnosticReport | extension[*].valueString | - | - | interpretation-template | Top Level |
| isreviewedbyprovider | - | Whether the lab result has been reivewed by a provider. | String | 0..1 | DiagnosticReport | extension[*].valueString | - | - | is-reviewed-by-provider | Top Level |
| labresultdate | - | Observation date associated with this lab result. | String | 0..1 | DiagnosticReport | extension[*].valueDate | - | - | lab-result-date | Top Level |
| labresultdatetime | - | The observation date and time associated with this lab result. Returned in mm/dd/yyyy hh24:mi:ss format. | String | 0..1 | DiagnosticReport | effectiveDateTime , issued | - | - | - | Top Level |
| labresultid | - | athena ID for this lab result. | Integer | 0..1 | DiagnosticReport | id | - | - | - | Top Level |
| labresultloinc | - | The LOINC for the result document or associated order. | String | 0..1 | DiagnosticReport | code.coding.[*].code | - | LOINC | - | Top Level |
| labresultnote | - | Additional note associated with this lab result, if any. | String | 0..1 | DiagnosticReport | conclusion | - | - | - | Top Level |
| orderid | - | The athena ID of the associated order document. | Integer | 0..1 | DiagnosticReport | basedOn.[*].reference | - | - | - | Top Level |
| patientnote | - | The external note for the patient. | String | 0..1 | DiagnosticReport | extension[*].valueString | - | - | patient-note | Top Level |
| performinglabaddress1 | - | This is the address1 field of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider. | String | 0..1 | Organization | address.line[0] | - | - | - | Contained |
| performinglabaddress2 | - | This is the address2 field of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider. | String | 0..1 | Organization | address.line[1] | - | - | - | Contained |
| performinglabcity | - | This is the city of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider. | String | 0..1 | Organization | address.city | - | - | - | Contained |
| performinglabname | - | This is the name of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider. | String | 0..1 | Organization | name | - | - | - | Contained |
| performinglabstate | - | This is the state of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider. | String | 0..1 | Organization | address.state | - | - | - | Contained |
| performinglabzip | - | This is the zip code of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider. | String | 0..1 | Organization | address.postalcode | - | - | - | Contained |
| priority | - | Document priority, when available. 1 is high, 2 is normal. Some labs use other numbers or characters that are lab-specific. | String | 0..1 | DiagnosticReport | extension[*].valueString | - | - | priority | Top Level |
| providerid | - | The provider ID for this document. | Integer | 0..1 | DiagnosticReport | performer[*].reference | - | - | - | Top Level |
| resultstatus | - | The status of the result (e.g., "final\ "preliminary\ "corrected\ etc.). | String | 0..1 | DiagnosticReport | status | - | - | - | Top Level |
| supersededdocumentid | - | The supersededid of the Document. | String | 0..1 | DiagnosticReport | extension[*].valueString | - | - | superseded-document-id | Top Level |