EvidenceVariable
Introduction
Scope and Usage
This resource is a definition resource from a FHIR workflow perspective - see Workflow, specifically Definition.
The scope of the EvidenceVariable Resource is to describe an element that knowledge (evidence) is about. The EvidenceVariable Resources are expected to be used with Evidence Resources to facilitate searching and knowledge representation.
Evidence may be reported for different types of knowledge. One commonly used format for expression of what evidence is about is the "PICO" format. PICO stands for:
Population - the population within which exposures and outcomes are being considered
Intervention - the conditional state or exposure state being described for which one is expressing the risk of or effect on an outcome
Comparison - the alternative conditional state or alternative exposure state when one is comparing states for the effect on an outcome
Outcome - the result or effect of an intervention or exposure in a population
PICO (and its variants like PECO using E for Exposure or PICOT adding T for Timing) is a universal acronym used in evidence-based medicine communities to clearly express research questions and evidence findings.
The EvidenceVariable Resource allows expression of the components of a PICO question in codeable and reusable formats. The EvidenceVariable.definition element has a CodeableReference datatype which can define the PICO component as a concept and/or reference to a Group Resource.
The EvidenceVariable Resource is also used within ResearchStudy to describe the endpoint for an outcome measure.
Boundaries and Relationships
The Resource describing evidence findings (Evidence) will reference EvidenceVariable to describe what the evidence findings are about.
The Resource describing a research study protocol (ResearchStudy) will reference EvidenceVariable to describe the endpoint for an outcome measure.
Background and Context
This resource may describe the intervention or exposure for which an evidence summary is applicable, or may describe the outcome or measured variable that an evidence summary is about. These descriptions could be used in coded specifications of recommendations from clinical practice guidelines to facilitate the translation from guidelines to clinical decision support artifacts. These descriptions could be used in Summary of Findings tables from systematic reviews to facilitate the representation of medical knowledge when creating recommendations. These descriptions could be used in classification of new evidence reports to facilitate recognition of signal for updating existing evidence summaries and recommendations.
StructureDefinition
Elements (Simplified)
- EvidenceVariable [0..*]: - A definition of an exposure, outcome, or other variable
- EvidenceVariable.url [0..1]: uri Canonical identifier for this evidence variable, represented as a URI (globally unique)
- EvidenceVariable.identifier [0..*]: Identifier Additional identifier for the evidence variable
- EvidenceVariable.version [0..1]: string Business version of the evidence variable
- EvidenceVariable.versionAlgorithm[x] [0..1]: string, Coding extensible:version-algorithm How to compare versions
- EvidenceVariable.name [0..1]: string Name for this evidence variable (computer friendly)
- EvidenceVariable.title [0..1]: string Name for this evidence variable (human friendly)
- EvidenceVariable.shortTitle [0..1]: string Title for use in informal contexts
- EvidenceVariable.citeAs [0..1]: markdown Display of how to cite this EvidenceVariable
- EvidenceVariable.status [1..1]: code required:publication-status draft | active | retired | unknown
- EvidenceVariable.experimental [0..1]: boolean For testing only - never for real usage
- EvidenceVariable.date [0..1]: dateTime Date last changed
- EvidenceVariable.author [0..*]: ContactDetail Who authored the content
- EvidenceVariable.publisher [0..1]: string Name of the publisher/steward (organization or individual)
- EvidenceVariable.contact [0..*]: ContactDetail Contact details for the publisher
- EvidenceVariable.recorder [0..*]: ContactDetail Who entered the data for the evidence variable
- EvidenceVariable.editor [0..*]: ContactDetail Who edited the content
- EvidenceVariable.reviewer [0..*]: ContactDetail Who reviewed the content
- EvidenceVariable.endorser [0..*]: ContactDetail Who endorsed the content
- EvidenceVariable.description [0..1]: markdown Natural language description of the evidence variable
- EvidenceVariable.note [0..*]: Annotation Used for footnotes or explanatory notes
- EvidenceVariable.useContext [0..*]: UsageContext The context that the content is intended to support
- EvidenceVariable.purpose [0..1]: markdown Why this EvidenceVariable is defined
- EvidenceVariable.copyright [0..1]: markdown Intellectual property ownership, may include restrictions on use
- EvidenceVariable.copyrightLabel [0..1]: string Copyright holder and year(s)
- EvidenceVariable.approvalDate [0..1]: date When the resource was approved by publisher
- EvidenceVariable.lastReviewDate [0..1]: date When the resource was last reviewed by the publisher
- EvidenceVariable.effectivePeriod [0..1]: Period When the resource is expected to be used
- EvidenceVariable.relatesTo [0..*]: BackboneElement Relationships to other Resources
- EvidenceVariable.relatesTo.type [1..1]: CodeableConcept extensible:artifact-relationship-type documentation | justification | citation | predecessor | successor | derived-from | depends-on | composed-of | part-of | amends | amended-with | appends | appended-with | cites | cited-by | comments-on | comment-in | contains | contained-in | corrects | correction-in | replaces | replaced-with | retracts | retracted-by | signs | similar-to | supports | supported-with | transforms | transformed-into | transformed-with | documents | specification-of | created-with | cite-as | reprint | reprint-of | summarizes
- EvidenceVariable.relatesTo.target[x] [1..1]: uri, Attachment, canonical, Reference(Resource), markdown The artifact that is related to this EvidenceVariable
- EvidenceVariable.actual [0..1]: boolean Actual or conceptual
- EvidenceVariable.definition [0..1]: CodeableReference example:evidence-variable-definition The meaning of the evidence variable
- EvidenceVariable.definitionModifier [0..*]: BackboneElement Further specification of the definition
- EvidenceVariable.definitionModifier.code [1..1]: CodeableConcept example:evidence-variable-definition-modifier-code Attribute of the definition
- EvidenceVariable.definitionModifier.value[x] [1..1]: CodeableConcept, boolean, Quantity, Range, Period, RelativeTime, Reference(Resource), Expression, uri Specification of the definition attribute
- EvidenceVariable.handling [0..1]: CodeableConcept example:variable-handling-example boolean | continuous | dichotomous | ordinal | polychotomous | time-to-event | not-specified
- EvidenceVariable.category [0..*]: BackboneElement A grouping for dichotomous, ordinal, or polychotomouos variables
- EvidenceVariable.category.name [0..1]: string Description of the grouping
- EvidenceVariable.category.value[x] [0..1]: CodeableConcept, Quantity, Range, Reference(Group) Definition of the grouping
- EvidenceVariable.conditional [0..1]: Expression Condition determining whether the data will be collected
- EvidenceVariable.classifier [0..*]: CodeableConcept example:evidence-variable-classifier Classification
- EvidenceVariable.dataStorage [0..*]: BackboneElement How the data element (value of the variable) is found
- EvidenceVariable.dataStorage.datatype [0..1]: CodeableConcept preferred:fhir-types Type of data used to express value of the variable
- EvidenceVariable.dataStorage.path [0..1]: string Where to find the data element in the dataset
- EvidenceVariable.dataStorage.delimiter [0..1]: string Character(s) separating values in a string-based list
- EvidenceVariable.dataStorage.component [0..*]: -
- EvidenceVariable.timing [0..1]: RelativeTime When the variable is observed
- EvidenceVariable.period [0..1]: Period Calendar-based timing when the variable is observed
- EvidenceVariable.constraint [0..*]: BackboneElement Limit on acceptability of data value
- EvidenceVariable.constraint.conditional [0..1]: CodeableConcept example:administrative-gender Condition determining whether this constraint applies
- EvidenceVariable.constraint.minimumQuantity [0..1]: Quantity The lowest permissible value of the variable
- EvidenceVariable.constraint.maximumQuantity [0..1]: Quantity The highest permissible value of the variable
- EvidenceVariable.constraint.earliestDateTime [0..1]: dateTime The earliest permissible value of the variable
- EvidenceVariable.constraint.latestDateTime [0..1]: dateTime The latest permissible value of the variable
- EvidenceVariable.constraint.minimumStringLength [0..1]: unsignedInt The lowest number of characters allowed for a value of the variable
- EvidenceVariable.constraint.maximumStringLength [0..1]: positiveInt The highest number of characters allowed for a value of the variable
- EvidenceVariable.constraint.code [0..1]: CodeableConcept example:evidence-variable-constraint Rule for acceptable data values
- EvidenceVariable.constraint.expression [0..1]: Expression Rule for acceptable data values, as an Expression
- EvidenceVariable.constraint.expectedValueSet [0..1]: Reference(ValueSet) List of anticipated values used to express value of the variable
- EvidenceVariable.constraint.expectedUnitsValueSet [0..1]: Reference(ValueSet) List of anticipated values used to express units for the value of the variable
- EvidenceVariable.constraint.anyValueAllowed [0..1]: boolean Permissibility of unanticipated value used to express value of the variable
- EvidenceVariable.missingDataMeaning [0..*]: CodeableConcept example:data-absent-reason How missing data can be interpreted
- EvidenceVariable.unacceptableDataHandling [0..*]: CodeableConcept example:evidence-variable-unacceptable-data-handling How erroneous data is processed
Mappings
- EvidenceVariable Mappings — 14 mapping entries
Resource Packs
list-EvidenceVariable-packs.xml
<?xml version="1.0" encoding="UTF-8"?>
<List xmlns="http://hl7.org/fhir" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://hl7.org/fhir ../../publish/List.xsd">
<id value="EvidenceVariable-packs"/>
<status value="current"/>
<mode value="working"/>
</List>
Search Parameters
- context — token — A use context assigned to the evidence variable —
(EvidenceVariable.useContext.value.ofType(CodeableConcept)) - context-quantity — quantity — A quantity- or range-valued use context assigned to the evidence variable —
(EvidenceVariable.useContext.value.ofType(Quantity)) | (EvidenceVariable.useContext.value.ofType(Range)) - context-type — token — A type of use context assigned to the evidence variable —
EvidenceVariable.useContext.code - context-type-quantity — composite — A use context type and quantity- or range-based value assigned to the evidence variable —
EvidenceVariable.useContext - context-type-value — composite — A use context type and value assigned to the evidence variable —
EvidenceVariable.useContext - date — date — The evidence variable publication date —
EvidenceVariable.date - description — string — The description of the evidence variable —
EvidenceVariable.description - identifier — token — External identifier for the evidence variable —
EvidenceVariable.identifier - name — string — Computationally friendly name of the evidence variable —
EvidenceVariable.name - publisher — string — Name of the publisher of the evidence variable —
EvidenceVariable.publisher - status — token — The current status of the evidence variable —
EvidenceVariable.status - title — string — The human-friendly name of the evidence variable —
EvidenceVariable.title - topic — token — Topics associated with the EvidenceVariable —
- - url — uri — The uri that identifies the evidence variable —
EvidenceVariable.url - version — token — The business version of the evidence variable —
EvidenceVariable.version - experimental — token — Whether the EvidenceVariable is experimental —
EvidenceVariable.experimental
Examples
- evidencevariable-example — evidencevariable-example
- evidencevariable-example-alive-independent-90day — evidencevariable-example-alive-independent-90day
- evidencevariable-example-alteplase-for-stroke — evidencevariable-example-alteplase-for-stroke
- evidencevariable-example-dead-or-dependent-90day — evidencevariable-example-dead-or-dependent-90day
- evidencevariable-example-fatal-ICH-in-7-days — evidencevariable-example-fatal-ICH-in-7-days
- evidencevariable-example-group-assignment — evidencevariable-example-group-assignment
- evidencevariable-example-mRS0-2-at-90days — evidencevariable-example-mRS0-2-at-90days
- evidencevariable-example-mRS3-6-at-90days — evidencevariable-example-mRS3-6-at-90days
- evidencevariable-example-no-alteplase — evidencevariable-example-no-alteplase
- evidencevariable-example-outcome-death-or-major-injury — evidencevariable-example-outcome-death-or-major-injury
- evidencevariable-example-participant-flow — evidencevariable-example-participant-flow
- evidencevariable-example-placebo — evidencevariable-example-placebo
- evidencevariable-examples-header — evidencevariable-examples-header
- example-alive-independent-90day — evidencevariable-example-alive-independent-90day — Alive and not functionally dependent 90 days
- example-alteplase-for-stroke — evidencevariable-example-alteplase-for-stroke — Alteplase for Stroke
- example-dead-or-dependent-90day — evidencevariable-example-dead-or-dependent-90day — Dead or functionally dependent at 90 days
- example-fatal-ICH-in-7-days — evidencevariable-example-fatal-ICH-in-7-days — Fatal Intracranial Hemorrhage Within Seven Days
- example-group-assignment — evidencevariable-example-group-assignment — GroupAssignment: PARACHUTE Trial jumping from aircraft with parachute vs. empty backpack
- example-mRS0-2-at-90days — evidencevariable-example-mRS0-2-at-90days — Modified Rankin Scale score 0-2 at 90 days after treatment
- example-mRS3-6-at-90days — evidencevariable-example-mRS3-6-at-90days — Modified Rankin Scale score 3-6 at 90 days after treatment
- example-no-alteplase — evidencevariable-example-no-alteplase — No Alteplase
- example-outcome-death-or-major-injury — evidencevariable-example-outcome-death-or-major-injury — Outcome: Death or Major Traumatic Injury on Impact
- example-participant-flow — evidencevariable-example-participant-flow — ParticipantFlowEvidenceVariable: PARACHUTE Trial Participants that declined randomization
- example-placebo — evidencevariable-example-placebo — Placebo
Mapping Exceptions
evidencevariable-fivews-mapping-exceptions.xml
Unmapped Elements
- FiveWs.what — Unknown
- FiveWs.actor — Unknown
- FiveWs.cause — Unknown
- FiveWs.class — Unknown
- FiveWs.where — Unknown
- FiveWs.context — Unknown
- FiveWs.init — Unknown
- FiveWs.source — Unknown
- FiveWs.who — Unknown
- FiveWs.grade — Unknown
- FiveWs.planned — Unknown
- FiveWs.done — Unknown
- FiveWs.subject — Unknown