Lab Test

From OpenIndivo Documentation Wiki

Jump to: navigation, search

Contents

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.

Schema

Detailed Schema Description

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.

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.

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’s Date field.
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.

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.

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>
Personal tools