Release 4

This page is part of the FHIR Specification (v4.0.1: R4 - Mixed Normative and STU) in it's permanent home (it will always be available at this URL). 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.21 Resource SubstanceSpecification - Content

Biomedical Research and Regulation Work GroupMaturity Level: 0 Trial UseSecurity Category: Anonymous Compartments: Not linked to any defined compartments

The detailed description of a substance, typically at a level beyond what is used for prescribing.

This resource is still undergoing development and review by the appropriate Workgroups. At this time, is considered only as a draft resource not suitable for production implementation

This resource is referenced by MedicinalProductContraindication, MedicinalProductIndication and itself

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. SubstanceSpecification ΣTUDomainResourceThe detailed description of a substance, typically at a level beyond what is used for prescribing
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..1IdentifierIdentifier by which this substance is known
... type Σ0..1CodeableConceptHigh level categorization, e.g. polymer or nucleic acid
... status Σ0..1CodeableConceptStatus of substance within the catalogue e.g. approved
... domain Σ0..1CodeableConceptIf the substance applies to only human or veterinary use
... description Σ0..1stringTextual description of the substance
... source Σ0..*Reference(DocumentReference)Supporting literature
... comment Σ0..1stringTextual comment about this record of a substance
... moiety Σ0..*BackboneElementMoiety, for structural modifications
.... role Σ0..1CodeableConceptRole that the moiety is playing
.... identifier Σ0..1IdentifierIdentifier by which this moiety substance is known
.... name Σ0..1stringTextual name for this moiety substance
.... stereochemistry Σ0..1CodeableConceptStereochemistry type
.... opticalActivity Σ0..1CodeableConceptOptical activity type
.... molecularFormula Σ0..1stringMolecular formula
.... amount[x] Σ0..1Quantitative value for this moiety
..... amountQuantityQuantity
..... amountStringstring
... property Σ0..*BackboneElementGeneral specifications for this substance, including how it is related to other substances
.... category Σ0..1CodeableConceptA category for this property, e.g. Physical, Chemical, Enzymatic
.... code Σ0..1CodeableConceptProperty type e.g. viscosity, pH, isoelectric point
.... parameters Σ0..1stringParameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1)
.... definingSubstance[x] Σ0..1A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol)
..... definingSubstanceReferenceReference(SubstanceSpecification | Substance)
..... definingSubstanceCodeableConceptCodeableConcept
.... amount[x] Σ0..1Quantitative value for this property
..... amountQuantityQuantity
..... amountStringstring
... referenceInformation Σ0..1Reference(SubstanceReferenceInformation)General information detailing this substance
... structure Σ0..1BackboneElementStructural information
.... stereochemistry Σ0..1CodeableConceptStereochemistry type
.... opticalActivity Σ0..1CodeableConceptOptical activity type
.... molecularFormula Σ0..1stringMolecular formula
.... molecularFormulaByMoiety Σ0..1stringSpecified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot
.... isotope Σ0..*BackboneElementApplicable for single substances that contain a radionuclide or a non-natural isotopic ratio
..... identifier Σ0..1IdentifierSubstance identifier for each non-natural or radioisotope
..... name Σ0..1CodeableConceptSubstance name for each non-natural or radioisotope
..... substitution Σ0..1CodeableConceptThe type of isotopic substitution present in a single substance
..... halfLife Σ0..1QuantityHalf life - for a non-natural nuclide
..... molecularWeight Σ0..1BackboneElementThe molecular weight or weight range (for proteins, polymers or nucleic acids)
...... method Σ0..1CodeableConceptThe method by which the molecular weight was determined
...... type Σ0..1CodeableConceptType of molecular weight such as exact, average (also known as. number average), weight average
...... amount Σ0..1QuantityUsed 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
.... molecularWeight Σ0..1see molecularWeightThe molecular weight or weight range (for proteins, polymers or nucleic acids)
.... source Σ0..*Reference(DocumentReference)Supporting literature
.... representation Σ0..*BackboneElementMolecular structural representation
..... type Σ0..1CodeableConceptThe type of structure (e.g. Full, Partial, Representative)
..... representation Σ0..1stringThe structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX
..... attachment Σ0..1AttachmentAn attached file with the structural representation
... code Σ0..*BackboneElementCodes associated with the substance
.... code Σ0..1CodeableConceptThe specific code
.... status Σ0..1CodeableConceptStatus of the code assignment
.... statusDate Σ0..1dateTimeThe date at which the code status is changed as part of the terminology maintenance
.... comment Σ0..1stringAny comment can be provided in this field, if necessary
.... source Σ0..*Reference(DocumentReference)Supporting literature
... name Σ0..*BackboneElementNames applicable to this substance
.... name Σ1..1stringThe actual name
.... type Σ0..1CodeableConceptName type
.... status Σ0..1CodeableConceptThe status of the name
.... preferred Σ0..1booleanIf this is the preferred name for this substance
.... language Σ0..*CodeableConceptLanguage of the name
.... domain Σ0..*CodeableConceptThe use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive
.... jurisdiction Σ0..*CodeableConceptThe jurisdiction where this name applies
.... synonym Σ0..*see nameA synonym of this name
.... translation Σ0..*see nameA translation for this name
.... official Σ0..*BackboneElementDetails of the official nature of this name
..... authority Σ0..1CodeableConceptWhich authority uses this official name
..... status Σ0..1CodeableConceptThe status of the official name
..... date Σ0..1dateTimeDate of official name change
.... source Σ0..*Reference(DocumentReference)Supporting literature
... molecularWeight Σ0..*see molecularWeightThe molecular weight or weight range (for proteins, polymers or nucleic acids)
... relationship Σ0..*BackboneElementA link between this substance and another, with details of the relationship
.... substance[x] Σ0..1A pointer to another substance, as a resource or just a representational code
..... substanceReferenceReference(SubstanceSpecification)
..... substanceCodeableConceptCodeableConcept
.... relationship Σ0..1CodeableConceptFor example "salt to parent", "active moiety", "starting material"
.... isDefining Σ0..1booleanFor example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships
.... amount[x] Σ0..1A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other
..... amountQuantityQuantity
..... amountRangeRange
..... amountRatioRatio
..... amountStringstring
.... amountRatioLowLimit Σ0..1RatioFor use when the numeric
.... amountType Σ0..1CodeableConceptAn operator for the amount, for example "average", "approximately", "less than"
.... source Σ0..*Reference(DocumentReference)Supporting literature
... nucleicAcid Σ0..1Reference(SubstanceNucleicAcid)Data items specific to nucleic acids
... polymer Σ0..1Reference(SubstancePolymer)Data items specific to polymers
... protein Σ0..1Reference(SubstanceProtein)Data items specific to proteins
... sourceMaterial Σ0..1Reference(SubstanceSourceMaterial)Material or taxonomic/anatomical source for the substance

doco Documentation for this format

UML Diagram (Legend)

SubstanceSpecification (DomainResource)Identifier by which this substance is knownidentifier : Identifier [0..1]High level categorization, e.g. polymer or nucleic acidtype : CodeableConcept [0..1]Status of substance within the catalogue e.g. approvedstatus : CodeableConcept [0..1]If the substance applies to only human or veterinary usedomain : CodeableConcept [0..1]Textual description of the substancedescription : string [0..1]Supporting literaturesource : Reference [0..*] « DocumentReference »Textual comment about this record of a substancecomment : string [0..1]General information detailing this substancereferenceInformation : Reference [0..1] « SubstanceReferenceInformation »Data items specific to nucleic acidsnucleicAcid : Reference [0..1] « SubstanceNucleicAcid »Data items specific to polymerspolymer : Reference [0..1] « SubstancePolymer »Data items specific to proteinsprotein : Reference [0..1] « SubstanceProtein »Material or taxonomic/anatomical source for the substancesourceMaterial : Reference [0..1] « SubstanceSourceMaterial »MoietyRole that the moiety is playingrole : CodeableConcept [0..1]Identifier by which this moiety substance is knownidentifier : Identifier [0..1]Textual name for this moiety substancename : string [0..1]Stereochemistry typestereochemistry : CodeableConcept [0..1]Optical activity typeopticalActivity : CodeableConcept [0..1]Molecular formulamolecularFormula : string [0..1]Quantitative value for this moietyamount[x] : Type [0..1] « Quantity|string »PropertyA category for this property, e.g. Physical, Chemical, Enzymaticcategory : CodeableConcept [0..1]Property type e.g. viscosity, pH, isoelectric pointcode : CodeableConcept [0..1]Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1)parameters : string [0..1]A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol)definingSubstance[x] : Type [0..1] « Reference( SubstanceSpecification|Substance)|CodeableConcept »Quantitative value for this propertyamount[x] : Type [0..1] « Quantity|string »StructureStereochemistry typestereochemistry : CodeableConcept [0..1]Optical activity typeopticalActivity : CodeableConcept [0..1]Molecular formulamolecularFormula : string [0..1]Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dotmolecularFormulaByMoiety : string [0..1]Supporting literaturesource : Reference [0..*] « DocumentReference »IsotopeSubstance identifier for each non-natural or radioisotopeidentifier : Identifier [0..1]Substance name for each non-natural or radioisotopename : CodeableConcept [0..1]The type of isotopic substitution present in a single substancesubstitution : CodeableConcept [0..1]Half life - for a non-natural nuclidehalfLife : Quantity [0..1]MolecularWeightThe method by which the molecular weight was determinedmethod : CodeableConcept [0..1]Type of molecular weight such as exact, average (also known as. number average), weight averagetype : CodeableConcept [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 fieldamount : Quantity [0..1]RepresentationThe type of structure (e.g. Full, Partial, Representative)type : CodeableConcept [0..1]The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDXrepresentation : string [0..1]An attached file with the structural representationattachment : Attachment [0..1]codeThe specific codecode : CodeableConcept [0..1]Status of the code assignmentstatus : CodeableConcept [0..1]The date at which the code status is changed as part of the terminology maintenancestatusDate : dateTime [0..1]Any comment can be provided in this field, if necessarycomment : string [0..1]Supporting literaturesource : Reference [0..*] « DocumentReference »NameThe actual namename : string [1..1]Name typetype : CodeableConcept [0..1]The status of the namestatus : CodeableConcept [0..1]If this is the preferred name for this substancepreferred : boolean [0..1]Language of the namelanguage : CodeableConcept [0..*]The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additivedomain : CodeableConcept [0..*]The jurisdiction where this name appliesjurisdiction : CodeableConcept [0..*]Supporting literaturesource : Reference [0..*] « DocumentReference »OfficialWhich authority uses this official nameauthority : CodeableConcept [0..1]The status of the official namestatus : CodeableConcept [0..1]Date of official name changedate : dateTime [0..1]RelationshipA pointer to another substance, as a resource or just a representational codesubstance[x] : Type [0..1] « Reference(SubstanceSpecification)| CodeableConcept »For example "salt to parent", "active moiety", "starting material"relationship : CodeableConcept [0..1]For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationshipsisDefining : boolean [0..1]A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some otheramount[x] : Type [0..1] « Quantity|Range|Ratio|string »For use when the numericamountRatioLowLimit : Ratio [0..1]An operator for the amount, for example "average", "approximately", "less than"amountType : CodeableConcept [0..1]Supporting literaturesource : Reference [0..*] « DocumentReference »Moiety, for structural modificationsmoiety[0..*]General specifications for this substance, including how it is related to other substancesproperty[0..*]The molecular weight or weight range (for proteins, polymers or nucleic acids)molecularWeight[0..1]Applicable for single substances that contain a radionuclide or a non-natural isotopic ratioisotope[0..*]The molecular weight or weight range (for proteins, polymers or nucleic acids)molecularWeight[0..1]Molecular structural representationrepresentation[0..*]Structural informationstructure[0..1]Codes associated with the substancecode[0..*]A synonym of this namesynonym[0..*]A translation for this nametranslation[0..*]Details of the official nature of this nameofficial[0..*]Names applicable to this substancename[0..*]The molecular weight or weight range (for proteins, polymers or nucleic acids)molecularWeight[0..*]A link between this substance and another, with details of the relationshiprelationship[0..*]

XML Template

<SubstanceSpecification xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..1 Identifier Identifier by which this substance is known --></identifier>
 <type><!-- 0..1 CodeableConcept High level categorization, e.g. polymer or nucleic acid --></type>
 <status><!-- 0..1 CodeableConcept Status of substance within the catalogue e.g. approved --></status>
 <domain><!-- 0..1 CodeableConcept If the substance applies to only human or veterinary use --></domain>
 <description value="[string]"/><!-- 0..1 Textual description of the substance -->
 <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
 <comment value="[string]"/><!-- 0..1 Textual comment about this record of a substance -->
 <moiety>  <!-- 0..* Moiety, for structural modifications -->
  <role><!-- 0..1 CodeableConcept Role that the moiety is playing --></role>
  <identifier><!-- 0..1 Identifier Identifier by which this moiety substance is known --></identifier>
  <name value="[string]"/><!-- 0..1 Textual name for this moiety substance -->
  <stereochemistry><!-- 0..1 CodeableConcept Stereochemistry type --></stereochemistry>
  <opticalActivity><!-- 0..1 CodeableConcept Optical activity type --></opticalActivity>
  <molecularFormula value="[string]"/><!-- 0..1 Molecular formula -->
  <amount[x]><!-- 0..1 Quantity|string Quantitative value for this moiety --></amount[x]>
 </moiety>
 <property>  <!-- 0..* General specifications for this substance, including how it is related to other substances -->
  <category><!-- 0..1 CodeableConcept A category for this property, e.g. Physical, Chemical, Enzymatic --></category>
  <code><!-- 0..1 CodeableConcept Property type e.g. viscosity, pH, isoelectric point --></code>
  <parameters value="[string]"/><!-- 0..1 Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) -->
  <definingSubstance[x]><!-- 0..1 Reference(SubstanceSpecification|Substance)|
    CodeableConcept A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol) --></definingSubstance[x]>
  <amount[x]><!-- 0..1 Quantity|string Quantitative value for this property --></amount[x]>
 </property>
 <referenceInformation><!-- 0..1 Reference(SubstanceReferenceInformation) General information detailing this substance --></referenceInformation>
 <structure>  <!-- 0..1 Structural information -->
  <stereochemistry><!-- 0..1 CodeableConcept Stereochemistry type --></stereochemistry>
  <opticalActivity><!-- 0..1 CodeableConcept Optical activity type --></opticalActivity>
  <molecularFormula value="[string]"/><!-- 0..1 Molecular formula -->
  <molecularFormulaByMoiety value="[string]"/><!-- 0..1 Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot -->
  <isotope>  <!-- 0..* Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio -->
   <identifier><!-- 0..1 Identifier Substance identifier for each non-natural or radioisotope --></identifier>
   <name><!-- 0..1 CodeableConcept Substance name for each non-natural or radioisotope --></name>
   <substitution><!-- 0..1 CodeableConcept The type of isotopic substitution present in a single substance --></substitution>
   <halfLife><!-- 0..1 Quantity Half life - for a non-natural nuclide --></halfLife>
   <molecularWeight>  <!-- 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids) -->
    <method><!-- 0..1 CodeableConcept The method by which the molecular weight was determined --></method>
    <type><!-- 0..1 CodeableConcept Type of molecular weight such as exact, average (also known as. number average), weight average --></type>
    <amount><!-- 0..1 Quantity 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 --></amount>
   </molecularWeight>
  </isotope>
  <molecularWeight><!-- 0..1 Content as for SubstanceSpecification.structure.isotope.molecularWeight The molecular weight or weight range (for proteins, polymers or nucleic acids) --></molecularWeight>
  <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
  <representation>  <!-- 0..* Molecular structural representation -->
   <type><!-- 0..1 CodeableConcept The type of structure (e.g. Full, Partial, Representative) --></type>
   <representation value="[string]"/><!-- 0..1 The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX -->
   <attachment><!-- 0..1 Attachment An attached file with the structural representation --></attachment>
  </representation>
 </structure>
 <code>  <!-- 0..* Codes associated with the substance -->
  <code><!-- 0..1 CodeableConcept The specific code --></code>
  <status><!-- 0..1 CodeableConcept Status of the code assignment --></status>
  <statusDate value="[dateTime]"/><!-- 0..1 The date at which the code status is changed as part of the terminology maintenance -->
  <comment value="[string]"/><!-- 0..1 Any comment can be provided in this field, if necessary -->
  <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
 </code>
 <name>  <!-- 0..* Names applicable to this substance -->
  <name value="[string]"/><!-- 1..1 The actual name -->
  <type><!-- 0..1 CodeableConcept Name type --></type>
  <status><!-- 0..1 CodeableConcept The status of the name --></status>
  <preferred value="[boolean]"/><!-- 0..1 If this is the preferred name for this substance -->
  <language><!-- 0..* CodeableConcept Language of the name --></language>
  <domain><!-- 0..* CodeableConcept The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive --></domain>
  <jurisdiction><!-- 0..* CodeableConcept The jurisdiction where this name applies --></jurisdiction>
  <synonym><!-- 0..* Content as for SubstanceSpecification.name A synonym of this name --></synonym>
  <translation><!-- 0..* Content as for SubstanceSpecification.name A translation for this name --></translation>
  <official>  <!-- 0..* Details of the official nature of this name -->
   <authority><!-- 0..1 CodeableConcept Which authority uses this official name --></authority>
   <status><!-- 0..1 CodeableConcept The status of the official name --></status>
   <date value="[dateTime]"/><!-- 0..1 Date of official name change -->
  </official>
  <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
 </name>
 <molecularWeight><!-- 0..* Content as for SubstanceSpecification.structure.isotope.molecularWeight The molecular weight or weight range (for proteins, polymers or nucleic acids) --></molecularWeight>
 <relationship>  <!-- 0..* A link between this substance and another, with details of the relationship -->
  <substance[x]><!-- 0..1 Reference(SubstanceSpecification)|CodeableConcept A pointer to another substance, as a resource or just a representational code --></substance[x]>
  <relationship><!-- 0..1 CodeableConcept For example "salt to parent", "active moiety", "starting material" --></relationship>
  <isDefining value="[boolean]"/><!-- 0..1 For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships -->
  <amount[x]><!-- 0..1 Quantity|Range|Ratio|string A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other --></amount[x]>
  <amountRatioLowLimit><!-- 0..1 Ratio For use when the numeric --></amountRatioLowLimit>
  <amountType><!-- 0..1 CodeableConcept An operator for the amount, for example "average", "approximately", "less than" --></amountType>
  <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
 </relationship>
 <nucleicAcid><!-- 0..1 Reference(SubstanceNucleicAcid) Data items specific to nucleic acids --></nucleicAcid>
 <polymer><!-- 0..1 Reference(SubstancePolymer) Data items specific to polymers --></polymer>
 <protein><!-- 0..1 Reference(SubstanceProtein) Data items specific to proteins --></protein>
 <sourceMaterial><!-- 0..1 Reference(SubstanceSourceMaterial) Material or taxonomic/anatomical source for the substance --></sourceMaterial>
</SubstanceSpecification>

JSON Template

{doco
  "resourceType" : "SubstanceSpecification",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : { Identifier }, // Identifier by which this substance is known
  "type" : { CodeableConcept }, // High level categorization, e.g. polymer or nucleic acid
  "status" : { CodeableConcept }, // Status of substance within the catalogue e.g. approved
  "domain" : { CodeableConcept }, // If the substance applies to only human or veterinary use
  "description" : "<string>", // Textual description of the substance
  "source" : [{ Reference(DocumentReference) }], // Supporting literature
  "comment" : "<string>", // Textual comment about this record of a substance
  "moiety" : [{ // Moiety, for structural modifications
    "role" : { CodeableConcept }, // Role that the moiety is playing
    "identifier" : { Identifier }, // Identifier by which this moiety substance is known
    "name" : "<string>", // Textual name for this moiety substance
    "stereochemistry" : { CodeableConcept }, // Stereochemistry type
    "opticalActivity" : { CodeableConcept }, // Optical activity type
    "molecularFormula" : "<string>", // Molecular formula
    // amount[x]: Quantitative value for this moiety. One of these 2:
    "amountQuantity" : { Quantity }
    "amountString" : "<string>"
  }],
  "property" : [{ // General specifications for this substance, including how it is related to other substances
    "category" : { CodeableConcept }, // A category for this property, e.g. Physical, Chemical, Enzymatic
    "code" : { CodeableConcept }, // Property type e.g. viscosity, pH, isoelectric point
    "parameters" : "<string>", // Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1)
    // definingSubstance[x]: 
      A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol). One of these 2:
    "definingSubstanceReference" : { Reference(SubstanceSpecification|Substance) },
    "definingSubstanceCodeableConcept" : { CodeableConcept },
    // amount[x]: Quantitative value for this property. One of these 2:
    "amountQuantity" : { Quantity }
    "amountString" : "<string>"
  }],
  "referenceInformation" : { Reference(SubstanceReferenceInformation) }, // General information detailing this substance
  "structure" : { // Structural information
    "stereochemistry" : { CodeableConcept }, // Stereochemistry type
    "opticalActivity" : { CodeableConcept }, // Optical activity type
    "molecularFormula" : "<string>", // Molecular formula
    "molecularFormulaByMoiety" : "<string>", // Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot
    "isotope" : [{ // Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio
      "identifier" : { Identifier }, // Substance identifier for each non-natural or radioisotope
      "name" : { CodeableConcept }, // Substance name for each non-natural or radioisotope
      "substitution" : { CodeableConcept }, // The type of isotopic substitution present in a single substance
      "halfLife" : { Quantity }, // Half life - for a non-natural nuclide
      "molecularWeight" : { // The molecular weight or weight range (for proteins, polymers or nucleic acids)
        "method" : { CodeableConcept }, // The method by which the molecular weight was determined
        "type" : { CodeableConcept }, // Type of molecular weight such as exact, average (also known as. number average), weight average
        "amount" : { Quantity } // 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
      }
    }],
    "molecularWeight" : { Content as for SubstanceSpecification.structure.isotope.molecularWeight }, // The molecular weight or weight range (for proteins, polymers or nucleic acids)
    "source" : [{ Reference(DocumentReference) }], // Supporting literature
    "representation" : [{ // Molecular structural representation
      "type" : { CodeableConcept }, // The type of structure (e.g. Full, Partial, Representative)
      "representation" : "<string>", // The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX
      "attachment" : { Attachment } // An attached file with the structural representation
    }]
  },
  "code" : [{ // Codes associated with the substance
    "code" : { CodeableConcept }, // The specific code
    "status" : { CodeableConcept }, // Status of the code assignment
    "statusDate" : "<dateTime>", // The date at which the code status is changed as part of the terminology maintenance
    "comment" : "<string>", // Any comment can be provided in this field, if necessary
    "source" : [{ Reference(DocumentReference) }] // Supporting literature
  }],
  "name" : [{ // Names applicable to this substance
    "name" : "<string>", // R!  The actual name
    "type" : { CodeableConcept }, // Name type
    "status" : { CodeableConcept }, // The status of the name
    "preferred" : <boolean>, // If this is the preferred name for this substance
    "language" : [{ CodeableConcept }], // Language of the name
    "domain" : [{ CodeableConcept }], // The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive
    "jurisdiction" : [{ CodeableConcept }], // The jurisdiction where this name applies
    "synonym" : [{ Content as for SubstanceSpecification.name }], // A synonym of this name
    "translation" : [{ Content as for SubstanceSpecification.name }], // A translation for this name
    "official" : [{ // Details of the official nature of this name
      "authority" : { CodeableConcept }, // Which authority uses this official name
      "status" : { CodeableConcept }, // The status of the official name
      "date" : "<dateTime>" // Date of official name change
    }],
    "source" : [{ Reference(DocumentReference) }] // Supporting literature
  }],
  "molecularWeight" : [{ Content as for SubstanceSpecification.structure.isotope.molecularWeight }], // The molecular weight or weight range (for proteins, polymers or nucleic acids)
  "relationship" : [{ // A link between this substance and another, with details of the relationship
    // substance[x]: A pointer to another substance, as a resource or just a representational code. One of these 2:
    "substanceReference" : { Reference(SubstanceSpecification) },
    "substanceCodeableConcept" : { CodeableConcept },
    "relationship" : { CodeableConcept }, // For example "salt to parent", "active moiety", "starting material"
    "isDefining" : <boolean>, // For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships
    // amount[x]: 
      A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other. One of these 4:
    "amountQuantity" : { Quantity },
    "amountRange" : { Range },
    "amountRatio" : { Ratio },
    "amountString" : "<string>",
    "amountRatioLowLimit" : { Ratio }, // For use when the numeric
    "amountType" : { CodeableConcept }, // An operator for the amount, for example "average", "approximately", "less than"
    "source" : [{ Reference(DocumentReference) }] // Supporting literature
  }],
  "nucleicAcid" : { Reference(SubstanceNucleicAcid) }, // Data items specific to nucleic acids
  "polymer" : { Reference(SubstancePolymer) }, // Data items specific to polymers
  "protein" : { Reference(SubstanceProtein) }, // Data items specific to proteins
  "sourceMaterial" : { Reference(SubstanceSourceMaterial) } // Material or taxonomic/anatomical source for the substance
}

Turtle Template

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


[ a fhir:SubstanceSpecification;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:SubstanceSpecification.identifier [ Identifier ]; # 0..1 Identifier by which this substance is known
  fhir:SubstanceSpecification.type [ CodeableConcept ]; # 0..1 High level categorization, e.g. polymer or nucleic acid
  fhir:SubstanceSpecification.status [ CodeableConcept ]; # 0..1 Status of substance within the catalogue e.g. approved
  fhir:SubstanceSpecification.domain [ CodeableConcept ]; # 0..1 If the substance applies to only human or veterinary use
  fhir:SubstanceSpecification.description [ string ]; # 0..1 Textual description of the substance
  fhir:SubstanceSpecification.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
  fhir:SubstanceSpecification.comment [ string ]; # 0..1 Textual comment about this record of a substance
  fhir:SubstanceSpecification.moiety [ # 0..* Moiety, for structural modifications
    fhir:SubstanceSpecification.moiety.role [ CodeableConcept ]; # 0..1 Role that the moiety is playing
    fhir:SubstanceSpecification.moiety.identifier [ Identifier ]; # 0..1 Identifier by which this moiety substance is known
    fhir:SubstanceSpecification.moiety.name [ string ]; # 0..1 Textual name for this moiety substance
    fhir:SubstanceSpecification.moiety.stereochemistry [ CodeableConcept ]; # 0..1 Stereochemistry type
    fhir:SubstanceSpecification.moiety.opticalActivity [ CodeableConcept ]; # 0..1 Optical activity type
    fhir:SubstanceSpecification.moiety.molecularFormula [ string ]; # 0..1 Molecular formula
    # SubstanceSpecification.moiety.amount[x] : 0..1 Quantitative value for this moiety. One of these 2
      fhir:SubstanceSpecification.moiety.amountQuantity [ Quantity ]
      fhir:SubstanceSpecification.moiety.amountString [ string ]
  ], ...;
  fhir:SubstanceSpecification.property [ # 0..* General specifications for this substance, including how it is related to other substances
    fhir:SubstanceSpecification.property.category [ CodeableConcept ]; # 0..1 A category for this property, e.g. Physical, Chemical, Enzymatic
    fhir:SubstanceSpecification.property.code [ CodeableConcept ]; # 0..1 Property type e.g. viscosity, pH, isoelectric point
    fhir:SubstanceSpecification.property.parameters [ string ]; # 0..1 Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1)
    # SubstanceSpecification.property.definingSubstance[x] : 0..1 A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol). One of these 2
      fhir:SubstanceSpecification.property.definingSubstanceReference [ Reference(SubstanceSpecification|Substance) ]
      fhir:SubstanceSpecification.property.definingSubstanceCodeableConcept [ CodeableConcept ]
    # SubstanceSpecification.property.amount[x] : 0..1 Quantitative value for this property. One of these 2
      fhir:SubstanceSpecification.property.amountQuantity [ Quantity ]
      fhir:SubstanceSpecification.property.amountString [ string ]
  ], ...;
  fhir:SubstanceSpecification.referenceInformation [ Reference(SubstanceReferenceInformation) ]; # 0..1 General information detailing this substance
  fhir:SubstanceSpecification.structure [ # 0..1 Structural information
    fhir:SubstanceSpecification.structure.stereochemistry [ CodeableConcept ]; # 0..1 Stereochemistry type
    fhir:SubstanceSpecification.structure.opticalActivity [ CodeableConcept ]; # 0..1 Optical activity type
    fhir:SubstanceSpecification.structure.molecularFormula [ string ]; # 0..1 Molecular formula
    fhir:SubstanceSpecification.structure.molecularFormulaByMoiety [ string ]; # 0..1 Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot
    fhir:SubstanceSpecification.structure.isotope [ # 0..* Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio
      fhir:SubstanceSpecification.structure.isotope.identifier [ Identifier ]; # 0..1 Substance identifier for each non-natural or radioisotope
      fhir:SubstanceSpecification.structure.isotope.name [ CodeableConcept ]; # 0..1 Substance name for each non-natural or radioisotope
      fhir:SubstanceSpecification.structure.isotope.substitution [ CodeableConcept ]; # 0..1 The type of isotopic substitution present in a single substance
      fhir:SubstanceSpecification.structure.isotope.halfLife [ Quantity ]; # 0..1 Half life - for a non-natural nuclide
      fhir:SubstanceSpecification.structure.isotope.molecularWeight [ # 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids)
        fhir:SubstanceSpecification.structure.isotope.molecularWeight.method [ CodeableConcept ]; # 0..1 The method by which the molecular weight was determined
        fhir:SubstanceSpecification.structure.isotope.molecularWeight.type [ CodeableConcept ]; # 0..1 Type of molecular weight such as exact, average (also known as. number average), weight average
        fhir:SubstanceSpecification.structure.isotope.molecularWeight.amount [ Quantity ]; # 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
      ];
    ], ...;
    fhir:SubstanceSpecification.structure.molecularWeight [ See SubstanceSpecification.structure.isotope.molecularWeight ]; # 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids)
    fhir:SubstanceSpecification.structure.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
    fhir:SubstanceSpecification.structure.representation [ # 0..* Molecular structural representation
      fhir:SubstanceSpecification.structure.representation.type [ CodeableConcept ]; # 0..1 The type of structure (e.g. Full, Partial, Representative)
      fhir:SubstanceSpecification.structure.representation.representation [ string ]; # 0..1 The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX
      fhir:SubstanceSpecification.structure.representation.attachment [ Attachment ]; # 0..1 An attached file with the structural representation
    ], ...;
  ];
  fhir:SubstanceSpecification.code [ # 0..* Codes associated with the substance
    fhir:SubstanceSpecification.code.code [ CodeableConcept ]; # 0..1 The specific code
    fhir:SubstanceSpecification.code.status [ CodeableConcept ]; # 0..1 Status of the code assignment
    fhir:SubstanceSpecification.code.statusDate [ dateTime ]; # 0..1 The date at which the code status is changed as part of the terminology maintenance
    fhir:SubstanceSpecification.code.comment [ string ]; # 0..1 Any comment can be provided in this field, if necessary
    fhir:SubstanceSpecification.code.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
  ], ...;
  fhir:SubstanceSpecification.name [ # 0..* Names applicable to this substance
    fhir:SubstanceSpecification.name.name [ string ]; # 1..1 The actual name
    fhir:SubstanceSpecification.name.type [ CodeableConcept ]; # 0..1 Name type
    fhir:SubstanceSpecification.name.status [ CodeableConcept ]; # 0..1 The status of the name
    fhir:SubstanceSpecification.name.preferred [ boolean ]; # 0..1 If this is the preferred name for this substance
    fhir:SubstanceSpecification.name.language [ CodeableConcept ], ... ; # 0..* Language of the name
    fhir:SubstanceSpecification.name.domain [ CodeableConcept ], ... ; # 0..* The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive
    fhir:SubstanceSpecification.name.jurisdiction [ CodeableConcept ], ... ; # 0..* The jurisdiction where this name applies
    fhir:SubstanceSpecification.name.synonym [ See SubstanceSpecification.name ], ... ; # 0..* A synonym of this name
    fhir:SubstanceSpecification.name.translation [ See SubstanceSpecification.name ], ... ; # 0..* A translation for this name
    fhir:SubstanceSpecification.name.official [ # 0..* Details of the official nature of this name
      fhir:SubstanceSpecification.name.official.authority [ CodeableConcept ]; # 0..1 Which authority uses this official name
      fhir:SubstanceSpecification.name.official.status [ CodeableConcept ]; # 0..1 The status of the official name
      fhir:SubstanceSpecification.name.official.date [ dateTime ]; # 0..1 Date of official name change
    ], ...;
    fhir:SubstanceSpecification.name.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
  ], ...;
  fhir:SubstanceSpecification.molecularWeight [ See SubstanceSpecification.structure.isotope.molecularWeight ], ... ; # 0..* The molecular weight or weight range (for proteins, polymers or nucleic acids)
  fhir:SubstanceSpecification.relationship [ # 0..* A link between this substance and another, with details of the relationship
    # SubstanceSpecification.relationship.substance[x] : 0..1 A pointer to another substance, as a resource or just a representational code. One of these 2
      fhir:SubstanceSpecification.relationship.substanceReference [ Reference(SubstanceSpecification) ]
      fhir:SubstanceSpecification.relationship.substanceCodeableConcept [ CodeableConcept ]
    fhir:SubstanceSpecification.relationship.relationship [ CodeableConcept ]; # 0..1 For example "salt to parent", "active moiety", "starting material"
    fhir:SubstanceSpecification.relationship.isDefining [ boolean ]; # 0..1 For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships
    # SubstanceSpecification.relationship.amount[x] : 0..1 A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other. One of these 4
      fhir:SubstanceSpecification.relationship.amountQuantity [ Quantity ]
      fhir:SubstanceSpecification.relationship.amountRange [ Range ]
      fhir:SubstanceSpecification.relationship.amountRatio [ Ratio ]
      fhir:SubstanceSpecification.relationship.amountString [ string ]
    fhir:SubstanceSpecification.relationship.amountRatioLowLimit [ Ratio ]; # 0..1 For use when the numeric
    fhir:SubstanceSpecification.relationship.amountType [ CodeableConcept ]; # 0..1 An operator for the amount, for example "average", "approximately", "less than"
    fhir:SubstanceSpecification.relationship.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
  ], ...;
  fhir:SubstanceSpecification.nucleicAcid [ Reference(SubstanceNucleicAcid) ]; # 0..1 Data items specific to nucleic acids
  fhir:SubstanceSpecification.polymer [ Reference(SubstancePolymer) ]; # 0..1 Data items specific to polymers
  fhir:SubstanceSpecification.protein [ Reference(SubstanceProtein) ]; # 0..1 Data items specific to proteins
  fhir:SubstanceSpecification.sourceMaterial [ Reference(SubstanceSourceMaterial) ]; # 0..1 Material or taxonomic/anatomical source for the substance
]

Changes since R3

This resource did not exist in Release 2

This analysis is available as XML or JSON.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. SubstanceSpecification ΣTUDomainResourceThe detailed description of a substance, typically at a level beyond what is used for prescribing
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..1IdentifierIdentifier by which this substance is known
... type Σ0..1CodeableConceptHigh level categorization, e.g. polymer or nucleic acid
... status Σ0..1CodeableConceptStatus of substance within the catalogue e.g. approved
... domain Σ0..1CodeableConceptIf the substance applies to only human or veterinary use
... description Σ0..1stringTextual description of the substance
... source Σ0..*Reference(DocumentReference)Supporting literature
... comment Σ0..1stringTextual comment about this record of a substance
... moiety Σ0..*BackboneElementMoiety, for structural modifications
.... role Σ0..1CodeableConceptRole that the moiety is playing
.... identifier Σ0..1IdentifierIdentifier by which this moiety substance is known
.... name Σ0..1stringTextual name for this moiety substance
.... stereochemistry Σ0..1CodeableConceptStereochemistry type
.... opticalActivity Σ0..1CodeableConceptOptical activity type
.... molecularFormula Σ0..1stringMolecular formula
.... amount[x] Σ0..1Quantitative value for this moiety
..... amountQuantityQuantity
..... amountStringstring
... property Σ0..*BackboneElementGeneral specifications for this substance, including how it is related to other substances
.... category Σ0..1CodeableConceptA category for this property, e.g. Physical, Chemical, Enzymatic
.... code Σ0..1CodeableConceptProperty type e.g. viscosity, pH, isoelectric point
.... parameters Σ0..1stringParameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1)
.... definingSubstance[x] Σ0..1A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol)
..... definingSubstanceReferenceReference(SubstanceSpecification | Substance)
..... definingSubstanceCodeableConceptCodeableConcept
.... amount[x] Σ0..1Quantitative value for this property
..... amountQuantityQuantity
..... amountStringstring
... referenceInformation Σ0..1Reference(SubstanceReferenceInformation)General information detailing this substance
... structure Σ0..1BackboneElementStructural information
.... stereochemistry Σ0..1CodeableConceptStereochemistry type
.... opticalActivity Σ0..1CodeableConceptOptical activity type
.... molecularFormula Σ0..1stringMolecular formula
.... molecularFormulaByMoiety Σ0..1stringSpecified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot
.... isotope Σ0..*BackboneElementApplicable for single substances that contain a radionuclide or a non-natural isotopic ratio
..... identifier Σ0..1IdentifierSubstance identifier for each non-natural or radioisotope
..... name Σ0..1CodeableConceptSubstance name for each non-natural or radioisotope
..... substitution Σ0..1CodeableConceptThe type of isotopic substitution present in a single substance
..... halfLife Σ0..1QuantityHalf life - for a non-natural nuclide
..... molecularWeight Σ0..1BackboneElementThe molecular weight or weight range (for proteins, polymers or nucleic acids)
...... method Σ0..1CodeableConceptThe method by which the molecular weight was determined
...... type Σ0..1CodeableConceptType of molecular weight such as exact, average (also known as. number average), weight average
...... amount Σ0..1QuantityUsed 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
.... molecularWeight Σ0..1see molecularWeightThe molecular weight or weight range (for proteins, polymers or nucleic acids)
.... source Σ0..*Reference(DocumentReference)Supporting literature
.... representation Σ0..*BackboneElementMolecular structural representation
..... type Σ0..1CodeableConceptThe type of structure (e.g. Full, Partial, Representative)
..... representation Σ0..1stringThe structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX
..... attachment Σ0..1AttachmentAn attached file with the structural representation
... code Σ0..*BackboneElementCodes associated with the substance
.... code Σ0..1CodeableConceptThe specific code
.... status Σ0..1CodeableConceptStatus of the code assignment
.... statusDate Σ0..1dateTimeThe date at which the code status is changed as part of the terminology maintenance
.... comment Σ0..1stringAny comment can be provided in this field, if necessary
.... source Σ0..*Reference(DocumentReference)Supporting literature
... name Σ0..*BackboneElementNames applicable to this substance
.... name Σ1..1stringThe actual name
.... type Σ0..1CodeableConceptName type
.... status Σ0..1CodeableConceptThe status of the name
.... preferred Σ0..1booleanIf this is the preferred name for this substance
.... language Σ0..*CodeableConceptLanguage of the name
.... domain Σ0..*CodeableConceptThe use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive
.... jurisdiction Σ0..*CodeableConceptThe jurisdiction where this name applies
.... synonym Σ0..*see nameA synonym of this name
.... translation Σ0..*see nameA translation for this name
.... official Σ0..*BackboneElementDetails of the official nature of this name
..... authority Σ0..1CodeableConceptWhich authority uses this official name
..... status Σ0..1CodeableConceptThe status of the official name
..... date Σ0..1dateTimeDate of official name change
.... source Σ0..*Reference(DocumentReference)Supporting literature
... molecularWeight Σ0..*see molecularWeightThe molecular weight or weight range (for proteins, polymers or nucleic acids)
... relationship Σ0..*BackboneElementA link between this substance and another, with details of the relationship
.... substance[x] Σ0..1A pointer to another substance, as a resource or just a representational code
..... substanceReferenceReference(SubstanceSpecification)
..... substanceCodeableConceptCodeableConcept
.... relationship Σ0..1CodeableConceptFor example "salt to parent", "active moiety", "starting material"
.... isDefining Σ0..1booleanFor example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships
.... amount[x] Σ0..1A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other
..... amountQuantityQuantity
..... amountRangeRange
..... amountRatioRatio
..... amountStringstring
.... amountRatioLowLimit Σ0..1RatioFor use when the numeric
.... amountType Σ0..1CodeableConceptAn operator for the amount, for example "average", "approximately", "less than"
.... source Σ0..*Reference(DocumentReference)Supporting literature
... nucleicAcid Σ0..1Reference(SubstanceNucleicAcid)Data items specific to nucleic acids
... polymer Σ0..1Reference(SubstancePolymer)Data items specific to polymers
... protein Σ0..1Reference(SubstanceProtein)Data items specific to proteins
... sourceMaterial Σ0..1Reference(SubstanceSourceMaterial)Material or taxonomic/anatomical source for the substance

doco Documentation for this format

UML Diagram (Legend)

SubstanceSpecification (DomainResource)Identifier by which this substance is knownidentifier : Identifier [0..1]High level categorization, e.g. polymer or nucleic acidtype : CodeableConcept [0..1]Status of substance within the catalogue e.g. approvedstatus : CodeableConcept [0..1]If the substance applies to only human or veterinary usedomain : CodeableConcept [0..1]Textual description of the substancedescription : string [0..1]Supporting literaturesource : Reference [0..*] « DocumentReference »Textual comment about this record of a substancecomment : string [0..1]General information detailing this substancereferenceInformation : Reference [0..1] « SubstanceReferenceInformation »Data items specific to nucleic acidsnucleicAcid : Reference [0..1] « SubstanceNucleicAcid »Data items specific to polymerspolymer : Reference [0..1] « SubstancePolymer »Data items specific to proteinsprotein : Reference [0..1] « SubstanceProtein »Material or taxonomic/anatomical source for the substancesourceMaterial : Reference [0..1] « SubstanceSourceMaterial »MoietyRole that the moiety is playingrole : CodeableConcept [0..1]Identifier by which this moiety substance is knownidentifier : Identifier [0..1]Textual name for this moiety substancename : string [0..1]Stereochemistry typestereochemistry : CodeableConcept [0..1]Optical activity typeopticalActivity : CodeableConcept [0..1]Molecular formulamolecularFormula : string [0..1]Quantitative value for this moietyamount[x] : Type [0..1] « Quantity|string »PropertyA category for this property, e.g. Physical, Chemical, Enzymaticcategory : CodeableConcept [0..1]Property type e.g. viscosity, pH, isoelectric pointcode : CodeableConcept [0..1]Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1)parameters : string [0..1]A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol)definingSubstance[x] : Type [0..1] « Reference( SubstanceSpecification|Substance)|CodeableConcept »Quantitative value for this propertyamount[x] : Type [0..1] « Quantity|string »StructureStereochemistry typestereochemistry : CodeableConcept [0..1]Optical activity typeopticalActivity : CodeableConcept [0..1]Molecular formulamolecularFormula : string [0..1]Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dotmolecularFormulaByMoiety : string [0..1]Supporting literaturesource : Reference [0..*] « DocumentReference »IsotopeSubstance identifier for each non-natural or radioisotopeidentifier : Identifier [0..1]Substance name for each non-natural or radioisotopename : CodeableConcept [0..1]The type of isotopic substitution present in a single substancesubstitution : CodeableConcept [0..1]Half life - for a non-natural nuclidehalfLife : Quantity [0..1]MolecularWeightThe method by which the molecular weight was determinedmethod : CodeableConcept [0..1]Type of molecular weight such as exact, average (also known as. number average), weight averagetype : CodeableConcept [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 fieldamount : Quantity [0..1]RepresentationThe type of structure (e.g. Full, Partial, Representative)type : CodeableConcept [0..1]The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDXrepresentation : string [0..1]An attached file with the structural representationattachment : Attachment [0..1]codeThe specific codecode : CodeableConcept [0..1]Status of the code assignmentstatus : CodeableConcept [0..1]The date at which the code status is changed as part of the terminology maintenancestatusDate : dateTime [0..1]Any comment can be provided in this field, if necessarycomment : string [0..1]Supporting literaturesource : Reference [0..*] « DocumentReference »NameThe actual namename : string [1..1]Name typetype : CodeableConcept [0..1]The status of the namestatus : CodeableConcept [0..1]If this is the preferred name for this substancepreferred : boolean [0..1]Language of the namelanguage : CodeableConcept [0..*]The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additivedomain : CodeableConcept [0..*]The jurisdiction where this name appliesjurisdiction : CodeableConcept [0..*]Supporting literaturesource : Reference [0..*] « DocumentReference »OfficialWhich authority uses this official nameauthority : CodeableConcept [0..1]The status of the official namestatus : CodeableConcept [0..1]Date of official name changedate : dateTime [0..1]RelationshipA pointer to another substance, as a resource or just a representational codesubstance[x] : Type [0..1] « Reference(SubstanceSpecification)| CodeableConcept »For example "salt to parent", "active moiety", "starting material"relationship : CodeableConcept [0..1]For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationshipsisDefining : boolean [0..1]A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some otheramount[x] : Type [0..1] « Quantity|Range|Ratio|string »For use when the numericamountRatioLowLimit : Ratio [0..1]An operator for the amount, for example "average", "approximately", "less than"amountType : CodeableConcept [0..1]Supporting literaturesource : Reference [0..*] « DocumentReference »Moiety, for structural modificationsmoiety[0..*]General specifications for this substance, including how it is related to other substancesproperty[0..*]The molecular weight or weight range (for proteins, polymers or nucleic acids)molecularWeight[0..1]Applicable for single substances that contain a radionuclide or a non-natural isotopic ratioisotope[0..*]The molecular weight or weight range (for proteins, polymers or nucleic acids)molecularWeight[0..1]Molecular structural representationrepresentation[0..*]Structural informationstructure[0..1]Codes associated with the substancecode[0..*]A synonym of this namesynonym[0..*]A translation for this nametranslation[0..*]Details of the official nature of this nameofficial[0..*]Names applicable to this substancename[0..*]The molecular weight or weight range (for proteins, polymers or nucleic acids)molecularWeight[0..*]A link between this substance and another, with details of the relationshiprelationship[0..*]

XML Template

<SubstanceSpecification xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..1 Identifier Identifier by which this substance is known --></identifier>
 <type><!-- 0..1 CodeableConcept High level categorization, e.g. polymer or nucleic acid --></type>
 <status><!-- 0..1 CodeableConcept Status of substance within the catalogue e.g. approved --></status>
 <domain><!-- 0..1 CodeableConcept If the substance applies to only human or veterinary use --></domain>
 <description value="[string]"/><!-- 0..1 Textual description of the substance -->
 <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
 <comment value="[string]"/><!-- 0..1 Textual comment about this record of a substance -->
 <moiety>  <!-- 0..* Moiety, for structural modifications -->
  <role><!-- 0..1 CodeableConcept Role that the moiety is playing --></role>
  <identifier><!-- 0..1 Identifier Identifier by which this moiety substance is known --></identifier>
  <name value="[string]"/><!-- 0..1 Textual name for this moiety substance -->
  <stereochemistry><!-- 0..1 CodeableConcept Stereochemistry type --></stereochemistry>
  <opticalActivity><!-- 0..1 CodeableConcept Optical activity type --></opticalActivity>
  <molecularFormula value="[string]"/><!-- 0..1 Molecular formula -->
  <amount[x]><!-- 0..1 Quantity|string Quantitative value for this moiety --></amount[x]>
 </moiety>
 <property>  <!-- 0..* General specifications for this substance, including how it is related to other substances -->
  <category><!-- 0..1 CodeableConcept A category for this property, e.g. Physical, Chemical, Enzymatic --></category>
  <code><!-- 0..1 CodeableConcept Property type e.g. viscosity, pH, isoelectric point --></code>
  <parameters value="[string]"/><!-- 0..1 Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) -->
  <definingSubstance[x]><!-- 0..1 Reference(SubstanceSpecification|Substance)|
    CodeableConcept A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol) --></definingSubstance[x]>
  <amount[x]><!-- 0..1 Quantity|string Quantitative value for this property --></amount[x]>
 </property>
 <referenceInformation><!-- 0..1 Reference(SubstanceReferenceInformation) General information detailing this substance --></referenceInformation>
 <structure>  <!-- 0..1 Structural information -->
  <stereochemistry><!-- 0..1 CodeableConcept Stereochemistry type --></stereochemistry>
  <opticalActivity><!-- 0..1 CodeableConcept Optical activity type --></opticalActivity>
  <molecularFormula value="[string]"/><!-- 0..1 Molecular formula -->
  <molecularFormulaByMoiety value="[string]"/><!-- 0..1 Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot -->
  <isotope>  <!-- 0..* Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio -->
   <identifier><!-- 0..1 Identifier Substance identifier for each non-natural or radioisotope --></identifier>
   <name><!-- 0..1 CodeableConcept Substance name for each non-natural or radioisotope --></name>
   <substitution><!-- 0..1 CodeableConcept The type of isotopic substitution present in a single substance --></substitution>
   <halfLife><!-- 0..1 Quantity Half life - for a non-natural nuclide --></halfLife>
   <molecularWeight>  <!-- 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids) -->
    <method><!-- 0..1 CodeableConcept The method by which the molecular weight was determined --></method>
    <type><!-- 0..1 CodeableConcept Type of molecular weight such as exact, average (also known as. number average), weight average --></type>
    <amount><!-- 0..1 Quantity 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 --></amount>
   </molecularWeight>
  </isotope>
  <molecularWeight><!-- 0..1 Content as for SubstanceSpecification.structure.isotope.molecularWeight The molecular weight or weight range (for proteins, polymers or nucleic acids) --></molecularWeight>
  <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
  <representation>  <!-- 0..* Molecular structural representation -->
   <type><!-- 0..1 CodeableConcept The type of structure (e.g. Full, Partial, Representative) --></type>
   <representation value="[string]"/><!-- 0..1 The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX -->
   <attachment><!-- 0..1 Attachment An attached file with the structural representation --></attachment>
  </representation>
 </structure>
 <code>  <!-- 0..* Codes associated with the substance -->
  <code><!-- 0..1 CodeableConcept The specific code --></code>
  <status><!-- 0..1 CodeableConcept Status of the code assignment --></status>
  <statusDate value="[dateTime]"/><!-- 0..1 The date at which the code status is changed as part of the terminology maintenance -->
  <comment value="[string]"/><!-- 0..1 Any comment can be provided in this field, if necessary -->
  <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
 </code>
 <name>  <!-- 0..* Names applicable to this substance -->
  <name value="[string]"/><!-- 1..1 The actual name -->
  <type><!-- 0..1 CodeableConcept Name type --></type>
  <status><!-- 0..1 CodeableConcept The status of the name --></status>
  <preferred value="[boolean]"/><!-- 0..1 If this is the preferred name for this substance -->
  <language><!-- 0..* CodeableConcept Language of the name --></language>
  <domain><!-- 0..* CodeableConcept The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive --></domain>
  <jurisdiction><!-- 0..* CodeableConcept The jurisdiction where this name applies --></jurisdiction>
  <synonym><!-- 0..* Content as for SubstanceSpecification.name A synonym of this name --></synonym>
  <translation><!-- 0..* Content as for SubstanceSpecification.name A translation for this name --></translation>
  <official>  <!-- 0..* Details of the official nature of this name -->
   <authority><!-- 0..1 CodeableConcept Which authority uses this official name --></authority>
   <status><!-- 0..1 CodeableConcept The status of the official name --></status>
   <date value="[dateTime]"/><!-- 0..1 Date of official name change -->
  </official>
  <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
 </name>
 <molecularWeight><!-- 0..* Content as for SubstanceSpecification.structure.isotope.molecularWeight The molecular weight or weight range (for proteins, polymers or nucleic acids) --></molecularWeight>
 <relationship>  <!-- 0..* A link between this substance and another, with details of the relationship -->
  <substance[x]><!-- 0..1 Reference(SubstanceSpecification)|CodeableConcept A pointer to another substance, as a resource or just a representational code --></substance[x]>
  <relationship><!-- 0..1 CodeableConcept For example "salt to parent", "active moiety", "starting material" --></relationship>
  <isDefining value="[boolean]"/><!-- 0..1 For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships -->
  <amount[x]><!-- 0..1 Quantity|Range|Ratio|string A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other --></amount[x]>
  <amountRatioLowLimit><!-- 0..1 Ratio For use when the numeric --></amountRatioLowLimit>
  <amountType><!-- 0..1 CodeableConcept An operator for the amount, for example "average", "approximately", "less than" --></amountType>
  <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source>
 </relationship>
 <nucleicAcid><!-- 0..1 Reference(SubstanceNucleicAcid) Data items specific to nucleic acids --></nucleicAcid>
 <polymer><!-- 0..1 Reference(SubstancePolymer) Data items specific to polymers --></polymer>
 <protein><!-- 0..1 Reference(SubstanceProtein) Data items specific to proteins --></protein>
 <sourceMaterial><!-- 0..1 Reference(SubstanceSourceMaterial) Material or taxonomic/anatomical source for the substance --></sourceMaterial>
</SubstanceSpecification>

JSON Template

{doco
  "resourceType" : "SubstanceSpecification",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : { Identifier }, // Identifier by which this substance is known
  "type" : { CodeableConcept }, // High level categorization, e.g. polymer or nucleic acid
  "status" : { CodeableConcept }, // Status of substance within the catalogue e.g. approved
  "domain" : { CodeableConcept }, // If the substance applies to only human or veterinary use
  "description" : "<string>", // Textual description of the substance
  "source" : [{ Reference(DocumentReference) }], // Supporting literature
  "comment" : "<string>", // Textual comment about this record of a substance
  "moiety" : [{ // Moiety, for structural modifications
    "role" : { CodeableConcept }, // Role that the moiety is playing
    "identifier" : { Identifier }, // Identifier by which this moiety substance is known
    "name" : "<string>", // Textual name for this moiety substance
    "stereochemistry" : { CodeableConcept }, // Stereochemistry type
    "opticalActivity" : { CodeableConcept }, // Optical activity type
    "molecularFormula" : "<string>", // Molecular formula
    // amount[x]: Quantitative value for this moiety. One of these 2:
    "amountQuantity" : { Quantity }
    "amountString" : "<string>"
  }],
  "property" : [{ // General specifications for this substance, including how it is related to other substances
    "category" : { CodeableConcept }, // A category for this property, e.g. Physical, Chemical, Enzymatic
    "code" : { CodeableConcept }, // Property type e.g. viscosity, pH, isoelectric point
    "parameters" : "<string>", // Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1)
    // definingSubstance[x]: 
      A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol). One of these 2:
    "definingSubstanceReference" : { Reference(SubstanceSpecification|Substance) },
    "definingSubstanceCodeableConcept" : { CodeableConcept },
    // amount[x]: Quantitative value for this property. One of these 2:
    "amountQuantity" : { Quantity }
    "amountString" : "<string>"
  }],
  "referenceInformation" : { Reference(SubstanceReferenceInformation) }, // General information detailing this substance
  "structure" : { // Structural information
    "stereochemistry" : { CodeableConcept }, // Stereochemistry type
    "opticalActivity" : { CodeableConcept }, // Optical activity type
    "molecularFormula" : "<string>", // Molecular formula
    "molecularFormulaByMoiety" : "<string>", // Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot
    "isotope" : [{ // Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio
      "identifier" : { Identifier }, // Substance identifier for each non-natural or radioisotope
      "name" : { CodeableConcept }, // Substance name for each non-natural or radioisotope
      "substitution" : { CodeableConcept }, // The type of isotopic substitution present in a single substance
      "halfLife" : { Quantity }, // Half life - for a non-natural nuclide
      "molecularWeight" : { // The molecular weight or weight range (for proteins, polymers or nucleic acids)
        "method" : { CodeableConcept }, // The method by which the molecular weight was determined
        "type" : { CodeableConcept }, // Type of molecular weight such as exact, average (also known as. number average), weight average
        "amount" : { Quantity } // 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
      }
    }],
    "molecularWeight" : { Content as for SubstanceSpecification.structure.isotope.molecularWeight }, // The molecular weight or weight range (for proteins, polymers or nucleic acids)
    "source" : [{ Reference(DocumentReference) }], // Supporting literature
    "representation" : [{ // Molecular structural representation
      "type" : { CodeableConcept }, // The type of structure (e.g. Full, Partial, Representative)
      "representation" : "<string>", // The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX
      "attachment" : { Attachment } // An attached file with the structural representation
    }]
  },
  "code" : [{ // Codes associated with the substance
    "code" : { CodeableConcept }, // The specific code
    "status" : { CodeableConcept }, // Status of the code assignment
    "statusDate" : "<dateTime>", // The date at which the code status is changed as part of the terminology maintenance
    "comment" : "<string>", // Any comment can be provided in this field, if necessary
    "source" : [{ Reference(DocumentReference) }] // Supporting literature
  }],
  "name" : [{ // Names applicable to this substance
    "name" : "<string>", // R!  The actual name
    "type" : { CodeableConcept }, // Name type
    "status" : { CodeableConcept }, // The status of the name
    "preferred" : <boolean>, // If this is the preferred name for this substance
    "language" : [{ CodeableConcept }], // Language of the name
    "domain" : [{ CodeableConcept }], // The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive
    "jurisdiction" : [{ CodeableConcept }], // The jurisdiction where this name applies
    "synonym" : [{ Content as for SubstanceSpecification.name }], // A synonym of this name
    "translation" : [{ Content as for SubstanceSpecification.name }], // A translation for this name
    "official" : [{ // Details of the official nature of this name
      "authority" : { CodeableConcept }, // Which authority uses this official name
      "status" : { CodeableConcept }, // The status of the official name
      "date" : "<dateTime>" // Date of official name change
    }],
    "source" : [{ Reference(DocumentReference) }] // Supporting literature
  }],
  "molecularWeight" : [{ Content as for SubstanceSpecification.structure.isotope.molecularWeight }], // The molecular weight or weight range (for proteins, polymers or nucleic acids)
  "relationship" : [{ // A link between this substance and another, with details of the relationship
    // substance[x]: A pointer to another substance, as a resource or just a representational code. One of these 2:
    "substanceReference" : { Reference(SubstanceSpecification) },
    "substanceCodeableConcept" : { CodeableConcept },
    "relationship" : { CodeableConcept }, // For example "salt to parent", "active moiety", "starting material"
    "isDefining" : <boolean>, // For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships
    // amount[x]: 
      A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other. One of these 4:
    "amountQuantity" : { Quantity },
    "amountRange" : { Range },
    "amountRatio" : { Ratio },
    "amountString" : "<string>",
    "amountRatioLowLimit" : { Ratio }, // For use when the numeric
    "amountType" : { CodeableConcept }, // An operator for the amount, for example "average", "approximately", "less than"
    "source" : [{ Reference(DocumentReference) }] // Supporting literature
  }],
  "nucleicAcid" : { Reference(SubstanceNucleicAcid) }, // Data items specific to nucleic acids
  "polymer" : { Reference(SubstancePolymer) }, // Data items specific to polymers
  "protein" : { Reference(SubstanceProtein) }, // Data items specific to proteins
  "sourceMaterial" : { Reference(SubstanceSourceMaterial) } // Material or taxonomic/anatomical source for the substance
}

Turtle Template

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


[ a fhir:SubstanceSpecification;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:SubstanceSpecification.identifier [ Identifier ]; # 0..1 Identifier by which this substance is known
  fhir:SubstanceSpecification.type [ CodeableConcept ]; # 0..1 High level categorization, e.g. polymer or nucleic acid
  fhir:SubstanceSpecification.status [ CodeableConcept ]; # 0..1 Status of substance within the catalogue e.g. approved
  fhir:SubstanceSpecification.domain [ CodeableConcept ]; # 0..1 If the substance applies to only human or veterinary use
  fhir:SubstanceSpecification.description [ string ]; # 0..1 Textual description of the substance
  fhir:SubstanceSpecification.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
  fhir:SubstanceSpecification.comment [ string ]; # 0..1 Textual comment about this record of a substance
  fhir:SubstanceSpecification.moiety [ # 0..* Moiety, for structural modifications
    fhir:SubstanceSpecification.moiety.role [ CodeableConcept ]; # 0..1 Role that the moiety is playing
    fhir:SubstanceSpecification.moiety.identifier [ Identifier ]; # 0..1 Identifier by which this moiety substance is known
    fhir:SubstanceSpecification.moiety.name [ string ]; # 0..1 Textual name for this moiety substance
    fhir:SubstanceSpecification.moiety.stereochemistry [ CodeableConcept ]; # 0..1 Stereochemistry type
    fhir:SubstanceSpecification.moiety.opticalActivity [ CodeableConcept ]; # 0..1 Optical activity type
    fhir:SubstanceSpecification.moiety.molecularFormula [ string ]; # 0..1 Molecular formula
    # SubstanceSpecification.moiety.amount[x] : 0..1 Quantitative value for this moiety. One of these 2
      fhir:SubstanceSpecification.moiety.amountQuantity [ Quantity ]
      fhir:SubstanceSpecification.moiety.amountString [ string ]
  ], ...;
  fhir:SubstanceSpecification.property [ # 0..* General specifications for this substance, including how it is related to other substances
    fhir:SubstanceSpecification.property.category [ CodeableConcept ]; # 0..1 A category for this property, e.g. Physical, Chemical, Enzymatic
    fhir:SubstanceSpecification.property.code [ CodeableConcept ]; # 0..1 Property type e.g. viscosity, pH, isoelectric point
    fhir:SubstanceSpecification.property.parameters [ string ]; # 0..1 Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1)
    # SubstanceSpecification.property.definingSubstance[x] : 0..1 A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol). One of these 2
      fhir:SubstanceSpecification.property.definingSubstanceReference [ Reference(SubstanceSpecification|Substance) ]
      fhir:SubstanceSpecification.property.definingSubstanceCodeableConcept [ CodeableConcept ]
    # SubstanceSpecification.property.amount[x] : 0..1 Quantitative value for this property. One of these 2
      fhir:SubstanceSpecification.property.amountQuantity [ Quantity ]
      fhir:SubstanceSpecification.property.amountString [ string ]
  ], ...;
  fhir:SubstanceSpecification.referenceInformation [ Reference(SubstanceReferenceInformation) ]; # 0..1 General information detailing this substance
  fhir:SubstanceSpecification.structure [ # 0..1 Structural information
    fhir:SubstanceSpecification.structure.stereochemistry [ CodeableConcept ]; # 0..1 Stereochemistry type
    fhir:SubstanceSpecification.structure.opticalActivity [ CodeableConcept ]; # 0..1 Optical activity type
    fhir:SubstanceSpecification.structure.molecularFormula [ string ]; # 0..1 Molecular formula
    fhir:SubstanceSpecification.structure.molecularFormulaByMoiety [ string ]; # 0..1 Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot
    fhir:SubstanceSpecification.structure.isotope [ # 0..* Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio
      fhir:SubstanceSpecification.structure.isotope.identifier [ Identifier ]; # 0..1 Substance identifier for each non-natural or radioisotope
      fhir:SubstanceSpecification.structure.isotope.name [ CodeableConcept ]; # 0..1 Substance name for each non-natural or radioisotope
      fhir:SubstanceSpecification.structure.isotope.substitution [ CodeableConcept ]; # 0..1 The type of isotopic substitution present in a single substance
      fhir:SubstanceSpecification.structure.isotope.halfLife [ Quantity ]; # 0..1 Half life - for a non-natural nuclide
      fhir:SubstanceSpecification.structure.isotope.molecularWeight [ # 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids)
        fhir:SubstanceSpecification.structure.isotope.molecularWeight.method [ CodeableConcept ]; # 0..1 The method by which the molecular weight was determined
        fhir:SubstanceSpecification.structure.isotope.molecularWeight.type [ CodeableConcept ]; # 0..1 Type of molecular weight such as exact, average (also known as. number average), weight average
        fhir:SubstanceSpecification.structure.isotope.molecularWeight.amount [ Quantity ]; # 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
      ];
    ], ...;
    fhir:SubstanceSpecification.structure.molecularWeight [ See SubstanceSpecification.structure.isotope.molecularWeight ]; # 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids)
    fhir:SubstanceSpecification.structure.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
    fhir:SubstanceSpecification.structure.representation [ # 0..* Molecular structural representation
      fhir:SubstanceSpecification.structure.representation.type [ CodeableConcept ]; # 0..1 The type of structure (e.g. Full, Partial, Representative)
      fhir:SubstanceSpecification.structure.representation.representation [ string ]; # 0..1 The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX
      fhir:SubstanceSpecification.structure.representation.attachment [ Attachment ]; # 0..1 An attached file with the structural representation
    ], ...;
  ];
  fhir:SubstanceSpecification.code [ # 0..* Codes associated with the substance
    fhir:SubstanceSpecification.code.code [ CodeableConcept ]; # 0..1 The specific code
    fhir:SubstanceSpecification.code.status [ CodeableConcept ]; # 0..1 Status of the code assignment
    fhir:SubstanceSpecification.code.statusDate [ dateTime ]; # 0..1 The date at which the code status is changed as part of the terminology maintenance
    fhir:SubstanceSpecification.code.comment [ string ]; # 0..1 Any comment can be provided in this field, if necessary
    fhir:SubstanceSpecification.code.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
  ], ...;
  fhir:SubstanceSpecification.name [ # 0..* Names applicable to this substance
    fhir:SubstanceSpecification.name.name [ string ]; # 1..1 The actual name
    fhir:SubstanceSpecification.name.type [ CodeableConcept ]; # 0..1 Name type
    fhir:SubstanceSpecification.name.status [ CodeableConcept ]; # 0..1 The status of the name
    fhir:SubstanceSpecification.name.preferred [ boolean ]; # 0..1 If this is the preferred name for this substance
    fhir:SubstanceSpecification.name.language [ CodeableConcept ], ... ; # 0..* Language of the name
    fhir:SubstanceSpecification.name.domain [ CodeableConcept ], ... ; # 0..* The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive
    fhir:SubstanceSpecification.name.jurisdiction [ CodeableConcept ], ... ; # 0..* The jurisdiction where this name applies
    fhir:SubstanceSpecification.name.synonym [ See SubstanceSpecification.name ], ... ; # 0..* A synonym of this name
    fhir:SubstanceSpecification.name.translation [ See SubstanceSpecification.name ], ... ; # 0..* A translation for this name
    fhir:SubstanceSpecification.name.official [ # 0..* Details of the official nature of this name
      fhir:SubstanceSpecification.name.official.authority [ CodeableConcept ]; # 0..1 Which authority uses this official name
      fhir:SubstanceSpecification.name.official.status [ CodeableConcept ]; # 0..1 The status of the official name
      fhir:SubstanceSpecification.name.official.date [ dateTime ]; # 0..1 Date of official name change
    ], ...;
    fhir:SubstanceSpecification.name.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
  ], ...;
  fhir:SubstanceSpecification.molecularWeight [ See SubstanceSpecification.structure.isotope.molecularWeight ], ... ; # 0..* The molecular weight or weight range (for proteins, polymers or nucleic acids)
  fhir:SubstanceSpecification.relationship [ # 0..* A link between this substance and another, with details of the relationship
    # SubstanceSpecification.relationship.substance[x] : 0..1 A pointer to another substance, as a resource or just a representational code. One of these 2
      fhir:SubstanceSpecification.relationship.substanceReference [ Reference(SubstanceSpecification) ]
      fhir:SubstanceSpecification.relationship.substanceCodeableConcept [ CodeableConcept ]
    fhir:SubstanceSpecification.relationship.relationship [ CodeableConcept ]; # 0..1 For example "salt to parent", "active moiety", "starting material"
    fhir:SubstanceSpecification.relationship.isDefining [ boolean ]; # 0..1 For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships
    # SubstanceSpecification.relationship.amount[x] : 0..1 A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other. One of these 4
      fhir:SubstanceSpecification.relationship.amountQuantity [ Quantity ]
      fhir:SubstanceSpecification.relationship.amountRange [ Range ]
      fhir:SubstanceSpecification.relationship.amountRatio [ Ratio ]
      fhir:SubstanceSpecification.relationship.amountString [ string ]
    fhir:SubstanceSpecification.relationship.amountRatioLowLimit [ Ratio ]; # 0..1 For use when the numeric
    fhir:SubstanceSpecification.relationship.amountType [ CodeableConcept ]; # 0..1 An operator for the amount, for example "average", "approximately", "less than"
    fhir:SubstanceSpecification.relationship.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature
  ], ...;
  fhir:SubstanceSpecification.nucleicAcid [ Reference(SubstanceNucleicAcid) ]; # 0..1 Data items specific to nucleic acids
  fhir:SubstanceSpecification.polymer [ Reference(SubstancePolymer) ]; # 0..1 Data items specific to polymers
  fhir:SubstanceSpecification.protein [ Reference(SubstanceProtein) ]; # 0..1 Data items specific to proteins
  fhir:SubstanceSpecification.sourceMaterial [ Reference(SubstanceSourceMaterial) ]; # 0..1 Material or taxonomic/anatomical source for the substance
]

Changes since Release 3

This resource did not exist in Release 2

This analysis is available as XML or JSON.

 

See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the dependency analysis

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
codetokenThe specific codeSubstanceSpecification.code.code