ARCHETYPE Substance use summary (openEHR-EHR-EVALUATION.substance_use_summary.v0)

ARCHETYPE IDopenEHR-EHR-EVALUATION.substance_use_summary.v0
ConceptSubstance use summary
DescriptionSummary or persistent information about the typical use of a single addictive, or potentially addictive, substance by an individual.
UseUse to record summary information about the individual's pattern of use of an identified addictive, or potentially addictive, substance. This archetype is to be used to record information about both current and previous substance use behaviour. The specific scope of this archetype includes all types of addictive substances, including, but not limited to: recreational drugs; solvents; and caffeine. The only exceptions are alcohol consumption, tobacco smoking and smokeless tobacco use because these substances have been modelled in other, specific archetypes. The 'Episode' cluster allows for recording of specific details, routes and forms during a specified period of time. If the pattern, route or form changes significantly, record the details in a new instance of the Episode' CLUSTER. Triggers for closing one episode and commencing a new one will largely reflect local data collection preferences, including if the individual: - quits for a significant period of time; or - significantly changes their amount, route or form of their substance use. If multiple forms of the substance are consumed, the details will be recorded in the 'Per form' CLUSTER within this archetype. If multiple routes are used, the details will be recorded in the 'Per route' CLUSTER within this archetype. If other substances are used, the details will be recorded in another instance of this archetype. Use to incorporate the narrative descriptions of substance use habits within existing or legacy clinical systems into an archetyped format, using the 'Overall description' data element.
MisuseNot to be used to record information about tobacco use - use EVALUATION.tobacco_smoking_summary or EVALUATION.smokeless_tobacco_summary for this purpose. Not to be used to record information about alcohol use - use EVALUATION.alcohol_use_summary for this purpose. Not to be used to record event-or period-based information about substance use, such as actual daily use or the average use over a specified period of time - use the OBSERVATION.substance_use archetype.
PurposeTo record summary information about the individual's pattern of use of an identified addictive, or potentially addictive, substance.
References
Copyright© Nasjonal IKT HF, openEHR Foundation
AuthorsAuthor name: Heather Leslie
Organisation: Atomica Informatics
Email: heather.leslie@atomicainformatics.com
Date originally authored: 2020-02-13
Other Details LanguageAuthor name: Heather Leslie
Organisation: Atomica Informatics
Email: heather.leslie@atomicainformatics.com
Date originally authored: 2020-02-13
OtherDetails Language Independent{licence=This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/., custodian_organisation=openEHR Foundation, current_contact=Heather Leslie, Atomica Informatics, heather.leslie@atomicainformatics.com, original_namespace=org.openehr, original_publisher=openEHR Foundation, custodian_namespace=org.openehr, MD5-CAM-1.0.1=86CDFC31A6DA3187259522FB7C792BB4, build_uid=2460c4e1-c191-41f8-8a05-b0847d39267c, revision=0.0.1-alpha}
Keywords
Lifecyclein_development
UIDab5519ba-22b7-4574-af37-c2a84bc2f24c
Language useden
Citeable Identifier1051.32.1084
Revision Number0.0.1-alpha
AllArchetype [runtimeNameConstraintForConceptName=null, archetypeConceptBinding=null, archetypeConceptDescription=Summary or persistent information about the typical use of a single addictive, or potentially addictive, substance by an individual., archetypeConceptComment=null, otherContributors=Vebjørn Arntzen, Oslo universitetssykehus HF, Norway (Nasjonal IKT redaktør)
Silje Ljosland Bakke, Nasjonal IKT HF, Norway (openEHR Editor)
Heather Leslie, Atomica Informatics, Australia (openEHR Editor)
Ian McNicoll, freshEHR Clinical Informatics, United Kingdom (openEHR Editor)
John Tore Valand, Haukeland Universitetssjukehus, Norway (openEHR Editor)
Ingrid Skard, DIPS AS, Norway, originalLanguage=en, translators=, subjectOfData=unconstrained, archetypeTranslationTree=null, topLevelToAshis={state=[], content=[], capabilities=[], relationships=[], activities=[], events=[], contacts=[], description=[], target=[], context=[], identities=[], protocol=[ResourceSimplifiedHierarchyItem [path=/protocol[at0029]/items[at0031], code=at0031, itemType=ELEMENT, level=2, text=Last updated, description=The date this summary was last updated., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_DATE_TIME, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0029]/items[at0032], code=at0032, itemType=SLOT, level=2, text=Extension, description=Additional information required to extend the model with local content or to align with other reference models/formalisms., comment=For example: local information requirements; or additional metadata to align with FHIR., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include:
All not explicitly excluded archetypes, extendedValues=null]], other_participations=[], items=[], details=[], provider=[], source=[], ism_transition=[], data=[ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0002], code=at0002, itemType=ELEMENT, level=2, text=Substance name, description=The name of the substance or substance group/class used., comment=Coding with an external terminology is preferred, where possible., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0003], code=at0003, itemType=ELEMENT, level=2, text=Overall status, description=Statement about current use of the substance, in all forms and by all routes., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values=
  • Never used [The individual has never used the identified substance.]
  • Current user [The individual is currently using the identified substance.]
  • Former user [The individual has previously used the identified substance.]
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0007], code=at0007, itemType=ELEMENT, level=2, text=Overall description, description=Narrative summary about use behaviour for the substance., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0008], code=at0008, itemType=ELEMENT, level=2, text=First ever use, description=Date when the individual first used the substance., comment=Can be a partial date, for example, only a year., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_DATE_TIME, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0009], code=at0009, itemType=ELEMENT, level=2, text=Regular use commenced, description=The date when the individual first started frequent or regular, but usually non-daily, use of the substance., comment=Can be a partial date, for example, only a year. For example, this date could represent when the individual commenced using the substance every Friday night or at parties., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_DATE_TIME, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0010], code=at0010, itemType=ELEMENT, level=2, text=Daily use commenced, description=The date when the individual first started daily use of the substance., comment=Can be a partial date, for example, only a year., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_DATE_TIME, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0011], code=at0011, itemType=ELEMENT, level=2, text=Typical use, description=The typical amount and frequency of use of the substance, if consistent over time., comment=This data element effectively becomes redundant if usage patterns are recorded using the 'Per episode' cluster. If it is used concurrently with the 'Per episode' data elements, it is possible for the data recorded using this data element to become inconsistent or outdated as more detailed data is added to the 'Per episode' cluster., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Flow rate, mass
Units:
  • mg/d
  • g/d
  • mg/wk
  • g/wk
  • mg/mo
  • g/mo
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012], code=at0012, itemType=CLUSTER, level=2, text=Per episode, description=Details about a discrete period of use of the substance., comment=null, uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=1..*, cardinalityText=, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0013], code=at0013, itemType=ELEMENT, level=3, text=Episode label, description=Identification of an episode of substance use - either as a number in a sequence or a named event., comment=For example: '2' as the second episode within a sequence of episodes; or 'Pregnancy with twins' if describing the substance use during a health event such as a specific pregnancy., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
  •  Count
    min: >=0

  •  Text
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0014], code=at0014, itemType=ELEMENT, level=3, text=Episode start date, description=Date when this episode commenced., comment=Can be a partial date, for example, only a year., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_DATE_TIME, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0015], code=at0015, itemType=ELEMENT, level=3, text=Episode end date, description=Date when this episode ceased., comment=Can be a partial date, for example, only a year. This data field will be empty if the episode is current and ongoing., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_DATE_TIME, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0016], code=at0016, itemType=ELEMENT, level=3, text=Specific substance, description=The name of the specific substance used., comment=This data element may be redundant if the specific substance has been identified in the 'Substance name' data element. However if The 'Substance name' data element is recorded as a grouping or a class, it may be necessary to provide more specificity for a specific episode., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
  •  Count
    min: >=0

  •  Text
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0017], code=at0017, itemType=ELEMENT, level=3, text=Status, description=Date when this episode commenced., comment=Can be a partial date, for example, only a year., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0018], code=at0018, itemType=ELEMENT, level=3, text=Episode Description, description=Narrative summary about substance use during the episode., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_CODED_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0019], code=at0019, itemType=ELEMENT, level=3, text=Pattern, description=The typical pattern of substance use., comment=The typical pattern of use can be made more granular by coding with a terminology or a local value set in a template., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
  •  Text
  •  Coded Text
    • Daily [Use the substance at least once every day.]
    • Non-daily [Not using the substance every day.]
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0022], code=at0022, itemType=ELEMENT, level=3, text=Substance free days, description=The number of days where the substance was not used., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Units:
  • 0.0..7.0 1/wk
  • 0.0..31.0 1/mo
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0023], code=at0023, itemType=ELEMENT, level=3, text=Typical use, description=Typical amount and frequency of use., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=C_DV_QUANTITY, bindings=null, values=Property: Flow rate, mass
Units:
  • mg/d
  • g/d
  • mg/wk
  • g/wk
  • mg/mo
  • g/mo
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0033], code=at0033, itemType=CLUSTER, level=3, text=(Per form/route), description=Details about the substance use per form of the substance or per route of administration, during the episode., comment=null, uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=1..*, cardinalityText=, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Runtime name constraint:
  • Per form [Details about each form of the substance. For example: buds or oil.]
  • Per route [Details about each route of administration . For example: intravenous or inhalation.]
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0033]/items[at0036], code=at0036, itemType=ELEMENT, level=4, text=(Form/route), description=The name of the form or route., comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=Runtime name constraint:
  • Form [The form of the substance administered.]
  • Route [The route of administration of the substance.]
, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0033]/items[at0037], code=at0037, itemType=ELEMENT, level=4, text=Description, description=Narrative description about the substance use by the identified form or route., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0033]/items[at0040], code=at0040, itemType=ELEMENT, level=4, text=Typical use, description=Typical use by the identified form or route., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_QUANTITY, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0033]/items[at0041], code=at0041, itemType=ELEMENT, level=4, text=Comment, description=Additional narrative about the substance use by the identified form or route that has not been captured in other fields., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0024], code=at0024, itemType=ELEMENT, level=3, text=Number of quit attempts, description=Total number of times the individual has attempted to stop using the specified substance within this episode., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_COUNT, bindings=null, values=min: >=0

, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0025], code=at0025, itemType=SLOT, level=3, text=Episode details, description=Additional details about the episode., comment=null, uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include:
All not explicitly excluded archetypes, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0012]/items[at0026], code=at0026, itemType=ELEMENT, level=3, text=Episode comment, description=Additional narrative about use of the specific substance during this episode, not captured in other fields., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_DATE_TIME, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0027], code=at0027, itemType=SLOT, level=2, text=Overall details, description=Additional structured details about the overall use of the specified substance., comment=null, uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include:
All not explicitly excluded archetypes, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0028], code=at0028, itemType=ELEMENT, level=2, text=Overall quit date, description=The date when the individual last ceased all use of the substance., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_DATE_TIME, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/data[at0001]/items[at0030], code=at0030, itemType=ELEMENT, level=2, text=Overall comment, description=Additional narrative about the overall use of the substance that has not been captured in other fields., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null]], credentials=[]}, topLevelItems={protocol=ResourceSimplifiedHierarchyItem [path=ROOT_/protocol[at0029], code=at0029, itemType=ITEM_TREE, level=0, text=null, description=null, comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=0..1, cardinalityText=optional, subCardinalityFormal=0..*, subCardinalityText=Minimum of 0 items, dataType=ITEM_TREE, bindings=null, values=null, extendedValues=null], data=ResourceSimplifiedHierarchyItem [path=ROOT_/data[at0001], code=at0001, itemType=ITEM_TREE, level=0, text=null, description=null, comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=0..1, cardinalityText=optional, subCardinalityFormal=0..*, subCardinalityText=Minimum of 0 items, dataType=ITEM_TREE, bindings=null, values=null, extendedValues=null]}, addHierarchyItemsTo=protocol, currentHierarchyItemsForAdding=[ResourceSimplifiedHierarchyItem [path=/protocol[at0029]/items[at0031], code=at0031, itemType=ELEMENT, level=2, text=Last updated, description=The date this summary was last updated., comment=null, uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_DATE_TIME, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0029]/items[at0032], code=at0032, itemType=SLOT, level=2, text=Extension, description=Additional information required to extend the model with local content or to align with other reference models/formalisms., comment=For example: local information requirements; or additional metadata to align with FHIR., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include:
All not explicitly excluded archetypes, extendedValues=null]], minIndents={}, termBindingRetrievalErrorMessage=null]