Lab Test
From OpenIndivo Documentation Wiki
Contents |
[edit]
Overview
Because lab tests are often done in large, grouped panels (e.g. complete blood counts), the Indivo lab schema is built in a hierarchical fashion. Each lab document begins with a LabRoot element, an extension of the PersonalHealthDataType, and may contain either a single LabTest element or a single LabGroup element. A LabGroup, in turn, may contain additional SubGroups, or any number of individual LabTests.
[edit]
Schema
[edit]
Detailed Schema Description
[edit]
LabRootType
Date- dateTime (optional)
- The date the laboratory test was performed, if this document describes a single test, or the administrative date representing when a panel of tests was performed, even if individual tests in the panel were all performed at different times.
Origin- ConciseContactInformationType (optional)
- The institution which provided the data in this document. Use the LaboratoryContact field to describe the lab which processed this result, if applicable.
Comments- string (optional)
- Any free-text comments about this document.
Provider- ConciseContactInformationType (optional)
- The provider (physician, nurse, etc.) who ordered the test.
EncounterId- string (optional)
- An identifier which is unique across an Indivo Record, used to identify documents which originated from a discrete health encounter.
LaboratoryName- string (required)
- The type of laboratory which performed these tests, i.e. genetics, immunology, bacteriology. This field may be used to organize tests results in a user interface.
<LaboratoryName>Hematology</LaboratoryName>
LaboratoryContact- ConciseContactInformationType (optional)
- Contact information for the lab that processed the test result.
LabGroup- LabGroupType
- A lab group is specified only when a LabRoot includes multiple test results.
LabTest- LabTestType
- A lab test is specified only when a LabRoot includes only a single test result.
[edit]
LabGroupType
GroupName- string (required)
- The name of this group of lab tests.
<GroupName>Complete Blood Count & Differential</GroupName>
SubGroups- LabGroupType (optional, multiple)
- Any subgroupings of lab tests in this group.
LabTests- LabTestType (optional, multiple)
- Individual lab tests in this group.
[edit]
LabTestType
Name- string (optional)
- The name of this lab test.
<Name>Hemoglobin</Name>
Substance- string (optional)
- The biological substance upon which this test was performed.
CollectionMethod- string (optional)
- The method used to collect the test substance.
Abbreviation- string (optional)
- Abbreviated form of the test name.
<Abbreviation>Hgb</Abbreviation>
Description- string (optional)
- Free-text description of this test.
DateTime- dateTime (required)
- The date and time this individual test was performed. If the LabRoot describes only a single test, this value should be identical to the
LabRoot’sDatefield.
Code- CodedValueType (optional, multiple)
- A code which identifies this type of test. This field may be used in place of some of the above LabTest fields, when such information can be interpreted from the code.
Result- ResultType (optional)
- The result of this test. A blank result indicates that the test has not yet been processed.
Status- CodedValueType (optional)
- Code to indicate test status.
- » Refer to coding system indivo-lab-status-1.0.
[edit]
ResultType
Test results may either be defined in a numeric fashion (using the Value, Unit, ReferenceRange, and ToxicRange fields) or as text (using the TextValue field). Either result format may also specify a result flag.
Value- double (optional)
- The numeric value of the test result.
Unit- CodedValueType (optional)
- The unit of measure of the test result.
- » Refer to coding system indivo-lab-units-1.0.
ReferenceRange- DoubleRangeType (optional)
- The range of numeric values indicating a normal test result, in the same unit of measure as the result value.
ToxicRangecode- DoubleRangeType (optional)
- The range of numeric values indicating a toxic test result, in the same unit of measure as the result value, e.g. blood alcohol concentration greater than 1.00 gram per liter.
TextValue- string (optional)
- In place of above fields, a textual result may be specified for lab results not numerically quantifiable. This field should not be used to store a text-formatted numeric result.
Flag- CodedValueType (optional)
- Optional code to mark an abnormal test result.
- » Refer to coding system hl7-abnormal-flag-2.5.
[edit]
XML Usage Example
Needs clean-up.
<LabRoot>
<Date>2005-07-18T00:00:00.000-04:00</Date>
<LaboratoryName>Hematology</LaboratoryName>
<LabGroup>
<GroupName>Complete Blood Count with Differential</GroupName>
<SubGroups>
<GroupName>Complete Blood Count</GroupName>
<LabTests>
<Name>WBC</Name>
<Abbreviation>WBC</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>8.88</Value>
<Unit>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/indivo-lab-units-1.0</ServiceLocation>
<ShortDescription>Common Compound Lab Units</ShortDescription>
</CodingSystem>
<Code>k/ul</Code>
<HistoricalValue>K/uL</HistoricalValue>
</Unit>
<ReferenceRange>
<Minimum>6.3</Minimum>
<Maximum>14.8</Maximum>
<Unit>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/indivo-lab-units-1.0</ServiceLocation>
<ShortDescription>Common Compound Lab Units</ShortDescription>
</CodingSystem>
<Code>k/ul</Code>
<HistoricalValue>K/uL</HistoricalValue>
</Unit>
</ReferenceRange>
</Result>
</LabTests>
<LabTests>
<Name>RBC</Name>
<Abbreviation>RBC</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>4.82</Value>
<ReferenceRange>
<Minimum>4.2</Minimum>
<Maximum>5.1</Maximum>
</ReferenceRange>
</Result>
</LabTests>
<LabTests>
<Name>Hemoglobin</Name>
<Abbreviation>Hemoglobin</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>12.0</Value>
<ReferenceRange>
<Minimum>10.5</Minimum>
<Maximum>12.6</Maximum>
</ReferenceRange>
</Result>
</LabTests>
<LabTests>
<Name>Hematocrit</Name>
<Abbreviation>Hematocrit</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>35.9</Value>
<Unit>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/indivo-lab-units-1.0</ServiceLocation>
<ShortDescription>Common Compound Lab Units</ShortDescription>
</CodingSystem>
<Code>%</Code>
<HistoricalValue>%</HistoricalValue>
</Unit>
<ReferenceRange>
<Minimum>31.5</Minimum>
<Maximum>37.7</Maximum>
<Unit>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/indivo-lab-units-1.0</ServiceLocation>
<ShortDescription>Common Compound Lab Units</ShortDescription>
</CodingSystem>
<Code>%</Code>
<HistoricalValue>%</HistoricalValue>
</Unit>
</ReferenceRange>
</Result>
</LabTests>
<LabTests>
<Name>MCV</Name>
<Abbreviation>MCV</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>74.5</Value>
<ReferenceRange>
<Minimum>72.0</Minimum>
<Maximum>83.0</Maximum>
</ReferenceRange>
</Result>
</LabTests>
<LabTests>
<Name>%Micro</Name>
<Abbreviation>% Micro</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>7.2</Value>
<Unit>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/indivo-lab-units-1.0</ServiceLocation>
<ShortDescription>Common Compound Lab Units</ShortDescription>
</CodingSystem>
<Code>%</Code>
<HistoricalValue>%</HistoricalValue>
</Unit>
</Result>
</LabTests>
<LabTests>
<Name>MCH</Name>
<Abbreviation>MCH</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>24.9</Value>
<ReferenceRange>
<Minimum>23.2</Minimum>
<Maximum>27.5</Maximum>
</ReferenceRange>
</Result>
</LabTests>
<LabTests>
<Name>MCHC</Name>
<Abbreviation>MCHC</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>33.4</Value>
<ReferenceRange>
<Minimum>31.9</Minimum>
<Maximum>35.0</Maximum>
</ReferenceRange>
</Result>
</LabTests>
<LabTests>
<Name>RDW</Name>
<Abbreviation>RDW</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>13.6</Value>
<Unit>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/indivo-lab-units-1.0</ServiceLocation>
<ShortDescription>Common Compound Lab Units</ShortDescription>
</CodingSystem>
<Code>%</Code>
<HistoricalValue>%</HistoricalValue>
</Unit>
<ReferenceRange>
<Minimum>13.1</Minimum>
<Maximum>15.6</Maximum>
<Unit>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/indivo-lab-units-1.0</ServiceLocation>
<ShortDescription>Common Compound Lab Units</ShortDescription>
</CodingSystem>
<Code>%</Code>
<HistoricalValue>%</HistoricalValue>
</Unit>
</ReferenceRange>
</Result>
</LabTests>
<LabTests>
<Name>HDW</Name>
<Abbreviation>HDW</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>2.49</Value>
<ReferenceRange>
<Minimum>1.8</Minimum>
<Maximum>3.2</Maximum>
</ReferenceRange>
</Result>
</LabTests>
<LabTests>
<Name>MPV</Name>
<Abbreviation>MPV</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>6.2</Value>
<ReferenceRange>
<Minimum>7.1</Minimum>
<Maximum>9.3</Maximum>
</ReferenceRange>
<Flag>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/hl7-abnormal-flag-2.5</ServiceLocation>
<ShortDescription>Abnormal Flags</ShortDescription>
</CodingSystem>
<Code>L</Code>
<HistoricalValue>Low</HistoricalValue>
</Flag>
</Result>
</LabTests>
<LabTests>
<Name>Platelet</Name>
<Abbreviation>Platelet</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<Value>474.0</Value>
<Unit>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/indivo-lab-units-1.0</ServiceLocation>
<ShortDescription>Common Compound Lab Units</ShortDescription>
</CodingSystem>
<Code>k/ul</Code>
<HistoricalValue>K/uL</HistoricalValue>
</Unit>
<ReferenceRange>
<Minimum>223.0</Minimum>
<Maximum>461.0</Maximum>
<Unit>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/indivo-lab-units-1.0</ServiceLocation>
<ShortDescription>Common Compound Lab Units</ShortDescription>
</CodingSystem>
<Code>k/ul</Code>
<HistoricalValue>K/uL</HistoricalValue>
</Unit>
</ReferenceRange>
<Flag>
<CodingSystem>
<ServiceLocation>http://indivo.org/codingsystems/hl7-abnormal-flag-2.5</ServiceLocation>
<ShortDescription>Abnormal Flags</ShortDescription>
</CodingSystem>
<Code>H</Code>
<HistoricalValue>High</HistoricalValue>
</Flag>
</Result>
</LabTests>
</SubGroups>
<SubGroups>
<GroupName>WBC Differential, Automated</GroupName>
<LabTests>
<Name>Automated Diff?</Name>
<Abbreviation>Automated Diff?</Abbreviation>
<DateTime>2005-07-18T00:00:00.000-04:00</DateTime>
<Result>
<TextValue>NOT DONE</TextValue>
</Result>
</LabTests>
</SubGroups>
</LabGroup>
</LabRoot>

