description: The Measure resource provides the definition of a quality measure.
package_name: hl7.fhir.r5.examples
derivation: specialization
name: Measure
type: Measure
elements:
  description: {isModifier: false, short: Natural language description of the measure, type: markdown, mustSupport: false, isSummary: true, index: 16}
  date: {isModifier: false, short: Date last changed, type: dateTime, mustSupport: false, isSummary: true, index: 13}
  group:
    isModifier: false
    short: Population criteria group
    type: BackboneElement
    mustSupport: false
    array: true
    isSummary: false
    index: 46
    elements:
      description: {isModifier: false, short: Summary description, type: string, mustSupport: false, isSummary: false, index: 48}
      stratifier:
        isModifier: false
        short: Stratifier criteria for the measure
        type: BackboneElement
        mustSupport: false
        array: true
        isSummary: false
        index: 60
        elements:
          code:
            isModifier: false
            short: Meaning of the stratifier
            type: CodeableConcept
            mustSupport: false
            binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/measure-stratifier-example'}
            isSummary: false
            index: 61
          description: {isModifier: false, short: The human readable description of this stratifier, type: string, mustSupport: false, isSummary: false, index: 62}
          criteria: {isModifier: false, short: How the measure should be stratified, type: Expression, mustSupport: false, isSummary: false, index: 63}
          component:
            isModifier: false
            short: Stratifier criteria component for the measure
            index: 64
            type: BackboneElement
            mustSupport: false
            array: true
            elements:
              code:
                isModifier: false
                short: Meaning of the stratifier component
                type: CodeableConcept
                mustSupport: false
                binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/measure-stratifier-example'}
                isSummary: false
                index: 65
              description: {isModifier: false, short: The human readable description of this stratifier component, type: string, mustSupport: false, isSummary: false, index: 66}
              criteria: {isModifier: false, short: Component of how the measure should be stratified, type: Expression, mustSupport: false, isSummary: false, index: 67}
            required: [criteria]
            isSummary: false
      scoringUnit:
        isModifier: false
        short: What units?
        type: CodeableConcept
        mustSupport: false
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/measure-scoring-unit'}
        isSummary: true
        index: 52
      basis:
        isModifier: false
        short: Population basis
        type: code
        mustSupport: false
        meaningWhenMissing: boolean
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/fhir-types|5.0.0-ballot'}
        isSummary: true
        index: 50
      type:
        isModifier: false
        short: process | outcome | structure | patient-reported-outcome | composite
        type: CodeableConcept
        mustSupport: false
        array: true
        binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/measure-type'}
        isSummary: true
        index: 49
      population:
        isModifier: false
        short: Population criteria
        index: 54
        type: BackboneElement
        mustSupport: false
        array: true
        elements:
          code:
            isModifier: false
            short: initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
            type: CodeableConcept
            mustSupport: false
            binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/measure-population'}
            isSummary: false
            index: 55
          description: {isModifier: false, short: The human readable description of this population criteria, type: string, mustSupport: false, isSummary: false, index: 56}
          criteria: {isModifier: false, short: The criteria that defines this population, type: Expression, mustSupport: false, isSummary: false, index: 57}
          inputPopulationId: {isModifier: false, short: Which population, type: string, mustSupport: false, isSummary: false, index: 58}
          aggregateMethod:
            isModifier: false
            short: Aggregation method for a measure score (e.g. sum, average, median, minimum, maximum, count)
            type: CodeableConcept
            mustSupport: false
            binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/measure-aggregate-method'}
            isSummary: false
            index: 59
        required: [criteria]
        isSummary: false
      code:
        isModifier: false
        short: Meaning of the group
        type: CodeableConcept
        mustSupport: false
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/measure-group-example'}
        isSummary: false
        index: 47
      scoring:
        isModifier: false
        short: proportion | ratio | continuous-variable | cohort
        type: CodeableConcept
        mustSupport: false
        binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/measure-scoring'}
        isSummary: true
        index: 51
      improvementNotation:
        isModifier: false
        short: increase | decrease
        type: CodeableConcept
        mustSupport: false
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/measure-improvement-notation|5.0.0-ballot'}
        isSummary: true
        index: 53
  endorser: {isModifier: false, short: Who endorsed the content, type: ContactDetail, mustSupport: false, array: true, isSummary: false, index: 29}
  publisher: {isModifier: false, short: Name of the publisher/steward (organization or individual), type: string, mustSupport: false, isSummary: true, index: 14}
  approvalDate: {isModifier: false, short: When the measure was approved by publisher, type: date, mustSupport: false, isSummary: false, index: 22}
  compositeScoring:
    isModifier: false
    short: opportunity | all-or-nothing | linear | weighted
    type: CodeableConcept
    mustSupport: false
    binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/composite-measure-scoring'}
    isSummary: true
    index: 35
  disclaimer: {isModifier: false, short: Disclaimer for use of the measure or its referenced content, type: markdown, mustSupport: false, isSummary: true, index: 32}
  jurisdiction:
    isModifier: false
    short: Intended jurisdiction for measure (if applicable)
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/jurisdiction'}
    isSummary: true
    index: 18
  scoringUnit:
    isModifier: false
    short: What units?
    type: CodeableConcept
    mustSupport: false
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/measure-scoring-unit'}
    isSummary: true
    index: 34
  purpose: {isModifier: false, short: Why this measure is defined, type: markdown, mustSupport: false, isSummary: false, index: 19}
  subjectCodeableConcept: {isModifier: false, short: 'E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device', type: CodeableConcept, mustSupport: false, meaningWhenMissing: Patient, choiceOf: subject, isSummary: false, index: 10}
  name: {isModifier: false, short: Name for this measure (computer friendly), type: string, mustSupport: false, isSummary: true, index: 3}
  basis:
    isModifier: false
    short: Population basis
    type: code
    mustSupport: false
    meaningWhenMissing: boolean
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/fhir-types|5.0.0-ballot'}
    isSummary: true
    index: 12
  useContext: {isModifier: false, short: The context that the content is intended to support, type: UsageContext, mustSupport: false, array: true, isSummary: true, index: 17}
  copyright: {isModifier: false, short: Use and/or publishing restrictions, type: markdown, mustSupport: false, isSummary: false, index: 21}
  guidance: {isModifier: false, short: Additional guidance for implementers, type: markdown, mustSupport: false, isSummary: true, index: 45}
  type:
    isModifier: false
    short: process | outcome | structure | patient-reported-outcome | composite
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/measure-type'}
    isSummary: true
    index: 36
  experimental: {isModifier: false, short: 'For testing purposes, not real usage', type: boolean, mustSupport: false, meaningWhenMissing: 'If absent, this resource is treated as though it is not experimental.', isSummary: true, index: 7}
  topic:
    isModifier: false
    short: The category of the measure, such as Education, Treatment, Assessment, etc.
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/definition-topic'}
    isSummary: false
    index: 25
  title: {isModifier: false, short: Name for this measure (human friendly), type: string, mustSupport: false, isSummary: true, index: 4}
  supplementalData:
    isModifier: false
    short: What other data should be reported with the measure
    index: 68
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      code:
        isModifier: false
        short: Meaning of the supplemental data
        type: CodeableConcept
        mustSupport: false
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/measure-supplemental-data-example'}
        isSummary: false
        index: 69
      usage:
        isModifier: false
        short: supplemental-data | risk-adjustment-factor
        type: CodeableConcept
        mustSupport: false
        array: true
        binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/measure-data-usage'}
        isSummary: false
        index: 70
      description: {isModifier: false, short: The human readable description of this supplemental data, type: string, mustSupport: false, isSummary: false, index: 71}
      criteria: {isModifier: false, short: Expression describing additional data to be reported, type: Expression, mustSupport: false, isSummary: false, index: 72}
    required: [criteria]
    isSummary: false
  library: {isModifier: false, short: Logic used by the measure, type: canonical, mustSupport: false, array: true, isSummary: false, index: 31}
  author: {isModifier: false, short: Who authored the content, type: ContactDetail, mustSupport: false, array: true, isSummary: false, index: 26}
  term:
    isModifier: false
    short: Defined terms used in the measure documentation
    type: BackboneElement
    mustSupport: false
    array: true
    isSummary: false
    index: 42
    elements:
      code:
        isModifier: false
        short: What term?
        type: CodeableConcept
        mustSupport: false
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/measure-definition-example'}
        isSummary: false
        index: 43
      definition: {isModifier: false, short: Meaning of the term, type: markdown, mustSupport: false, isSummary: false, index: 44}
  usage: {isModifier: false, short: Describes the clinical usage of the measure, type: string, mustSupport: false, isSummary: false, index: 20}
  rationale: {isModifier: false, short: Detailed description of why the measure exists, type: markdown, mustSupport: false, isSummary: true, index: 39}
  status:
    isModifier: true
    short: draft | active | retired | unknown
    index: 6
    type: code
    mustSupport: false
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/publication-status|5.0.0-ballot'}
    isModifierReason: This is labeled as "Is Modifier" because applications should not use a retired {{title}} without due consideration
    isSummary: true
  subtitle: {isModifier: false, short: Subordinate title of the measure, type: string, mustSupport: false, isSummary: false, index: 5}
  url:
    constraint:
      cnl-1: {human: 'URL should not contain | or # - these characters make processing canonical references problematic', source: 'http://hl7.org/fhir/StructureDefinition/Measure', severity: warning, expression: 'url.matches(''([^|#])*'')'}
    isModifier: false
    short: Canonical identifier for this measure, represented as a URI (globally unique)
    type: uri
    mustSupport: false
    isSummary: true
    index: 0
  identifier: {isModifier: false, short: Additional identifier for the measure, type: Identifier, mustSupport: false, array: true, isSummary: true, index: 1}
  lastReviewDate: {isModifier: false, short: When the measure was last reviewed, type: date, mustSupport: false, isSummary: false, index: 23}
  editor: {isModifier: false, short: Who edited the content, type: ContactDetail, mustSupport: false, array: true, isSummary: false, index: 27}
  riskAdjustment: {isModifier: false, short: How risk adjustment is applied for this measure, type: string, mustSupport: false, isSummary: true, index: 37}
  scoring:
    isModifier: false
    short: proportion | ratio | continuous-variable | cohort
    type: CodeableConcept
    mustSupport: false
    binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/measure-scoring'}
    isSummary: true
    index: 33
  reviewer: {isModifier: false, short: Who reviewed the content, type: ContactDetail, mustSupport: false, array: true, isSummary: false, index: 28}
  version: {isModifier: false, short: Business version of the measure, type: string, mustSupport: false, isSummary: true, index: 2}
  relatedArtifact: {isModifier: false, short: 'Additional documentation, citations, etc.', type: RelatedArtifact, mustSupport: false, array: true, isSummary: false, index: 30}
  contact: {isModifier: false, short: Contact details for the publisher, type: ContactDetail, mustSupport: false, array: true, isSummary: true, index: 15}
  subjectReference:
    isModifier: false
    short: E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
    index: 11
    refers: ['http://hl7.org/fhir/StructureDefinition/Group']
    type: Reference
    mustSupport: false
    meaningWhenMissing: Patient
    choiceOf: subject
    isSummary: false
  improvementNotation:
    isModifier: false
    short: increase | decrease
    type: CodeableConcept
    mustSupport: false
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/measure-improvement-notation|5.0.0-ballot'}
    isSummary: true
    index: 41
  subject:
    isModifier: false
    short: E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
    mustSupport: false
    choices: [subjectCodeableConcept, subjectReference]
    meaningWhenMissing: Patient
    isSummary: false
    index: 9
  rateAggregation: {isModifier: false, short: How is rate aggregation performed for this measure, type: string, mustSupport: false, isSummary: true, index: 38}
  effectivePeriod: {isModifier: false, short: When the measure is expected to be used, type: Period, mustSupport: false, isSummary: true, index: 24}
  clinicalRecommendationStatement: {isModifier: false, short: Summary of clinical guidelines, type: markdown, mustSupport: false, isSummary: true, index: 40}
package_version: 5.0.0-ballot
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Measure
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 5.0.0-ballot
required: [status]