Your User Friendly Name for MyContentIG Here
0.5.1-cibuild - CI Build International flag

Your User Friendly Name for MyContentIG Here, published by HL7 International - [Some] Work Group. This guide is not an authorized publication; it is the continuous build for version 0.5.1-cibuild built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/cqframework/sample-content-ig/ and changes regularly. See the Directory of published versions

Measure: HR Example Ratio (Measure Name in Details Tab of MADiE UI) (Experimental)

Official URL: http://somewhere.org/fhir/uv/mycontentig/Measure/HRExampleRatioMeasure Version: 0.5.1-cibuild
Draft as of 2025-08-28 Computable Name: HRExampleRatioMeasure
Other Identifiers: Short Name: HRExRati(eCQM Abbreviated Title) (use: usual, ), UUID:740197c5-a162-4947-ba39-e8f96c0e05fb (use: official, ), UUID:7d7408c9-e203-4c34-bde5-39ef0558cb38 (use: official, ), Endorser: 2EndorsementNumber (use: official, )

Usage:Venue: EH

Copyright/Legal: Copyright Section of Details Tab in MADiE UI

  • Free text.

  • Character limit not determined.

Displays “UNKNOWN” if not populated.

QDM Equivalent: Copyright

Description Section of Details Tab in MADiE UI

  • Free text.

  • Character limit not determined.

QDM equivalent: Description

Purpose Section of Details Tab in MADiE UI

  • Free text.

  • Character limit not determined.

Conditional field, will not display if not populated.

QDM Equivalent: N/A

Metadata
Title HR Example Ratio (Measure Name in Details Tab of MADiE UI)
Version 0.5.1-cibuild
Short Name HRExRati(eCQM Abbreviated Title)
GUID (Version Independent) urn:uuid:740197c5-a162-4947-ba39-e8f96c0e05fb
GUID (Version Specific) urn:uuid:7d7408c9-e203-4c34-bde5-39ef0558cb38
CMS Consensus Based Entity Identifier 2EndorsementNumber
Effective Period 2026-01-01 through 2026-12-31
Status Draft
Experimental true
Use Context Venue = EH
Jurisdiction 001 from http://unstats.un.org/unsd/methods/m49/m49.htm
Steward (Publisher) HL7 International - [Some] Work Group
Developer ESAC, Inc.
Developer ICF
Description

Description Section of Details Tab in MADiE UI

  • Free text.

  • Character limit not determined.

QDM equivalent: Description

Purpose

Purpose Section of Details Tab in MADiE UI

  • Free text.

  • Character limit not determined.

Conditional field, will not display if not populated.

QDM Equivalent: N/A

Copyright

Copyright Section of Details Tab in MADiE UI

  • Free text.

  • Character limit not determined.

Displays "UNKNOWN" if not populated.

QDM Equivalent: Copyright

Disclaimer

Disclaimer Section of Details Tab in MADiE UI

  • Free text.

  • Character limit not determined.

Displays "UNKNOWN" if not populated.

QDM Equivalent: Disclaimer

Rationale

Rationale Section of Details Tab in MADiE UI

  • Free text.

  • Character limit not determined.

Conditional field, will not display if not populated.

QDM Equivalent: Rationale

Clinical Recommendation Statement

Clinical Recommendation Section of Details Tab in MADiE UI

  • Free text.

  • Character limit not determined.

Conditional field, will not display if not populated.

QDM Equivalent: Clinical Recommendation Statement

Citation

CITATION References Section of Details Tab in MADiE UI

  • Type" selected from drop down (Citation or Justification)

  • Reference" free text after selection.

  • Character limit not determined.

Conditional field, will not display if not populated.

QDM Equivalent: Reference

Justification Description: **JUSTIFICATION References Section of Details Tab in MADiE UI** * "Type" selected from drop down (Citation or Justification) * "Reference" free text after selection. * Character limit not determined. *Conditional field, will not display if not populated.* **QDM Equivalent: Reference**
Definition Definition Section of Details Tab in MADiE UI "Term" free text. Character limit not determined. QDM Equivalent: ?.: **Definition Section of Details Tab in MADiE UI** * "Definition" free text. * Character limit not determined *Conditional field, will not display if not populated.* **QDM Equivalent: Definition**
Guidance (Usage) **Guidance (Usage) Section of Details Tab in MADiE UI** * Free text. * Character limit not determined. *Conditional field, will not display if not populated.* **QDM Equivalent: Guidance**
Measure Group (Rate) (ID: Group_1)
Summary **Population Criteria 1 Description on Population Criteria Tab of MADiE UI** * Free text. * Character limit not determined. **QDM Equivalent: N/A** **Populates Summary Field in FHIR human readable** | Additional MADiE Page Notes: | |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | * Measure type selectable from drop down, multi select; for this example selected all options. | | * Population Basis selectable from drop down, single select; for this example, boolean is only one that didn't generate an error. | | * Scoring selectable from dropdown, single select (Cohort, Continuous Variable, Proportion and Ratio). *Note to self, changing scoring deletes all population information.* | | * Aggregate Function selectable from dropdown. | | * Scoring Unit free text entry. | | * Scoring Precision selectable integers. |
Basis boolean
Scoring Ratio
Scoring Unit Scoring Unit Field
Scoring Precision 1
Improvement Notation Increased score indicates improvement
Improvement Notation Guidance

Improvement Notation Description Field of Reporting Section on Population Criteria Tab of MADiE UI

  • Free text.

  • Character limit not determined.

  • Improvement Notation required field selected by dropdown (Increased score indicates improvement and Decreased score indicates improvement).

QDM Equivalent: Improvement Notation

Type Intermediate Outcome
Type Outcome
Type Patient Reported Outcome
Type Process
Type Structure
Initial Population ID: InitialPopulation_1_1
Description:

**Initial Population Description Field in Population Criteria Tab of MADiE UI** * Free text. * Character limit not determined. * Initial Population required field selected by dropdown (Defines from CQL Editor Tab). **QDM Equivalent: Initial Population**

Criteria: Initial Population
Initial Population ID: InitialPopulation_1_2
Description:

**Initial Population 2 Description Field in Population Criteria Tab of MADiE UI** * Free text. * Character limit not determined. * Initial Population required field selected by dropdown (Defines from CQL Editor Tab). **QDM Equivalent: Initial Population**

Criteria: Initial Population2
Denominator ID: Denominator_1
Description:

**Denominator Description Field in Population Criteria Tab of MADiE UI** * Free text. * Character limit not determined. * Denominator required field selected by dropdown (Defines from CQL Editor Tab). **QDM Equivalent: Denominator**

Criteria: Denominator
Input Population: InitialPopulation_1_1
Denominator Exclusion ID: DenominatorExclusion_1
Description:

**Denominator Exclusion Description Field in Population Criteria Tab of MADiE UI** * Free text. * Character limit not determined. * Denominator Exclusion is not required field selected by dropdown (Defines from CQL Editor Tab). *Conditional field, will not display if not populated.* **QDM Equivalent: Denominator Exclusion**

Criteria: Denominator Exclusions
Numerator ID: Numerator_1
Description:

**Numerator Description Field in Population Criteria Tab of MADiE UI** * Free text. * Character limit not determined. * Numerator required field selected by dropdown (Defines from CQL Editor Tab). **QDM Equivalent: Numerator**

Criteria: Numerator
Input Population: InitialPopulation_1_2
Stratifier ID: Stratification_1_1
Description: **Stratification 1 Description in Stratifications Section of Population Criteria Tab of MADiE UI** * Free Text. * Character limit not determined. Stratification 1 required field selected by dropdown (Defines from CQL Editor tab). Association 1 appears to default to all defined populations. *Conditional field, does not show if not populated.* **QDM Equivalent: Stratification**
Stratifier ID: Stratification_1_2
Description: **Stratification 2 Description in Stratifications Section of Population Criteria Tab of MADiE UI** * Free Text. * Character limit not determined. Stratification 2 required field selected by dropdown (Defines from CQL Editor tab). Association 2 appears to default to all defined populations. *Conditional field, does not show if not populated.* **QDM Equivalent: Stratification**
Supplemental Data Guidance Guidance <p><strong>Supplemental Data Section of Population Criteria Tab of MADiE UI </strong></p> <ul> <li><p>Free text.</p></li> <li><p>Character limit not determined.</p></li> <li><p>Definition selected from dropdown (Defines in CQL Editor).</p></li> <li><p>For this example, selected SDE Payer, SDE Ethnicity, SDE Race and SDE Sex.</p></li> <li><p>Appears to default to Individual, Subject List, Summary and Data Collection for Include in Report Type.</p></li> </ul> <p><em>Conditional field, will not display if not populated. </em></p> <p><strong>QDM Equivalent: Supplemental Data Elements</strong></p> <p><strong>Populates Supplemental Data Guidance in FHIR human readable</strong></p>
Risk Adjustment Variable Guidance Guidance <p><strong>Risk Adjustment Section of Population Criteria Tab of MADiE UI </strong></p> <ul> <li><p>Free text.</p></li> <li><p>Character limit not determined.</p></li> <li><p>Definition selected from dropdown, multi select (Defines in CQL Editor).</p></li> <li><p>Appears to default to Individual, Subject List, Summary and Data Collection for Include in Report Type.</p></li> </ul> <p><em>Conditional field, will not display if not populated.</em></p> <p><strong>QDM Equivalent: Risk Adjustment</strong></p>
Supplemental Data Elements
Supplemental Data Element ID: sde-ethnicity
Usage Code: Supplemental Data
Description: SDE Ethnicity
Logic Definition: SDE Ethnicity
Supplemental Data Element ID: sde-payer
Usage Code: Supplemental Data
Description: SDE Payer
Logic Definition: SDE Payer
Supplemental Data Element ID: sde-race
Usage Code: Supplemental Data
Description: SDE Race
Logic Definition: SDE Race
Supplemental Data Element ID: sde-sex
Usage Code: Supplemental Data
Description: SDE Sex
Logic Definition: SDE Sex
Supplemental Data Element ID: rav-patient-too-young-at-start-of-measurement-period
Usage Code: Risk Adjustment Factor
Description: RAV Patient Too Young at Start of Measurement Period
Logic Definition: RAV Patient Too Young at Start of Measurement Period
Supplemental Data Element ID: rav-patient-too-old-at-start-of-measurement-period
Usage Code: Risk Adjustment Factor
Description: RAV Patient Too Old at Start of Measurement Period
Logic Definition: RAV Patient Too Old at Start of Measurement Period
Measure Logic
Primary Library https://madie.cms.gov/Library/HRExampleRatioMeasureCQLLibrary
Contents Population Criteria
Logic Definitions
Terminology
Dependencies
Data Requirements
Population Criteria
Measure Group (Rate) (ID: Group_1)
Initial Population
define "Initial Population":
  AgeInYearsAt(date from 
    end of "Measurement Period"
  ) in Interval[18, 75]
Definition
Initial Population
define "Initial Population2":
  AgeInYearsAt(date from 
    end of "Measurement Period"
  ) in Interval[19, 76]
Definition
Denominator
define "Denominator":
  "Initial Population"
Definition
Denominator Exclusion
define "Denominator Exclusions":
  "Initial Population"
Definition
Numerator
define "Numerator":
  "Initial Population"
Definition
Stratifier
define "Patient Age Less than 18 Years Start of Measurement Period":
  AgeInYearsAt(date from start of "Measurement Period") < 18
Definition
Stratifier
define "Patient Age 18 Years or Older at Start of Measurement Period":
  AgeInYearsAt(date from start of "Measurement Period") >= 18
Definition
Logic Definitions
Logic Definition Library Name: SupplementalDataElements
define "SDE Race":
  Patient.race R
    return Tuple {
      codes: R.ombCategory union R.detailed,
      display: R.text
    }
Logic Definition Library Name: SupplementalDataElements
define "SDE Sex":
  case
    when Patient.sex = '184115007' then "Patient sex unknown"
    when Patient.sex = '248152002' then "Female"
    when Patient.sex = '248153007' then "Male"
    when Patient.sex = 'asked-declined' then "Asked But Declined"
    when Patient.gender = 'male' then "M"
    when Patient.gender = 'female' then "F"
    else null
  end
Logic Definition Library Name: SupplementalDataElements
define "SDE Payer":
  [Coverage: type in "Payer Type"] Payer
    return {
      code: Payer.type,
      period: Payer.period
    }
Logic Definition Library Name: SupplementalDataElements
define "SDE Ethnicity":
  Patient.ethnicity E
    return Tuple {
      codes: { E.ombCategory } union E.detailed,
      display: E.text
    }
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "RAV Patient Too Old at Start of Measurement Period":
  AgeInYearsAt(date from start of "Measurement Period") > 80
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "RAV Patient Too Young at Start of Measurement Period":
  AgeInYearsAt(date from start of "Measurement Period") < 5
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "SDE Race":
  SDE."SDE Race"
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "SDE Sex":
  SDE."SDE Sex"
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "Initial Population":
  AgeInYearsAt(date from 
    end of "Measurement Period"
  ) in Interval[18, 75]
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "Numerator":
  "Initial Population"
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "Patient Age Less than 18 Years Start of Measurement Period":
  AgeInYearsAt(date from start of "Measurement Period") < 18
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "Denominator":
  "Initial Population"
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "SDE Payer":
  SDE."SDE Payer"
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "SDE Ethnicity":
  SDE."SDE Ethnicity"
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "Denominator Exclusions":
  "Initial Population"
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "Patient Age 18 Years or Older at Start of Measurement Period":
  AgeInYearsAt(date from start of "Measurement Period") >= 18
Logic Definition Library Name: HRExampleRatioMeasureCQLLibrary
define "Initial Population2":
  AgeInYearsAt(date from 
    end of "Measurement Period"
  ) in Interval[19, 76]
Logic Definition Library Name: FHIRHelpers
define function ToString(value uri): value.value
Logic Definition Library Name: FHIRHelpers
/*
@description: Converts the given FHIR [Coding](https://hl7.org/fhir/datatypes.html#Coding) value to a CQL Code.
*/
define function ToCode(coding FHIR.Coding):
    if coding is null then
        null
    else
        System.Code {
          code: coding.code.value,
          system: coding.system.value,
          version: coding.version.value,
          display: coding.display.value
        }
Logic Definition Library Name: FHIRHelpers
/*
@description: Converts the given [Period](https://hl7.org/fhir/datatypes.html#Period)
value to a CQL DateTime Interval
@comment: If the start value of the given period is unspecified, the starting
boundary of the resulting interval will be open (meaning the start of the interval
is unknown, as opposed to interpreted as the beginning of time).
*/
define function ToInterval(period FHIR.Period):
    if period is null then
        null
    else
        if period."start" is null then
            Interval(period."start".value, period."end".value]
        else
            Interval[period."start".value, period."end".value]
Terminology
Code System Description: Code system SNOMEDCT
Resource: SNOMED CT (all versions)
Canonical URL: http://snomed.info/sct
Code System Description: Code system DataAbsentReason
Resource: DataAbsentReason
Canonical URL: http://terminology.hl7.org/CodeSystem/data-absent-reason
Code System Description: Code system AdministrativeGender
Resource: AdministrativeGender
Canonical URL: http://terminology.hl7.org/CodeSystem/v3-AdministrativeGender
Value Set Description: Value set Payer Type
Resource: Payer
Canonical URL: http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.3591
Direct Reference Code Display: Patient sex unknown (finding)
Code: 184115007
System: http://snomed.info/sct
Direct Reference Code Display: Female (finding)
Code: 248152002
System: http://snomed.info/sct
Direct Reference Code Display: Male (finding)
Code: 248153007
System: http://snomed.info/sct
Direct Reference Code Code: asked-declined
System: http://terminology.hl7.org/CodeSystem/data-absent-reason
Direct Reference Code Display: Male
Code: M
System: http://terminology.hl7.org/CodeSystem/v3-AdministrativeGender
Direct Reference Code Display: Female
Code: F
System: http://terminology.hl7.org/CodeSystem/v3-AdministrativeGender
Dependencies
Dependency None
Data Requirements
Data Requirement Type: Patient
Profile(s): QICore Patient
Must Support Elements: url, extension, gender, gender.value
Data Requirement Type: Coverage
Profile(s): QICore Coverage
Must Support Elements: type, period
Code Filter(s):
Path: type
ValueSet: Payer
Generated using version 0.5.1-cibuild of the sample-content-ig Liquid templates