description: The Measure resource provides the definition of a quality measure.
package_name: hl7.fhir.r6.core
derivation: specialization
name: Measure
type: Measure
elements:
  description: {isModifier: false, short: Natural language description of the measure, type: markdown, mustSupport: false, isSummary: true, index: 19}
  date: {isModifier: false, short: Date last changed, type: dateTime, mustSupport: false, isSummary: true, index: 16}
  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: markdown, mustSupport: false, isSummary: false, index: 50}
      linkId:
        constraint:
          mea-2: {human: Link ids should be 255 characters or less, source: 'http://hl7.org/fhir/StructureDefinition/Measure', severity: warning, expression: $this.length() <= 255}
        isModifier: false
        short: Unique id for group in measure
        type: string
        mustSupport: false
        isSummary: false
        index: 47
      compositeScoring:
        isModifier: false
        short: opportunity | all-or-nothing | linear | weighted
        type: CodeableConcept
        mustSupport: false
        binding: {strength: extensible, valueSet: 'http://terminology.hl7.org/ValueSet/composite-measure-scoring'}
        isSummary: true
        index: 61
      stratifier:
        isModifier: false
        short: Stratifier criteria for the measure
        type: BackboneElement
        mustSupport: false
        array: true
        isSummary: false
        index: 79
        elements:
          linkId:
            constraint:
              mea-4: {human: Link ids should be 255 characters or less, source: 'http://hl7.org/fhir/StructureDefinition/Measure', severity: warning, expression: $this.length() <= 255}
            isModifier: false
            short: Unique id for stratifier in measure
            type: string
            mustSupport: false
            isSummary: false
            index: 80
          title: {isModifier: false, short: Title of a group's stratifier. This title is expected in the corresponding MeasureReport.group.title, type: string, mustSupport: false, isSummary: false, index: 81}
          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: 82
          description: {isModifier: false, short: The human readable description of this stratifier, type: markdown, mustSupport: false, isSummary: false, index: 83}
          criteria: {isModifier: false, short: How the measure should be stratified, type: Expression, mustSupport: false, isSummary: false, index: 84}
          groupDefinition:
            isModifier: false
            short: A group resource that defines this population
            refers: ['http://hl7.org/fhir/StructureDefinition/Group']
            type: Reference
            mustSupport: false
            isSummary: false
            index: 85
          component:
            isModifier: false
            short: Stratifier criteria component for the measure
            type: BackboneElement
            mustSupport: false
            array: true
            isSummary: false
            index: 86
            elements:
              linkId:
                constraint:
                  mea-5: {human: Link ids should be 255 characters or less, source: 'http://hl7.org/fhir/StructureDefinition/Measure', severity: warning, expression: $this.length() <= 255}
                isModifier: false
                short: Unique id for stratifier component in measure
                type: string
                mustSupport: false
                isSummary: false
                index: 87
              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: 88
              description: {isModifier: false, short: The human readable description of this stratifier component, type: markdown, mustSupport: false, isSummary: false, index: 89}
              criteria: {isModifier: false, short: Component of how the measure should be stratified, type: Expression, mustSupport: false, isSummary: false, index: 90}
              groupDefinition:
                isModifier: false
                short: A group resource that defines this population
                refers: ['http://hl7.org/fhir/StructureDefinition/Group']
                type: Reference
                mustSupport: false
                isSummary: false
                index: 91
              valueSet: {isModifier: false, short: 'What stratum values?', type: canonical, mustSupport: false, isSummary: false, index: 92}
              unit: {isModifier: false, short: 'What units?', type: string, mustSupport: false, isSummary: false, index: 93}
      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: 59
      improvementNotationGuidance: {isModifier: false, short: Explanation of improvement notation, type: markdown, mustSupport: false, isSummary: true, index: 68}
      subjectCodeableConcept: {isModifier: false, short: 'E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device', type: CodeableConcept, mustSupport: false, meaningWhenMissing: 'Unfiltered context, i.e. population criteria are evaluated from the perspective of the entire system, rather than from the perspective of a particular subject.', choiceOf: subject, isSummary: false, index: 54}
      basis:
        isModifier: false
        short: Population basis
        type: code
        mustSupport: false
        meaningWhenMissing: boolean
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/fhir-types|6.0.0-ballot4'}
        isSummary: true
        index: 56
      type:
        isModifier: false
        short: process | outcome | structure | patient-reported-outcome
        type: CodeableConcept
        mustSupport: false
        array: true
        binding: {strength: extensible, valueSet: 'http://terminology.hl7.org/ValueSet/measure-type'}
        isSummary: true
        index: 51
      component:
        isModifier: false
        short: A component of a composite measure
        type: BackboneElement
        mustSupport: false
        array: true
        isSummary: false
        index: 62
        elements:
          measure: {isModifier: false, short: 'What measure?', type: canonical, mustSupport: false, isSummary: false, index: 63}
          groupId: {isModifier: false, short: 'What group?', type: string, mustSupport: false, isSummary: false, index: 64}
          weight: {isModifier: false, short: 'What weight?', type: decimal, mustSupport: false, isSummary: false, index: 65}
      title: {isModifier: false, short: Title of the group. This title is expected in the corresponding MeasureReport.group.title, type: string, mustSupport: false, isSummary: false, index: 48}
      library: {isModifier: false, short: Logic used by the measure group, type: canonical, mustSupport: false, array: true, isSummary: false, index: 69}
      scoringPrecision: {isModifier: false, short: How many decimals (The number of decimal places to include in the score when the score is a decimal-valued result), type: positiveInt, mustSupport: false, isSummary: true, index: 60}
      population:
        isModifier: false
        short: Population criteria
        type: BackboneElement
        mustSupport: false
        array: true
        isSummary: false
        index: 70
        elements:
          linkId:
            constraint:
              mea-3: {human: Link ids should be 255 characters or less, source: 'http://hl7.org/fhir/StructureDefinition/Measure', severity: warning, expression: $this.length() <= 255}
            isModifier: false
            short: Unique id for population in measure
            type: string
            mustSupport: false
            isSummary: false
            index: 71
          title: {isModifier: false, short: Title of the group's population. This title is expected in the corresponding MeasureReport.group.population.title, type: string, mustSupport: false, isSummary: false, index: 72}
          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://terminology.hl7.org/ValueSet/measure-population'}
            isSummary: false
            index: 73
          description: {isModifier: false, short: The human readable description of this population criteria, type: markdown, mustSupport: false, isSummary: false, index: 74}
          criteria: {isModifier: false, short: The criteria that defines this population, type: Expression, mustSupport: false, isSummary: false, index: 75}
          groupDefinition:
            isModifier: false
            short: A group resource that defines this population
            refers: ['http://hl7.org/fhir/StructureDefinition/Group']
            type: Reference
            mustSupport: false
            isSummary: false
            index: 76
          inputPopulationId: {isModifier: false, short: Which population, type: string, mustSupport: false, isSummary: false, index: 77}
          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://terminology.hl7.org/ValueSet/measure-aggregate-method'}
            isSummary: false
            index: 78
      basisRequirement:
        constraint:
          mea-7: {human: 'Basis requirements SHALL have a type, MAY have profile and codeFilter elements, and SHALL NOT specify dateFilter, valueFilter, limit, or sort', source: 'http://hl7.org/fhir/StructureDefinition/Measure', severity: error, expression: dateFilter.exists().not() and valueFilter.exists().not() and limit.exists().not() and sort.exists().not()}
        isModifier: false
        short: Population basis requirements
        type: DataRequirement
        mustSupport: false
        array: true
        isSummary: false
        index: 57
      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: 49
      scoring:
        isModifier: false
        short: proportion | ratio | continuous-variable | cohort | composite
        type: CodeableConcept
        mustSupport: false
        binding: {strength: extensible, valueSet: 'http://terminology.hl7.org/ValueSet/measure-scoring'}
        isSummary: true
        index: 58
      subjectReference:
        isModifier: false
        short: E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
        index: 55
        refers: ['http://hl7.org/fhir/StructureDefinition/Group']
        type: Reference
        mustSupport: false
        meaningWhenMissing: Unfiltered context, i.e. population criteria are evaluated from the perspective of the entire system, rather than from the perspective of a particular subject.
        choiceOf: subject
        isSummary: false
      improvementNotation:
        isModifier: false
        short: increase | decrease
        type: CodeableConcept
        mustSupport: false
        binding: {strength: extensible, valueSet: 'http://terminology.hl7.org/ValueSet/measure-improvement-notation'}
        isSummary: true
        index: 67
      subject:
        isModifier: false
        short: E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
        mustSupport: false
        choices: [subjectCodeableConcept, subjectReference]
        meaningWhenMissing: Unfiltered context, i.e. population criteria are evaluated from the perspective of the entire system, rather than from the perspective of a particular subject.
        isSummary: false
        index: 53
      rateAggregation: {isModifier: false, short: How is rate aggregation performed for this measure, type: markdown, mustSupport: false, isSummary: true, index: 66}
  endorser: {isModifier: false, short: Who endorsed the content, type: ContactDetail, mustSupport: false, array: true, isSummary: false, index: 34}
  publisher: {isModifier: false, short: Name of the publisher/steward (organization or individual), type: string, mustSupport: false, isSummary: true, index: 17}
  approvalDate: {isModifier: false, short: When the measure was approved by publisher, type: date, mustSupport: false, isSummary: false, index: 26}
  disclaimer: {isModifier: false, short: Disclaimer for use of the measure or its referenced content, type: markdown, mustSupport: false, isSummary: true, index: 37}
  jurisdiction:
    isModifier: false
    short: Jurisdiction of the authority that maintains the measure (if applicable)
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: extensible, valueSet: 'http://terminology.hl7.org/ValueSet/jurisdiction'}
    isSummary: true
    index: 21
  purpose: {isModifier: false, short: Why this measure is defined, type: markdown, mustSupport: false, isSummary: false, index: 22}
  subjectCodeableConcept: {isModifier: false, short: 'E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device', type: CodeableConcept, mustSupport: false, meaningWhenMissing: Patient, choiceOf: subject, isSummary: false, index: 14}
  name: {isModifier: false, short: Name for this measure (computer friendly), type: string, mustSupport: false, isSummary: true, index: 7}
  copyrightLabel: {isModifier: false, short: Copyright holder and year(s), type: string, mustSupport: false, isSummary: false, index: 25}
  useContext: {isModifier: false, short: The context that the content is intended to support, type: UsageContext, mustSupport: false, array: true, isSummary: true, index: 20}
  copyright: {isModifier: false, short: 'Notice about intellectual property ownership, can include restrictions on use', type: markdown, mustSupport: false, isSummary: false, index: 24}
  versionAlgorithm:
    isModifier: false
    short: How to compare versions
    mustSupport: false
    choices: [versionAlgorithmString, versionAlgorithmCoding]
    isSummary: true
    index: 4
  guidance: {isModifier: false, short: Additional guidance for implementers (deprecated), type: markdown, mustSupport: false, isSummary: true, index: 45}
  experimental: {isModifier: false, short: For testing only - never for real usage, type: boolean, mustSupport: false, meaningWhenMissing: 'If absent, this resource is treated as though it is not experimental.', isSummary: true, index: 11}
  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: 30
  title: {isModifier: false, short: Name for this measure (human friendly), type: string, mustSupport: false, isSummary: true, index: 8}
  supplementalData:
    isModifier: false
    short: What other data should be reported with the measure
    index: 94
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      linkId:
        constraint:
          mea-6: {human: Link ids should be 255 characters or less, source: 'http://hl7.org/fhir/StructureDefinition/Measure', severity: warning, expression: $this.length() <= 255}
        isModifier: false
        short: Unique id for supplementalData in measure
        type: string
        mustSupport: false
        isSummary: false
        index: 95
      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: 96
      usage:
        isModifier: false
        short: supplemental-data | risk-adjustment-factor
        type: CodeableConcept
        mustSupport: false
        array: true
        binding: {strength: extensible, valueSet: 'http://terminology.hl7.org/ValueSet/measure-data-usage'}
        isSummary: false
        index: 97
      description: {isModifier: false, short: The human readable description of this supplemental data, type: markdown, mustSupport: false, isSummary: false, index: 98}
      criteria: {isModifier: false, short: Expression describing additional data to be reported, type: Expression, mustSupport: false, isSummary: false, index: 99}
      valueSet: {isModifier: false, short: 'What supplemental data values?', type: canonical, mustSupport: false, isSummary: false, index: 100}
      unit: {isModifier: false, short: 'What units?', type: string, mustSupport: false, isSummary: false, index: 101}
    required: [criteria]
    isSummary: false
  library: {isModifier: false, short: Logic used by the measure, type: canonical, mustSupport: false, array: true, isSummary: false, index: 36}
  author: {isModifier: false, short: Who authored the content, type: ContactDetail, mustSupport: false, array: true, isSummary: false, index: 31}
  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}
  versionAlgorithmCoding: {isModifier: false, short: How to compare versions, type: Coding, mustSupport: false, choiceOf: versionAlgorithm, isSummary: true, index: 6}
  usage: {isModifier: false, short: Describes the clinical usage of the measure, type: markdown, mustSupport: false, isSummary: false, index: 23}
  rationale: {isModifier: false, short: 'Justification for the measure in terms of impact, gap in care, and evidence', type: markdown, mustSupport: false, isSummary: true, index: 40}
  status:
    isModifier: true
    short: draft | active | retired | unknown
    index: 10
    type: code
    mustSupport: false
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/publication-status|6.0.0-ballot4'}
    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: 9}
  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: 'exists() implies 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 by the publisher, type: date, mustSupport: false, isSummary: false, index: 27}
  editor: {isModifier: false, short: Who edited the content, type: ContactDetail, mustSupport: false, array: true, isSummary: false, index: 32}
  reportingFrequency:
    isModifier: false
    short: The frequency in which this measure should be reported (e.g. 1 '/a' - yearly, 4 '/a' - quarterly)
    type: Quantity
    mustSupport: false
    binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/frequency-unit'}
    isSummary: false
    index: 29
  riskAdjustment: {isModifier: false, short: How risk adjustment is applied for this measure, type: markdown, mustSupport: false, isSummary: true, index: 38}
  versionAlgorithmString: {isModifier: false, short: How to compare versions, type: string, mustSupport: false, choiceOf: versionAlgorithm, isSummary: true, index: 5}
  reviewer: {isModifier: false, short: Who reviewed the content, type: ContactDetail, mustSupport: false, array: true, isSummary: false, index: 33}
  version: {isModifier: false, short: Business version of the measure, type: string, mustSupport: false, isSummary: true, index: 2}
  relatedArtifact:
    constraint:
      mea-8: {human: Dependencies and components of a Measure should reference a resource, source: 'http://hl7.org/fhir/StructureDefinition/Measure', severity: warning, expression: type in ('depends-on' | 'composed-of' | 'part-of') implies ((resource.exists() xor resourceReference.exists()) or (artifact is canonical xor artifact is Reference))}
    isModifier: false
    short: Additional documentation, citations, etc
    type: RelatedArtifact
    mustSupport: false
    array: true
    isSummary: false
    index: 35
  contact: {isModifier: false, short: Contact details for the publisher, type: ContactDetail, mustSupport: false, array: true, isSummary: true, index: 18}
  subjectReference:
    isModifier: false
    short: E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
    index: 15
    refers: ['http://hl7.org/fhir/StructureDefinition/Group']
    type: Reference
    mustSupport: false
    meaningWhenMissing: Patient
    choiceOf: subject
    isSummary: false
  subject:
    isModifier: false
    short: E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
    mustSupport: false
    choices: [subjectCodeableConcept, subjectReference]
    meaningWhenMissing: Patient
    isSummary: false
    index: 13
  rateAggregation: {isModifier: false, short: How is rate aggregation performed for this measure, type: markdown, mustSupport: false, isSummary: true, index: 39}
  effectivePeriod: {isModifier: false, short: When the measure is expected to be used, type: Period, mustSupport: false, isSummary: true, index: 28}
  clinicalRecommendationStatement: {isModifier: false, short: Summary of clinical guidelines, type: markdown, mustSupport: false, isSummary: true, index: 41}
package_version: 6.0.0-ballot4
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Measure
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 6.0.0-ballot4
required: [status]