FHIRsmith: Measure/Measure-StratificationPatientExample.json

FHIR © HL7.org |

FHIRsmith 4.0.1 | Server Home | XIG Home | XIG Stats |

FHIR IG analytics

Package	cms.madie
Resource Type	Measure
Id	Measure-StratificationPatientExample.json
FHIR Version	R4
Source	https://build.fhir.org/ig/cqframework/dqm-content-qicore-2026/Measure-StratificationPatientExample.html
URL	https://madie.cms.gov/Measure/StratificationPatientExample
Version	2026.0.0
Status	draft
Date	2026-04-06T15:48:46+00:00

Resources that use this resource

No resources found

Resources that this resource uses

No resources found

Narrative

Note: links and images are rebased to the (stated) source

Metadata
Version	2026.0.0
Status	Draft
Measure Scoring	proportion from http://hl7.org/fhir/measure-scoring
Measure Group (Rate) (ID: group-1)
Basis	boolean
Initial Population	ID: initial-population Description: No description provided Criteria: Initial Population
Denominator	ID: denominator Description: No description provided Criteria: Denominator
Numerator	ID: numerator Description: No description provided Criteria: Numerator
Stratifier	Code: Criteria-based Age Range Stratifier, 0 to 20 years
Stratifier	Code: Criteria-based Age Range Stratifier, 21 to 40 years
Stratifier	Code: Criteria-based Age Range Stratifier, 41+ years
Stratifier	Code: Value-based Gender and Age Range Stratifier
Measure Logic
Primary Library	Stratification Patient Example
Contents	Population Criteria Logic Definitions Terminology Dependencies Data Requirements
Population Criteria
Measure Group (Rate) (ID: group-1)
Initial Population
Initial Population	`define "Initial Population": true` Definition
Denominator
Denominator	`define "Denominator": Patient.active is true` Definition
Numerator
Numerator	`define "Numerator": exists ("Well-Visit Encounter")` Definition
Stratifier
Stratifier	`/* Criteria-based Stratifiers / define "Stratifier P0Y--P21Y": Patient.ageInYearsAt(end of "Measurement Period") between 0 and 20` Definition*
Stratifier
Stratifier	`define "Stratifier P21Y--P41Y": Patient.ageInYearsAt(end of "Measurement Period") between 21 and 40` Definition
Stratifier
Stratifier	`define "Stratifier P41Y--P9999Y": Patient.ageInYearsAt(end of "Measurement Period") >= 41` Definition
Logic Definitions
Logic Definition	Library Name: StratificationPatientExample
Logic Definition	`define "Well-Visit Encounter": [Encounter] E where E.status = 'finished' and E.period ends during day of "Measurement Period"`
Logic Definition	Library Name: StratificationPatientExample
Logic Definition	`define "Numerator": exists ("Well-Visit Encounter")`
Logic Definition	Library Name: StratificationPatientExample
Logic Definition	`define "Stratifier P21Y--P41Y": Patient.ageInYearsAt(end of "Measurement Period") between 21 and 40`
Logic Definition	Library Name: StratificationPatientExample
Logic Definition	`define "Denominator": Patient.active is true`
Logic Definition	Library Name: StratificationPatientExample
Logic Definition	`/* Criteria-based Stratifiers */ define "Stratifier P0Y--P21Y": Patient.ageInYearsAt(end of "Measurement Period") between 0 and 20`
Logic Definition	Library Name: StratificationPatientExample
Logic Definition	`define "Initial Population": true`
Logic Definition	Library Name: StratificationPatientExample
Logic Definition	`define "Stratifier P41Y--P9999Y": Patient.ageInYearsAt(end of "Measurement Period") >= 41`
Logic Definition	Library Name: PatientCommon
Logic Definition	/* @description: Returns the age in years of the patient, as of the given date @comment: This function returns the number of whole calendar years between the patient birth date and the given date. Regardless of whether the patient has a birthTime, the calculation is performed using only the birth date. If the given date has a time component, it is ignored, on the grounds that birth time is almost universally not considered when determining age in years. */ define fluent function ageInYearsAt(patient Patient, asOf DateTime): CalculateAgeInYearsAt(Patient.birthDate, date from asOf)
Logic Definition	Library Name: FHIRHelpers
Logic Definition	`define function ToString(value EncounterStatus): value.value`
Logic Definition	Library Name: FHIRHelpers
Logic Definition	/* @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]
Logic Definition	Library Name: FHIRHelpers
Logic Definition	`define function ToDate(value date): value.value`
Logic Definition	Library Name: FHIRHelpers
Logic Definition	`define function ToBoolean(value boolean): value.value`
Terminology
Terminology	None
Dependencies
Dependency	None
Data Requirements
Data Requirement	Type: Encounter Profile(s): Encounter Must Support Elements: status, period
Data Requirement	Type: Patient Profile(s): Patient
Generated using version 0.5.0 of the sample-content-ig Liquid templates

Source1

{
  "resourceType": "Measure",
  "id": "StratificationPatientExample",
  "text": {
    "status": "extensions",
    "div": "<!-- snip (see above) -->"
  },
  "contained": [
    {
      "resourceType": "Library",
      "id": "effective-data-requirements",
      "extension": [
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "StratificationPatientExample"
            },
            {
              "url": "name",
              "valueString": "Well-Visit Encounter"
            },
            {
              "url": "statement",
              "valueString": "define \"Well-Visit Encounter\":\n  [Encounter] E\n    where E.status = 'finished'\n      and E.period ends during day of \"Measurement Period\""
            },
            {
              "url": "displaySequence",
              "valueInteger": 0
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "StratificationPatientExample"
            },
            {
              "url": "name",
              "valueString": "Numerator"
            },
            {
              "url": "statement",
              "valueString": "define \"Numerator\":\n  exists (\"Well-Visit Encounter\")"
            },
            {
              "url": "displaySequence",
              "valueInteger": 1
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "StratificationPatientExample"
            },
            {
              "url": "name",
              "valueString": "Stratifier P21Y--P41Y"
            },
            {
              "url": "statement",
              "valueString": "define \"Stratifier P21Y--P41Y\":\n  Patient.ageInYearsAt(end of \"Measurement Period\") between 21 and 40"
            },
            {
              "url": "displaySequence",
              "valueInteger": 2
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "StratificationPatientExample"
            },
            {
              "url": "name",
              "valueString": "Denominator"
            },
            {
              "url": "statement",
              "valueString": "define \"Denominator\":\n  Patient.active is true"
            },
            {
              "url": "displaySequence",
              "valueInteger": 3
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "StratificationPatientExample"
            },
            {
              "url": "name",
              "valueString": "Stratifier P0Y--P21Y"
            },
            {
              "url": "statement",
              "valueString": "/* Criteria-based Stratifiers */\n\ndefine \"Stratifier P0Y--P21Y\":\n  Patient.ageInYearsAt(end of \"Measurement Period\") between 0 and 20"
            },
            {
              "url": "displaySequence",
              "valueInteger": 4
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "StratificationPatientExample"
            },
            {
              "url": "name",
              "valueString": "Initial Population"
            },
            {
              "url": "statement",
              "valueString": "define \"Initial Population\":\n  true"
            },
            {
              "url": "displaySequence",
              "valueInteger": 5
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "StratificationPatientExample"
            },
            {
              "url": "name",
              "valueString": "Stratifier P41Y--P9999Y"
            },
            {
              "url": "statement",
              "valueString": "define \"Stratifier P41Y--P9999Y\":\n  Patient.ageInYearsAt(end of \"Measurement Period\") >= 41"
            },
            {
              "url": "displaySequence",
              "valueInteger": 6
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "FHIRHelpers"
            },
            {
              "url": "name",
              "valueString": "ToString"
            },
            {
              "url": "statement",
              "valueString": "define function ToString(value EncounterStatus): value.value"
            },
            {
              "url": "displaySequence",
              "valueInteger": 7
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "FHIRHelpers"
            },
            {
              "url": "name",
              "valueString": "ToInterval"
            },
            {
              "url": "statement",
              "valueString": "/*\n@description: Converts the given [Period](https://hl7.org/fhir/datatypes.html#Period)\nvalue to a CQL DateTime Interval\n@comment: If the start value of the given period is unspecified, the starting\nboundary of the resulting interval will be open (meaning the start of the interval\nis unknown, as opposed to interpreted as the beginning of time).\n*/\ndefine function ToInterval(period FHIR.Period):\n    if period is null then\n        null\n    else\n        if period.\"start\" is null then\n            Interval(period.\"start\".value, period.\"end\".value]\n        else\n            Interval[period.\"start\".value, period.\"end\".value]"
            },
            {
              "url": "displaySequence",
              "valueInteger": 8
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "PatientCommon"
            },
            {
              "url": "name",
              "valueString": "ageInYearsAt"
            },
            {
              "url": "statement",
              "valueString": "/*\n@description: Returns the age in years of the patient, as of the given date\n@comment: This function returns the number of whole calendar years between the patient birth \ndate and the given date. Regardless of whether the patient has a birthTime, the calculation is\nperformed using only the birth date. If the given date has a time component, it is ignored, on \nthe grounds that birth time is almost universally not considered when determining age in years.\n*/\ndefine fluent function ageInYearsAt(patient Patient, asOf DateTime):\n  CalculateAgeInYearsAt(Patient.birthDate, date from asOf)"
            },
            {
              "url": "displaySequence",
              "valueInteger": 9
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "FHIRHelpers"
            },
            {
              "url": "name",
              "valueString": "ToDate"
            },
            {
              "url": "statement",
              "valueString": "define function ToDate(value date): value.value"
            },
            {
              "url": "displaySequence",
              "valueInteger": 10
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        },
        {
          "extension": [
            {
              "url": "libraryName",
              "valueString": "FHIRHelpers"
            },
            {
              "url": "name",
              "valueString": "ToBoolean"
            },
            {
              "url": "statement",
              "valueString": "define function ToBoolean(value boolean): value.value"
            },
            {
              "url": "displaySequence",
              "valueInteger": 11
            }
          ],
          "url": "http://hl7.org/fhir/StructureDefinition/cqf-logicDefinition"
        }
      ],
      "name": "EffectiveDataRequirements",
      "status": "active",
      "type": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/library-type",
            "code": "module-definition"
          }
        ]
      },
      "relatedArtifact": [
        {
          "type": "depends-on",
          "display": "FHIR model information",
          "resource": "http://hl7.org/fhir/uv/cql/Library/FHIR-ModelInfo|4.0.1"
        },
        {
          "type": "depends-on",
          "display": "Library FHIRHelpers",
          "resource": "http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1"
        },
        {
          "type": "depends-on",
          "display": "Library PatientCommon",
          "resource": "https://madie.cms.gov/Library/PatientCommon"
        },
        {
          "type": "depends-on",
          "display": "Library FHIRHelpers",
          "resource": "http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1"
        }
      ],
      "parameter": [
        {
          "name": "Measurement Period",
          "use": "in",
          "min": 0,
          "max": "1",
          "type": "Period"
        },
        {
          "name": "Numerator",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "boolean"
        },
        {
          "name": "Stratifier P21Y--P41Y",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "boolean"
        },
        {
          "name": "Denominator",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "boolean"
        },
        {
          "name": "Stratifier P0Y--P21Y",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "boolean"
        },
        {
          "name": "Initial Population",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "boolean"
        },
        {
          "name": "Stratifier P41Y--P9999Y",
          "use": "out",
          "min": 0,
          "max": "1",
          "type": "boolean"
        }
      ],
      "dataRequirement": [
        {
          "type": "Encounter",
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Encounter"
          ],
          "mustSupport": [
            "status",
            "period"
          ]
        },
        {
          "type": "Patient",
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Patient"
          ]
        },
        {
          "type": "Patient",
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Patient"
          ]
        },
        {
          "type": "Encounter",
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Encounter"
          ],
          "mustSupport": [
            "status",
            "period"
          ]
        },
        {
          "type": "Patient",
          "profile": [
            "http://hl7.org/fhir/StructureDefinition/Patient"
          ]
        }
      ]
    }
  ],
  "extension": [
    {
      "url": "http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-effectiveDataRequirements",
      "valueCanonical": "#effective-data-requirements"
    }
  ],
  "url": "https://madie.cms.gov/Measure/StratificationPatientExample",
  "version": "2026.0.0",
  "status": "draft",
  "date": "2026-04-06T15:48:46+00:00",
  "library": [
    "https://madie.cms.gov/Library/StratificationPatientExample"
  ],
  "scoring": {
    "coding": [
      {
        "system": "http://hl7.org/fhir/measure-scoring",
        "code": "proportion"
      }
    ]
  },
  "group": [
    {
      "id": "group-1",
      "extension": [
        {
          "url": "http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-populationBasis",
          "valueCode": "boolean"
        }
      ],
      "population": [
        {
          "id": "initial-population",
          "code": {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/measure-population",
                "code": "initial-population",
                "display": "Initial Population"
              }
            ]
          },
          "criteria": {
            "language": "text/cql-identifier",
            "expression": "Initial Population"
          }
        },
        {
          "id": "denominator",
          "code": {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/measure-population",
                "code": "denominator",
                "display": "Denominator"
              }
            ]
          },
          "criteria": {
            "language": "text/cql-identifier",
            "expression": "Denominator"
          }
        },
        {
          "id": "numerator",
          "code": {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/measure-population",
                "code": "numerator",
                "display": "Numerator"
              }
            ]
          },
          "criteria": {
            "language": "text/cql-identifier",
            "expression": "Numerator"
          }
        }
      ],
      "stratifier": [
        {
          "code": {
            "text": "Criteria-based Age Range Stratifier, 0 to 20 years"
          },
          "criteria": {
            "language": "text/cql-identifier",
            "expression": "Stratifier P0Y--P21Y"
          }
        },
        {
          "code": {
            "text": "Criteria-based Age Range Stratifier, 21 to 40 years"
          },
          "criteria": {
            "language": "text/cql-identifier",
            "expression": "Stratifier P21Y--P41Y"
          }
        },
        {
          "code": {
            "text": "Criteria-based Age Range Stratifier, 41+ years"
          },
          "criteria": {
            "language": "text/cql-identifier",
            "expression": "Stratifier P41Y--P9999Y"
          }
        },
        {
          "code": {
            "text": "Value-based Gender and Age Range Stratifier"
          },
          "component": [
            {
              "code": {
                "text": "Value-based Gender Component Stratifier"
              },
              "criteria": {
                "language": "text/cql-identifier",
                "expression": "Gender Stratifier"
              }
            },
            {
              "code": {
                "text": "Value-based Age Range Component Stratifier"
              },
              "criteria": {
                "language": "text/cql-identifier",
                "expression": "Age Range Stratifier"
              }
            }
          ]
        }
      ]
    }
  ]
}

FHIR © HL7.org 2011+. | FHIRsmith 4.0.1 © HealthIntersections.com.au 2023+ | XIG built as of 2026-04-07 | 262,381 resources in 1,414 packages | (23 ms)