{
"description": "This profile constrains the Ratio data type to use UCUM as the code system for units and optionally share measurement uncertainty",
"_filename": "StructureDefinition-Ratio-eu-lab.json",
"package_name": "hl7.fhir.eu.laboratory",
"date": "2025-03-25T12:00:10+01:00",
"derivation": "constraint",
"publisher": "HL7 Europe",
"fhirVersion": "4.0.1",
"jurisdiction": [ {
"coding": [ {
"code": "150",
"system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
"display": "Europe"
} ]
} ],
"purpose": "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",
"name": "RatioEuLab",
"mapping": [ {
"uri": "http://hl7.org/v2",
"name": "HL7 v2 Mapping",
"identity": "v2"
}, {
"uri": "http://hl7.org/v3",
"name": "RIM Mapping",
"identity": "rim"
} ],
"abstract": false,
"copyright": "Used by permission of HL7 Europe, all rights reserved Creative Commons License",
"type": "Ratio",
"experimental": null,
"resourceType": "StructureDefinition",
"title": "Ratio (Eu Lab)",
"package_version": "0.1.1",
"snapshot": {
"element": [ {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"xpath": "@value|f:*|h:div",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
}, {
"key": "rat-1",
"human": "Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present",
"xpath": "(count(f:numerator) = count(f:denominator)) and ((count(f:numerator) > 0) or (count(f:extension) > 0))",
"source": "http://hl7.org/fhir/StructureDefinition/Ratio",
"severity": "error",
"expression": "(numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())"
} ],
"path": "Ratio",
"min": 0,
"definition": "A measured ratio (or a ratio that can potentially be measured) and uncertainty of the measurement. This profile imposes that the code system for units be UCUM.",
"isModifier": false,
"short": "A measured ratio using UCUM",
"mapping": [ {
"map": "n/a",
"identity": "rim"
}, {
"map": "N/A",
"identity": "v2"
}, {
"map": "RTO",
"identity": "rim"
} ],
"max": "*",
"id": "Ratio",
"condition": [ "ele-1" ],
"comment": "The Ratio datatype should only be used to express a relationship of two numbers if the relationship cannot be suitably expressed using a Quantity and a common unit. Where the denominator value is known to be fixed to \"1\", Quantity should be used instead of Ratio.",
"base": {
"max": "*",
"min": 0,
"path": "Ratio"
}
}, {
"path": "Ratio.id",
"min": 0,
"definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
"isModifier": false,
"short": "Unique id for inter-element referencing",
"mapping": [ {
"map": "n/a",
"identity": "rim"
} ],
"type": [ {
"code": "http://hl7.org/fhirpath/System.String",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
"valueUrl": "string"
} ]
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Ratio.id",
"base": {
"max": "1",
"min": 0,
"path": "Element.id"
},
"isSummary": false
}, {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"xpath": "@value|f:*|h:div",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
}, {
"key": "ext-1",
"human": "Must have either extensions or value[x], not both",
"xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
"source": "http://hl7.org/fhir/StructureDefinition/Extension",
"severity": "error",
"expression": "extension.exists() != value.exists()"
} ],
"path": "Ratio.extension",
"min": 0,
"definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
"isModifier": false,
"short": "Additional content defined by implementations",
"mapping": [ {
"map": "n/a",
"identity": "rim"
} ],
"slicing": {
"rules": "open",
"description": "Extensions are always sliced by (at least) url",
"discriminator": [ {
"path": "url",
"type": "value"
} ]
},
"type": [ {
"code": "Extension"
} ],
"alias": [ "extensions", "user content" ],
"max": "*",
"id": "Ratio.extension",
"comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
},
"isSummary": false
}, {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"xpath": "@value|f:*|h:div",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
}, {
"key": "ext-1",
"human": "Must have either extensions or value[x], not both",
"xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
"source": "http://hl7.org/fhir/StructureDefinition/Extension",
"severity": "error",
"expression": "extension.exists() != value.exists()"
} ],
"path": "Ratio.extension",
"min": 0,
"definition": "The primary measure of variance/uncertainty of the value (the square root of the sum of the squares of the differences between all data points and the mean).",
"isModifier": false,
"short": "Standard Deviation (same units as the quantity)",
"mapping": [ {
"map": "PPD.standardDeviation",
"identity": "rim"
} ],
"type": [ {
"code": "Extension",
"profile": [ "http://hl7.org/fhir/StructureDefinition/iso21090-uncertainty" ]
} ],
"sliceName": "uncertainty",
"max": "1",
"id": "Ratio.extension:uncertainty",
"comment": "standardDeviation has the same units as the quantity. It is used to normalize the data for computing the distribution function. Applications that cannot deal with probability distributions can still get an idea about the confidence level by looking at standardDeviation.",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
},
"isSummary": false
}, {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"xpath": "@value|f:*|h:div",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
}, {
"key": "ext-1",
"human": "Must have either extensions or value[x], not both",
"xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
"source": "http://hl7.org/fhir/StructureDefinition/Extension",
"severity": "error",
"expression": "extension.exists() != value.exists()"
} ],
"path": "Ratio.extension",
"min": 0,
"definition": "A code specifying the type of probability distribution for the uncertainty.",
"isModifier": false,
"short": "Probability Distribution Type for uncertainty",
"mapping": [ {
"map": "PPD.distributionType",
"identity": "rim"
} ],
"type": [ {
"code": "Extension",
"profile": [ "http://hl7.org/fhir/StructureDefinition/iso21090-uncertaintyType" ]
} ],
"sliceName": "uncertaintyType",
"max": "1",
"id": "Ratio.extension:uncertaintyType",
"comment": "This is only meaningful if there is also an uncertainty extension. If there is an uncertainty extension with no type, this means that the probability distribution type is unknown. In that case, the uncertainty has the meaning of an informal guess.",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
},
"isSummary": false
}, {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"xpath": "@value|f:*|h:div",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
}, {
"key": "qty-3",
"human": "If a code for the unit is present, the system SHALL also be present",
"xpath": "not(exists(f:code)) or exists(f:system)",
"source": "http://hl7.org/fhir/StructureDefinition/Quantity",
"severity": "error",
"expression": "code.empty() or system.exists()"
} ],
"path": "Ratio.numerator",
"min": 0,
"definition": "A measured amount (or an amount that can potentially be measured). Note that measured amounts include amounts that are not precisely quantified, including amounts involving arbitrary units and floating currencies.\r\nThis profile imposes that the code system for units be UCUM.",
"isModifier": false,
"short": "A measured amount using UCUM",
"mapping": [ {
"map": "n/a",
"identity": "rim"
}, {
"map": "SN (see also Range) or CQ",
"identity": "v2"
}, {
"map": "PQ, IVL, MO, CO, depending on the values",
"identity": "rim"
} ],
"type": [ {
"code": "Quantity",
"profile": [ "http://hl7.org/fhir/uv/ips/StructureDefinition/Quantity-uv-ips" ]
} ],
"mustSupport": true,
"max": "1",
"id": "Ratio.numerator",
"condition": [ "ele-1" ],
"comment": "The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.",
"base": {
"max": "1",
"min": 0,
"path": "Ratio.numerator"
}
}, {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"xpath": "@value|f:*|h:div",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
}, {
"key": "qty-3",
"human": "If a code for the unit is present, the system SHALL also be present",
"xpath": "not(exists(f:code)) or exists(f:system)",
"source": "http://hl7.org/fhir/StructureDefinition/Quantity",
"severity": "error",
"expression": "code.empty() or system.exists()"
} ],
"path": "Ratio.denominator",
"min": 0,
"definition": "A measured amount (or an amount that can potentially be measured). Note that measured amounts include amounts that are not precisely quantified, including amounts involving arbitrary units and floating currencies.\r\nThis profile imposes that the code system for units be UCUM.",
"isModifier": false,
"short": "A measured amount using UCUM",
"mapping": [ {
"map": "n/a",
"identity": "rim"
}, {
"map": "SN (see also Range) or CQ",
"identity": "v2"
}, {
"map": "PQ, IVL, MO, CO, depending on the values",
"identity": "rim"
} ],
"type": [ {
"code": "Quantity",
"profile": [ "http://hl7.org/fhir/uv/ips/StructureDefinition/Quantity-uv-ips" ]
} ],
"mustSupport": true,
"max": "1",
"id": "Ratio.denominator",
"condition": [ "ele-1" ],
"comment": "The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.",
"base": {
"max": "1",
"min": 0,
"path": "Ratio.denominator"
}
} ],
"extension": [ {
"url": "http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version",
"valueString": "1.1.0"
} ]
},
"status": "active",
"id": "c03c5a27-5e06-42cc-a45e-4df4d36621a9",
"kind": "complex-type",
"url": "http://hl7.eu/fhir/laboratory/StructureDefinition/Ratio-eu-lab",
"identifier": [ {
"value": "urn:oid:2.16.840.1.113883.2.51.22.1.42.20",
"system": "urn:ietf:rfc:3986"
} ],
"version": "0.1.1",
"differential": {
"element": [ {
"id": "Ratio",
"path": "Ratio",
"short": "A measured ratio using UCUM",
"definition": "A measured ratio (or a ratio that can potentially be measured) and uncertainty of the measurement. This profile imposes that the code system for units be UCUM."
}, {
"id": "Ratio.extension:uncertainty",
"max": "1",
"min": 0,
"path": "Ratio.extension",
"type": [ {
"code": "Extension",
"profile": [ "http://hl7.org/fhir/StructureDefinition/iso21090-uncertainty" ]
} ],
"sliceName": "uncertainty"
}, {
"id": "Ratio.extension:uncertaintyType",
"max": "1",
"min": 0,
"path": "Ratio.extension",
"type": [ {
"code": "Extension",
"profile": [ "http://hl7.org/fhir/StructureDefinition/iso21090-uncertaintyType" ]
} ],
"sliceName": "uncertaintyType"
} ]
},
"contact": [ {
"name": "HL7 Europe",
"telecom": [ {
"value": "http://hl7.eu",
"system": "url"
} ]
} ],
"baseDefinition": "http://hl7.org/fhir/uv/ips/StructureDefinition/Ratio-uv-ips"
}