Quality Measure Implementation Guide
2.0.0-ballot - STU 2 Ballot International flag

Quality Measure Implementation Guide, published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 2.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-cqm/ and changes regularly. 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
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