This page is part of the International Patient Summary Implementation Guide (v0.2.0: STU 1 Ballot 2) based on FHIR (HL7® FHIR® Standard) R4. The current version which supersedes this version is 2.0.0. For a full list of available versions, see the Directory of published versions
Definitions for the StructureDefinition-ratio-uv-ips Profile.
| Ratio | |
| Definition | A relationship of two Quantity values - expressed as a numerator and a denominator. |
| Control | 0..* This element is affected by the following invariants: ele-1 |
| Comments | 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. |
| Invariants | Defined on this element ele-1: All FHIR elements must have a @value or children (: hasValue() or (children().count() > id.count())) rat-1: 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())) |
| Ratio.id | |
| Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
| Control | 0..1 |
| Type | string |
| Ratio.extension | |
| 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. |
| Control | 0..* |
| Type | Extension |
| Alternate Names | extensions, user content |
| Comments | 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. |
| Ratio.numerator | |
| Definition | The value of the numerator. |
| Control | 0..1 |
| Type | Quantity |
| Ratio.numerator.id | |
| Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
| Control | 0..1 |
| Type | string |
| Ratio.numerator.extension | |
| 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. |
| Control | 0..* |
| Type | Extension |
| Alternate Names | extensions, user content |
| Comments | 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. |
| Ratio.numerator.value | |
| Definition | The value of the measured amount. The value includes an implicit precision in the presentation of the value. |
| Control | 0..1 |
| Type | decimal |
| Requirements | Precision is handled implicitly in almost all cases of measurement. |
| Comments | The implicit precision in the value should always be honored. Monetary values have their own rules for handling precision (refer to standard accounting text books). |
| Ratio.numerator.comparator | |
| Definition | How the value should be understood and represented - whether the actual value is greater or less than the stated value due to measurement issues; e.g. if the comparator is "<" , then the real value is < stated value. |
| Control | 0..1 |
| Binding | How the Quantity should be understood and represented. The codes SHALL be taken from QuantityComparator |
| Type | code |
| Is Modifier | true |
| Requirements | Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology. |
| Meaning if Missing | If there is no comparator, then there is no modification of the value |
| Ratio.numerator.unit | |
| Definition | A human-readable form of the unit. |
| Control | 0..1 |
| Type | string |
| Requirements | There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms. |
| Ratio.numerator.system | |
| Definition | The identification of the system that provides the coded form of the unit. |
| Control | 1..1 This element is affected by the following invariants: qty-3 |
| Type | uri |
| Requirements | Need to know the system that defines the coded form of the unit. |
| Fixed Value | http://unitsofmeasure.org |
| Ratio.numerator.code | |
| Definition | A computer processable form of the unit in some unit representation system. |
| Control | 1..1 |
| Type | code |
| Requirements | Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest. |
| Comments | The preferred system is UCUM, but SNOMED CT can also be used (for customary units) or ISO 4217 for currency. The context of use may additionally require a code from a particular system. |
| Ratio.denominator | |
| Definition | The value of the denominator. |
| Control | 0..1 |
| Type | Quantity |
| Ratio.denominator.id | |
| Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. |
| Control | 0..1 |
| Type | string |
| Ratio.denominator.extension | |
| 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. |
| Control | 0..* |
| Type | Extension |
| Alternate Names | extensions, user content |
| Comments | 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. |
| Ratio.denominator.value | |
| Definition | The value of the measured amount. The value includes an implicit precision in the presentation of the value. |
| Control | 0..1 |
| Type | decimal |
| Requirements | Precision is handled implicitly in almost all cases of measurement. |
| Comments | The implicit precision in the value should always be honored. Monetary values have their own rules for handling precision (refer to standard accounting text books). |
| Ratio.denominator.comparator | |
| Definition | How the value should be understood and represented - whether the actual value is greater or less than the stated value due to measurement issues; e.g. if the comparator is "<" , then the real value is < stated value. |
| Control | 0..1 |
| Binding | How the Quantity should be understood and represented. The codes SHALL be taken from QuantityComparator |
| Type | code |
| Is Modifier | true |
| Requirements | Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology. |
| Meaning if Missing | If there is no comparator, then there is no modification of the value |
| Ratio.denominator.unit | |
| Definition | A human-readable form of the unit. |
| Control | 0..1 |
| Type | string |
| Requirements | There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms. |
| Ratio.denominator.system | |
| Definition | The identification of the system that provides the coded form of the unit. |
| Control | 1..1 This element is affected by the following invariants: qty-3 |
| Type | uri |
| Requirements | Need to know the system that defines the coded form of the unit. |
| Fixed Value | http://unitsofmeasure.org |
| Ratio.denominator.code | |
| Definition | A computer processable form of the unit in some unit representation system. |
| Control | 1..1 |
| Type | code |
| Requirements | Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest. |
| Comments | The preferred system is UCUM, but SNOMED CT can also be used (for customary units) or ISO 4217 for currency. The context of use may additionally require a code from a particular system. |

