Quality Measure Implementation Guide
2.0.0-ballot - STU 2 Ballot

Quality Measure Implementation Guide - Downloaded Version null See the Directory of published versions

## Measure: Multi-Rate Example Measure (Experimental)

Official URL: http://hl7.org/fhir/uv/cqm/Measure/MultiRateExample-FHIR | Version: 0.1.0 | Highlight text changes?
Standards status: Informative Active as of 2025-08-13 | Computable Name: MultiRateExample
Other Identifiers: OID:2.16.840.1.113883.4.642.40.61.29.12
Usage: Clinical Venue: EC

This measure example illustrates the use of the group-level computation extensions to describe a multi-rate measure with mixed population bases

Metadata
Title | Multi-Rate Example Measure
Version | 0.1.0
Identifier | urn:oid:2.16.840.1.113883.4.642.40.61.29.12
Experimental | true
Subject Type | Location from http://hl7.org/fhir/resource-types
Use Context | Clinical Venue = EC
Jurisdiction | 001 from http://unstats.un.org/unsd/methods/m49/m49.htm
Steward (Publisher) | HL7 International / Clinical Quality Information
Description | This measure example illustrates the use of the group-level computation extensions to describe a multi-rate measure with mixed population bases
Measure Basis | Patient
Measure Group (Rate) (ID: Patients)
Basis | Patient
Scoring | continuous-variable from http://terminology.hl7.org/CodeSystem/measure-scoring
Improvement Notation | increase from http://terminology.hl7.org/CodeSystem/measure-improvement-notation
Type | structure from http://terminology.hl7.org/CodeSystem/measure-type
Risk Adjustment | N/A
Rate Aggregation | N/A
Initial Population | ID: primary-multirateexample-initial-population Description: Total number of patients Criteria: Patients
Measure Population | ID: primary-multirateexample-patients Description: Total number of patients Criteria: Patients
Measure Observation | ID: primary-multirateexample-tonumber Description: Total number of patients Criteria: ToNumber AggregateMethod: sum
Measure Group (Rate) (ID: Practitioners)
Basis | PractitionerRole
Scoring | continuous-variable from http://terminology.hl7.org/CodeSystem/measure-scoring
Improvement Notation | increase from http://terminology.hl7.org/CodeSystem/measure-improvement-notation
Type | structure from http://terminology.hl7.org/CodeSystem/measure-type
Risk Adjustment | N/A
Rate Aggregation | N/A
Initial Population | ID: primary-multirateexample-initial-population Description: Total number of practitioners Criteria: Practitioners
Measure Population | ID: primary-multirateexample-measure-population Description: Total number of practitioners Criteria: Practitioners
Measure Observation | ID: primary-multirateexample-measure-observation Description: Total number of practitioners Criteria: ToNumber AggregateMethod: sum
Measure Group (Rate) (ID: Beds)
Basis | Device
Scoring | continuous-variable from http://terminology.hl7.org/CodeSystem/measure-scoring
Improvement Notation | increase from http://terminology.hl7.org/CodeSystem/measure-improvement-notation
Type | structure from http://terminology.hl7.org/CodeSystem/measure-type
Risk Adjustment | N/A
Rate Aggregation | N/A
Initial Population | ID: primary-multirateexample-beds-initial-population Description: Total number of beds Criteria: Beds
Measure Population | ID: primary-multirateexample-beds-measure-population Description: Total number of beds Criteria: Beds
Measure Observation | ID: primary-multirateexample-beds-measure-observation-population Description: Total number of beds Criteria: ToNumber AggregateMethod: sum
Measure Group (Rate) (ID: Screening-procedures)
Basis | Procedure
Scoring | continuous-variable from http://terminology.hl7.org/CodeSystem/measure-scoring
Improvement Notation | increase from http://terminology.hl7.org/CodeSystem/measure-improvement-notation
Type | structure from http://terminology.hl7.org/CodeSystem/measure-type
Risk Adjustment | N/A
Rate Aggregation | N/A
Initial Population | ID: primary-multirateexample-procedures-initial-population Description: Total number of screening procedures Criteria: Screening Procedures
Measure Population | ID: primary-multirateexample-procedures-measure-population Description: Total number of screening procedures Criteria: Screening Procedures
Measure Observation | ID: primary-multirateexample-procedures-measure-observation-population Description: Total number of screening procedures Criteria: ToNumber AggregateMethod: sum
Measure Group (Rate) (ID: patient-screenings)
Basis | Patient
Scoring | proportion from http://terminology.hl7.org/CodeSystem/measure-scoring
Improvement Notation | increase from http://terminology.hl7.org/CodeSystem/measure-improvement-notation
Type | process from http://terminology.hl7.org/CodeSystem/measure-type
Risk Adjustment | N/A
Rate Aggregation | N/A
Initial Population | ID: primary-multirateexample-patients-initial-population Description: Patients Criteria: Initial Population
Denominator | ID: primary-multirateexample-patients-denominator Description: Eligible patients Criteria: Denominator
Numerator | ID: primary-multirateexample-patients-numerator Description: Patients with screening Criteria: Numerator
Measure Group (Rate) (ID: weighted-average-capacity)
Scoring | composite from http://terminology.hl7.org/CodeSystem/measure-scoring
Improvement Notation | increase from http://terminology.hl7.org/CodeSystem/measure-improvement-notation
Composite Scoring | weighted from http://terminology.hl7.org/CodeSystem/composite-measure-scoring
Component | Resource: Multi-Rate Example Measure Canonical URL: `http://hl7.org/fhir/uv/cqm/Measure/MultiRateExample-FHIR`
Component | Resource: Multi-Rate Example Measure Canonical URL: `http://hl7.org/fhir/uv/cqm/Measure/MultiRateExample-FHIR`
Component | Resource: Multi-Rate Example Measure Canonical URL: `http://hl7.org/fhir/uv/cqm/Measure/MultiRateExample-FHIR`
Component | Resource: Multi-Rate Example Measure Canonical URL: `http://hl7.org/fhir/uv/cqm/Measure/MultiRateExample-FHIR`
Type | structure from http://terminology.hl7.org/CodeSystem/measure-type
Risk Adjustment | N/A
Rate Aggregation | N/A
Measure Logic
Primary Library | Multi Rate Example Logic Library
Contents | Population Criteria Logic Definitions Terminology Dependencies Data Requirements Parameters
Population Criteria
Measure Group (Rate) (ID: Patients)
Initial Population
    // Number of patients
    define "Patients":
      [Patient]
Definition
Measure Population
    // Number of patients
    define "Patients":
      [Patient]
Definition
Measure Observation
    define function ToNumber(patient Patient):
      if patient is not null then 1 else 0
Definition
Measure Observation
    define function ToNumber(practitionerRole PractitionerRole):
      if practitionerRole is not null then 1 else 0
Definition
Measure Observation
    define function ToNumber(device Device):
      if device is not null then 1 else 0
Definition
Measure Group (Rate) (ID: Practitioners)
Initial Population
    // Number of practitioners
    define "Practitioners":
      [PractitionerRole]
Definition
Measure Population
    // Number of practitioners
    define "Practitioners":
      [PractitionerRole]
Definition
Measure Observation
    define function ToNumber(patient Patient):
      if patient is not null then 1 else 0
Definition
Measure Observation
    define function ToNumber(practitionerRole PractitionerRole):
      if practitionerRole is not null then 1 else 0
Definition
Measure Observation
    define function ToNumber(device Device):
      if device is not null then 1 else 0
Definition
Measure Group (Rate) (ID: Beds)
Initial Population
    // Number of beds
    define "Beds":
      [Device: "Bed Device Types"]
Definition
Measure Population
    // Number of beds
    define "Beds":
      [Device: "Bed Device Types"]
Definition
Measure Observation
    define function ToNumber(patient Patient):
      if patient is not null then 1 else 0
Definition
Measure Observation
    define function ToNumber(practitionerRole PractitionerRole):
      if practitionerRole is not null then 1 else 0
Definition
Measure Observation
    define function ToNumber(device Device):
      if device is not null then 1 else 0
Definition
Measure Group (Rate) (ID: Screening-procedures)
Initial Population
    // Number of screening procedures
    define "Screening Procedures":
      [Procedure: "Screening Procedure Types"]
Definition
Measure Population
    // Number of screening procedures
    define "Screening Procedures":
      [Procedure: "Screening Procedure Types"]
Definition
Measure Observation
    define function ToNumber(patient Patient):
      if patient is not null then 1 else 0
Definition
Measure Observation
    define function ToNumber(practitionerRole PractitionerRole):
      if practitionerRole is not null then 1 else 0
Definition
Measure Observation
    define function ToNumber(device Device):
      if device is not null then 1 else 0
Definition
Measure Group (Rate) (ID: patient-screenings)
Initial Population
    // Percentage of patients who received screening
    define "Initial Population":
      "Patients"
Definition
Denominator
    define "Denominator":
      "Patients" P
        where P.gender = 'female'
Definition
Numerator
    define "Numerator":
      "Patients" P
        with "Screening Procedures" SP
          such that P.id = Last(Split(SP.subject.reference, '/'))
Definition
Measure Group (Rate) (ID: weighted-average-capacity)
Logic Definitions
Logic Definition | Library Name: MultiRateExample
    // Number of practitioners
    define "Practitioners":
      [PractitionerRole]
Logic Definition | Library Name: MultiRateExample
    // Number of patients
    define "Patients":
      [Patient]
Logic Definition | Library Name: MultiRateExample
    // Number of screening procedures
    define "Screening Procedures":
      [Procedure: "Screening Procedure Types"]
Logic Definition | Library Name: MultiRateExample
    define "Numerator":
      "Patients" P
        with "Screening Procedures" SP
          such that P.id = Last(Split(SP.subject.reference, '/'))
Logic Definition | Library Name: MultiRateExample
    define "Denominator":
      "Patients" P
        where P.gender = 'female'
Logic Definition | Library Name: MultiRateExample
    // Percentage of patients who received screening
    define "Initial Population":
      "Patients"
Logic Definition | Library Name: MultiRateExample
    // Number of beds
    define "Beds":
      [Device: "Bed Device Types"]
Logic Definition | Library Name: MultiRateExample
    define function ToNumber(patient Patient):
      if patient is not null then 1 else 0
Logic Definition | Library Name: MultiRateExample
    define function ToNumber(practitionerRole PractitionerRole):
      if practitionerRole is not null then 1 else 0
Logic Definition | Library Name: MultiRateExample
    define function ToNumber(device Device):
      if device is not null then 1 else 0
Logic Definition | Library Name: FHIRHelpers
    define function ToString(value string): value.value
Logic Definition | Library Name: FHIRHelpers
    define function ToString(value AdministrativeGender): value.value
Terminology
Value Set | Description: Value set Screening Procedure Types Resource: `http://example.org/fhir/ValueSet/TBD` Canonical URL: `http://example.org/fhir/ValueSet/TBD`
Dependencies
Dependency | Description: FHIR model information Resource: http://hl7.org/fhir/uv/cql/Library/FHIR-ModelInfo|4.0.1 Canonical URL: `http://hl7.org/fhir/uv/cql/Library/FHIR-ModelInfo|4.0.1`
Dependency | Description: Library FHIRHelpers Resource: http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1 Canonical URL: `http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1`
Data Requirements
Data Requirement | Type: PractitionerRole Profile(s): PractitionerRole
Data Requirement | Type: Patient Profile(s): Patient Must Support Elements: id, gender
Data Requirement | Type: Procedure Profile(s): Procedure Must Support Elements: code, subject, subject.reference Code Filter(s): Path: code ValueSet: `http://example.org/fhir/ValueSet/TBD`
Data Requirement | Type: Device Profile(s): Device Must Support Elements: type Code Filter(s): Path: type ValueSet: `http://example.org/fhir/ValueSet/TBD`
Parameters
Name | Use | Card. | Type | Documentation
Practitioners | Out | 0..* | PractitionerRole |
Numerator | Out | 0..* | Patient |
Screening Procedures | Out | 0..* | Procedure |
Denominator | Out | 0..* | Patient |
Initial Population | Out | 0..* | Patient |
Patients | Out | 0..* | Patient |
Beds | Out | 0..* | Device |
Generated using version 0.5.4 of the sample-content-ig Liquid templates