Quality Measure Implementation Guide
2.0.0-ballot - STU 2 Ballot

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

## Library: Example Executable Library (Experimental)

Official URL: http://hl7.org/fhir/uv/cqm/Library/EXMExecutableLibrary | Version: 2.0.0 | Highlight text changes?
Standards status: Informative Active as of 2019-09-03 | Computable Name: EXMExecutableLibrary
Other Identifiers: http://example.org/fhir/cqi/ecqm/Library/Identifier#EXMExecutableLibrary (use: official, ), OID:2.16.840.1.113883.4.642.40.61.28.16

This library is used as an example in the FHIR Quality Measure Implementation Guide

Metadata
Title | Example Executable Library
Version | 2.0.0
Identifier | EXMExecutableLibrary
Identifier | urn:oid:2.16.840.1.113883.4.642.40.61.28.16
Approval Date | 2019-08-03
Last Review Date | 2019-08-03
Experimental | true
Jurisdiction | 001 from http://unstats.un.org/unsd/methods/m49/m49.htm
Topic | FHIR
Topic | CQL
Steward (Publisher) | HL7 International / Clinical Quality Information
Description | This library is used as an example in the FHIR Quality Measure Implementation Guide
Type | logic-library from http://terminology.hl7.org/CodeSystem/library-type
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`
Dependency | Description: Code System Diagnosis Role Resource: Diagnosis Role Canonical URL: `http://terminology.hl7.org/CodeSystem/diagnosis-role`
Dependency | Description: Value Set Emergency Department Visit Resource: Emergency Department Visit Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.117.1.7.1.292`
Dependency | Description: Value Set Psychiatric/Mental Health Patient Resource: Psychiatric/Mental Health Diagnosis Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.117.1.7.1.299`
Dependency | Description: Value Set Hospital Settings Resource: Hospital Settings Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1111.126`
Dependency | Description: Value Set ONC Administrative Sex Resource: ONC Administrative Sex Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1`
Dependency | Description: Value Set Race Resource: Race Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.836`
Dependency | Description: Value Set Ethnicity Resource: Ethnicity Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.837`
Dependency | Description: Value Set Payer Resource: Payer Type Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.3591`
Data Requirement | Type: Encounter Profile(s): Encounter
Data Requirement | Type: Condition Profile(s): Condition Code Filter(s): Path: id
Data Requirement | Type: Encounter Profile(s): Encounter Code Filter(s): Path: type ValueSet: Emergency Department Visit
Data Requirement | Type: Coverage Profile(s): Coverage Code Filter(s): Path: type ValueSet: Payer Type
Parameters
Name | Use | Card. | Type | Documentation
Measurement Period | In | 0..1 | Period |
Patient | Out | 0..1 | Patient |
Inpatient Encounter | Out | 0..* | Encounter |
Initial Population | Out | 0..* | Encounter |
Measure Population | Out | 0..* | Encounter |
Stratifier 1 | Out | 0..* | Encounter |
Stratifier 2 | Out | 0..* | Encounter |
Stratifier 3 | Out | 0..* | Encounter |
Stratifier 4 | Out | 0..* | Encounter |
SDE Ethnicity | Out | 0..* | Coding |
SDE Payer | Out | 0..* | Resource |
SDE Race | Out | 0..* | Coding |
SDE Sex | Out | 0..1 | Coding |
Library Content
CQL Content |
    /*
    This example is purely for illustration purposes to show how all the elements of a
    FHIR-based quality measure are represented. It is intentionally simplified to show
    specific aspects of a measure, and is not intended as an example of a clinically
    meaningful measure.

    NOTE: This is the same library as EXMLogic, being used to illustrate the different flavors of profiles:
    * Computable: Focusing on computable/design-time aspects
    * Executable: Focusing on run-time aspects
    * Publishable: Focusing on knowledge management aspects
    */
    library EXMExecutableLibrary version '2.0.0'

    using FHIR version '4.0.1'

    include hl7.fhir.uv.cql.FHIRHelpers version '4.0.1' called FHIRHelpers

    codesystem "Diagnosis Role": 'http://terminology.hl7.org/CodeSystem/diagnosis-role'

    valueset "Emergency Department Visit" : 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.117.1.7.1.292'
    valueset "Psychiatric/Mental Health Patient" : 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.117.1.7.1.299'
    valueset "Hospital Settings" : 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1111.126'

    valueset "ONC Administrative Sex": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1'
    valueset "Race": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.836'
    valueset "Ethnicity": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.837'
    valueset "Payer": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.3591'

    code "Billing": 'billing' from "Diagnosis Role" display 'Billing'

    parameter "Measurement Period" Interval<DateTime>

    context Patient

    define "Initial Population" :
      "Inpatient Encounter" Encounter

    define "Measure Population" :
      "Initial Population"

    define function "Measure Observation" (Encounter "Encounter" ) :
      duration in minutes of "Related ED Visit"(Encounter).period

    define "Stratifier 1" :
      "Inpatient Encounter" Encounter
        where not (PrincipalDiagnosis(Encounter).code in "Psychiatric/Mental Health Patient")

    define "Stratifier 2" :
      "Inpatient Encounter" Encounter
        where PrincipalDiagnosis(Encounter).code in "Psychiatric/Mental Health Patient"

    define "Stratifier 3" :
      "Inpatient Encounter" Encounter
        where PrincipalDiagnosis(Encounter) is null

    define "Stratifier 4" :
      "Inpatient Encounter" Encounter
        where PrincipalDiagnosis(Encounter) is null

    define "Inpatient Encounter" :
      ["Encounter"] Encounter
        where LengthInDays(Encounter.period) <= 120
          and Encounter.period ends during "Measurement Period"

    define function "PrincipalDiagnosis"(Encounter Encounter):
    	(singleton from (Encounter.diagnosis D where D.use ~ ToConcept("Billing") and D.rank.value = 1)) PD
    		return singleton from ([Condition: id in "GetId"(PD.condition.reference)])

    define function "LengthInDays"(Value Interval<DateTime>):
    	difference in days between start of Value and end of Value

    define function "GetId"(uri String):
    	Last(Split(uri, '/'))

    //Measure Observation
    define function "Related ED Visit" (Encounter "Encounter" ) :
      Last(["Encounter" : "Emergency Department Visit"] ED
        where ED.status = 'finished'
          and ED.period ends 1 hour or less before start of Encounter.period
        sort by start of period )

    define "SDE Ethnicity":
      (flatten (
        Patient.extension Extension
          where Extension.url = 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity'
            return Extension.extension
      )) E
        where E.url = 'ombCategory'
          or E.url = 'detailed'
        return E.value as Coding

    define "SDE Payer":
        [Coverage: type in "Payer"] Payer
          return {
            code: Payer.type,
            period: Payer.period
          }

    define "SDE Race":
      (flatten (
        Patient.extension Extension
          where Extension.url = 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race'
            return Extension.extension
      )) E
        where E.url = 'ombCategory'
          or E.url = 'detailed'
        return E.value as Coding

    define "SDE Sex":
      case
        when Patient.gender = 'male' then Code { code: 'M', system: 'http://hl7.org/fhir/v3/AdministrativeGender', display: 'Male' }
        when Patient.gender = 'female' then Code { code: 'F', system: 'http://hl7.org/fhir/v3/AdministrativeGender', display: 'Female' }
        else null
      end
ELM XML Content |
    Encoded data
ELM JSON Content |
    Encoded data
Generated using version 0.5.4 of the sample-content-ig Liquid templates