Release 5 Preview #2

This page is part of the FHIR Specification (v4.4.0: R5 Preview #2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

11.29.0 SubstanceAmount

Pharmacy Work GroupMaturity Level: 3Standards Status: Trial Use
This type is still undergoing development and review by the appropriate Workgroups. At this time, is considered only as a draft design not suitable for production implementation

The SubstanceAmount structure defines TODO.

Note: the SubstanceAmount structure allows modifier extensions.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. SubstanceAmountΣDElementChemical substances are a single substance type whose primary defining element is the molecular structure. Chemical substances shall be defined on the basis of their complete covalent molecular structure; the presence of a salt (counter-ion) and/or solvates (water, alcohols) is also captured. Purity, grade, physical form or particle size are not taken into account in the definition of a chemical substance or in the assignment of a Substance ID
Elements defined in Ancestors: id, extension, modifierExtension
... amount[x]Σ0..1Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field
.... amountQuantityQuantity
.... amountRangeRange
.... amountStringstring
... amountTypeΣ0..1CodeableConceptMost elements that require a quantitative value will also have a field called amount type. Amount type should always be specified because the actual value of the amount is often dependent on it. EXAMPLE: In capturing the actual relative amounts of substances or molecular fragments it is essential to indicate whether the amount refers to a mole ratio or weight ratio. For any given element an effort should be made to use same the amount type for all related definitional elements
... amountTextΣ0..1stringA textual comment on a numeric value
.... lowLimitΣ0..1QuantityLower limit possible or expected
.... highLimitΣ0..1QuantityUpper limit possible or expected

doco Documentation for this format

UML Diagram (Legend)

SubstanceAmountUsed to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this fieldamount[x] : DataType [0..1] « Quantity|Range|string »Most elements that require a quantitative value will also have a field called amount type. Amount type should always be specified because the actual value of the amount is often dependent on it. EXAMPLE: In capturing the actual relative amounts of substances or molecular fragments it is essential to indicate whether the amount refers to a mole ratio or weight ratio. For any given element an effort should be made to use same the amount type for all related definitional elementsamountType : CodeableConcept [0..1]A textual comment on a numeric valueamountText : string [0..1]ReferenceRangeLower limit possible or expectedlowLimit : Quantity [0..1]Upper limit possible or expectedhighLimit : Quantity [0..1]BackboneTypeMay be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself) (this element modifies the meaning of other elements)modifierExtension : Extension [0..*]Reference range of possible or expected valuesreferenceRange[0..1]

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .

[
 # from Element: Element.extension
  # SubstanceAmount.amount[x] : 0..1 Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field. One of these 3
    fhir:SubstanceAmount.amountQuantity [ Quantity ]
    fhir:SubstanceAmount.amountRange [ Range ]
    fhir:SubstanceAmount.amountString [ string ]
  fhir:SubstanceAmount.amountType [ CodeableConcept ]; # 0..1 Most elements that require a quantitative value will also have a field called amount type. Amount type should always be specified because the actual value of the amount is often dependent on it. EXAMPLE: In capturing the actual relative amounts of substances or molecular fragments it is essential to indicate whether the amount refers to a mole ratio or weight ratio. For any given element an effort should be made to use same the amount type for all related definitional elements
  fhir:SubstanceAmount.amountText [ string ]; # 0..1 A textual comment on a numeric value
  fhir:SubstanceAmount.referenceRange [ # 0..1 Reference range of possible or expected values
    fhir:SubstanceAmount.referenceRange.lowLimit [ Quantity ]; # 0..1 Lower limit possible or expected
    fhir:SubstanceAmount.referenceRange.highLimit [ Quantity ]; # 0..1 Upper limit possible or expected
  ];
]

Changes since Release 3

SubstanceAmount
  • No Changes

See the Full Difference for further information

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. SubstanceAmountΣDElementChemical substances are a single substance type whose primary defining element is the molecular structure. Chemical substances shall be defined on the basis of their complete covalent molecular structure; the presence of a salt (counter-ion) and/or solvates (water, alcohols) is also captured. Purity, grade, physical form or particle size are not taken into account in the definition of a chemical substance or in the assignment of a Substance ID
Elements defined in Ancestors: id, extension, modifierExtension
... amount[x]Σ0..1Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field
.... amountQuantityQuantity
.... amountRangeRange
.... amountStringstring
... amountTypeΣ0..1CodeableConceptMost elements that require a quantitative value will also have a field called amount type. Amount type should always be specified because the actual value of the amount is often dependent on it. EXAMPLE: In capturing the actual relative amounts of substances or molecular fragments it is essential to indicate whether the amount refers to a mole ratio or weight ratio. For any given element an effort should be made to use same the amount type for all related definitional elements
... amountTextΣ0..1stringA textual comment on a numeric value
.... lowLimitΣ0..1QuantityLower limit possible or expected
.... highLimitΣ0..1QuantityUpper limit possible or expected

doco Documentation for this format

UML Diagram (Legend)

SubstanceAmountUsed to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this fieldamount[x] : DataType [0..1] « Quantity|Range|string »Most elements that require a quantitative value will also have a field called amount type. Amount type should always be specified because the actual value of the amount is often dependent on it. EXAMPLE: In capturing the actual relative amounts of substances or molecular fragments it is essential to indicate whether the amount refers to a mole ratio or weight ratio. For any given element an effort should be made to use same the amount type for all related definitional elementsamountType : CodeableConcept [0..1]A textual comment on a numeric valueamountText : string [0..1]ReferenceRangeLower limit possible or expectedlowLimit : Quantity [0..1]Upper limit possible or expectedhighLimit : Quantity [0..1]BackboneTypeMay be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself) (this element modifies the meaning of other elements)modifierExtension : Extension [0..*]Reference range of possible or expected valuesreferenceRange[0..1]

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .

[
 # from Element: Element.extension
  # SubstanceAmount.amount[x] : 0..1 Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field. One of these 3
    fhir:SubstanceAmount.amountQuantity [ Quantity ]
    fhir:SubstanceAmount.amountRange [ Range ]
    fhir:SubstanceAmount.amountString [ string ]
  fhir:SubstanceAmount.amountType [ CodeableConcept ]; # 0..1 Most elements that require a quantitative value will also have a field called amount type. Amount type should always be specified because the actual value of the amount is often dependent on it. EXAMPLE: In capturing the actual relative amounts of substances or molecular fragments it is essential to indicate whether the amount refers to a mole ratio or weight ratio. For any given element an effort should be made to use same the amount type for all related definitional elements
  fhir:SubstanceAmount.amountText [ string ]; # 0..1 A textual comment on a numeric value
  fhir:SubstanceAmount.referenceRange [ # 0..1 Reference range of possible or expected values
    fhir:SubstanceAmount.referenceRange.lowLimit [ Quantity ]; # 0..1 Lower limit possible or expected
    fhir:SubstanceAmount.referenceRange.highLimit [ Quantity ]; # 0..1 Upper limit possible or expected
  ];
]

Changes since Release 3

SubstanceAmount
  • No Changes

See the Full Difference for further information

Constraints

SubstanceAmount is used in the following places: SubstancePolymer