HL7 Europe Laboratory Report
0.2.0-ci - ci-build 150

HL7 Europe Laboratory Report, published by HL7 Europe. This guide is not an authorized publication; it is the continuous build for version 0.2.0-ci built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/laboratory/ and changes regularly. See the Directory of published versions

Data Type Profile: Ratio (Eu Lab)

Official URL: http://hl7.eu/fhir/laboratory/StructureDefinition/Ratio-eu-lab Version: 0.2.0-ci
Draft as of 2026-03-27 Computable Name: RatioEuLab

Copyright/Legal: Used by permission of HL7 Europe, all rights reserved Creative Commons License

This profile constrains the Ratio data type to use UCUM as the code system for units and optionally share measurement uncertainty

This profile of the Ratio data type imposes the usage of the UCUM as the code system for units and allows expressing uncertainty of measurement

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Ratio C 0..* Ratio A measured ratio using UCUM
Constraints: rat-1
... Slices for extension Content/Rules for all slices
.... extension:uncertainty 0..1 decimal Standard Deviation (same units as the quantity)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertainty
.... extension:uncertaintyType 0..1 code Probability Distribution Type for uncertainty
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertaintyType
Binding: ProbabilityDistributionType (required)

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
rat-1 error Ratio Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())

This structure is derived from Ratio

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Ratio 0..* Ratio A measured ratio using UCUM
... Slices for extension Content/Rules for all slices
.... extension:uncertainty 0..1 decimal Standard Deviation (same units as the quantity)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertainty
.... extension:uncertaintyType 0..1 code Probability Distribution Type for uncertainty
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertaintyType
Binding: ProbabilityDistributionType (required)
... numerator
.... system 1..1 uri System that defines coded unit form
Required Pattern: http://unitsofmeasure.org
.... code 1..1 code Coded form of the unit
... denominator
.... system 1..1 uri System that defines coded unit form
Required Pattern: http://unitsofmeasure.org
.... code 1..1 code Coded form of the unit

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Ratio C 0..* Ratio A measured ratio using UCUM
Constraints: rat-1
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:uncertainty 0..1 decimal Standard Deviation (same units as the quantity)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertainty
.... extension:uncertaintyType 0..1 code Probability Distribution Type for uncertainty
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertaintyType
Binding: ProbabilityDistributionType (required)
... numerator Σ 0..1 Quantity Numerator value
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... value Σ 0..1 decimal Numerical value (with implicit precision)
.... comparator ?!Σ 0..1 code < | <= | >= | > - how to understand the value
Binding: QuantityComparator (required): How the Quantity should be understood and represented.
.... unit Σ 0..1 string Unit representation
.... system ΣC 1..1 uri System that defines coded unit form
Required Pattern: http://unitsofmeasure.org
.... code Σ 1..1 code Coded form of the unit
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... value Σ 0..1 decimal Numerical value (with implicit precision)
.... comparator ?!Σ 0..1 code < | <= | >= | > - how to understand the value
Binding: QuantityComparator (required): How the Quantity should be understood and represented.
.... unit Σ 0..1 string Unit representation
.... system ΣC 1..1 uri System that defines coded unit form
Required Pattern: http://unitsofmeasure.org
.... code Σ 1..1 code Coded form of the unit

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Ratio.numerator.comparator Base required QuantityComparator 📍4.0.1 FHIR Std.
Ratio.denominator.comparator Base required QuantityComparator 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
rat-1 error Ratio Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())

This structure is derived from Ratio

Summary

Mandatory: 0 element(4 nested mandatory elements)

Extensions

This structure refers to these extensions:

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Ratio C 0..* Ratio A measured ratio using UCUM
Constraints: rat-1
... Slices for extension Content/Rules for all slices
.... extension:uncertainty 0..1 decimal Standard Deviation (same units as the quantity)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertainty
.... extension:uncertaintyType 0..1 code Probability Distribution Type for uncertainty
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertaintyType
Binding: ProbabilityDistributionType (required)

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
rat-1 error Ratio Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())

Differential View

This structure is derived from Ratio

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Ratio 0..* Ratio A measured ratio using UCUM
... Slices for extension Content/Rules for all slices
.... extension:uncertainty 0..1 decimal Standard Deviation (same units as the quantity)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertainty
.... extension:uncertaintyType 0..1 code Probability Distribution Type for uncertainty
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertaintyType
Binding: ProbabilityDistributionType (required)
... numerator
.... system 1..1 uri System that defines coded unit form
Required Pattern: http://unitsofmeasure.org
.... code 1..1 code Coded form of the unit
... denominator
.... system 1..1 uri System that defines coded unit form
Required Pattern: http://unitsofmeasure.org
.... code 1..1 code Coded form of the unit

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Ratio C 0..* Ratio A measured ratio using UCUM
Constraints: rat-1
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:uncertainty 0..1 decimal Standard Deviation (same units as the quantity)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertainty
.... extension:uncertaintyType 0..1 code Probability Distribution Type for uncertainty
URL: http://hl7.org/fhir/StructureDefinition/iso21090-uncertaintyType
Binding: ProbabilityDistributionType (required)
... numerator Σ 0..1 Quantity Numerator value
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... value Σ 0..1 decimal Numerical value (with implicit precision)
.... comparator ?!Σ 0..1 code < | <= | >= | > - how to understand the value
Binding: QuantityComparator (required): How the Quantity should be understood and represented.
.... unit Σ 0..1 string Unit representation
.... system ΣC 1..1 uri System that defines coded unit form
Required Pattern: http://unitsofmeasure.org
.... code Σ 1..1 code Coded form of the unit
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... value Σ 0..1 decimal Numerical value (with implicit precision)
.... comparator ?!Σ 0..1 code < | <= | >= | > - how to understand the value
Binding: QuantityComparator (required): How the Quantity should be understood and represented.
.... unit Σ 0..1 string Unit representation
.... system ΣC 1..1 uri System that defines coded unit form
Required Pattern: http://unitsofmeasure.org
.... code Σ 1..1 code Coded form of the unit

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Ratio.numerator.comparator Base required QuantityComparator 📍4.0.1 FHIR Std.
Ratio.denominator.comparator Base required QuantityComparator 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
rat-1 error Ratio Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())

This structure is derived from Ratio

Summary

Mandatory: 0 element(4 nested mandatory elements)

Extensions

This structure refers to these extensions:

 

Other representations of profile: CSV, Excel, Schematron