US Situational Awareness Framework for Reporting (US SAFR) Implementation Guide
1.0.0 - STU 1 ballot United States of America flag

US Situational Awareness Framework for Reporting (US SAFR) Implementation Guide, published by HL7 International / Public Health. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/us-safr/ and changes regularly. See the Directory of published versions

Library: Library - HRD Measure Example

Official URL: http://hl7.org/fhir/us-safr/Library/HRDMeasureLibrary Version: 1.0.0
Standards status: Informative Computable Name: HRDMeasureLibrary
Other Identifiers: OID:2.16.840.1.113883.4.642.40.53.28.3

Usage:Clinical Focus: Disease

This library contains CQL logic for evaluating structural measures related to hospital respiratory disease reporting capabilities

Metadata
Title Library - HRD Measure Example
Version 1.0.0
Identifier urn:oid:2.16.840.1.113883.4.642.40.53.28.3
Use Context focus from http://terminology.hl7.org/CodeSystem/usage-context-type = Disease
Jurisdiction United States of America
Steward (Publisher) HL7 International / Public Health
Steward Contact HL7 International / Public Health
Description

This library contains CQL logic for evaluating structural measures related to hospital respiratory disease reporting capabilities

Type logic-library from http://terminology.hl7.org/CodeSystem/library-type
Parameter Name: Measurement Period
Use: In
Min Cardinality: 1
Max Cardinality: 1
Type: Period
Data Requirement Type: Device
Profile(s): Device
Code Filter(s):
Path: type
ValueSet: COVID_19 (Disorders) (ICD10CM)
Data Requirement Type: Device
Profile(s): Device
Code Filter(s):
Path: type
ValueSet: Acute Tonsillitis
Data Requirement Type: Device
Profile(s): Device
Code Filter(s):
Path: type
ValueSet: http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1146.1124|20240123
Data Requirement Type: Device
Profile(s): Device
Code Filter(s):
Path: type
ValueSet: http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1146.1125
Data Requirement Type: Device
Profile(s): Device
Code Filter(s):
Path: type
ValueSet: http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.5.1001
Data Requirement Type: Location
Profile(s): Location
Code Filter(s):
Path: type
ValueSet: Discharge To Acute Care Facility
Data Requirement Type: Location
Profile(s): Location
Code Filter(s):
Path: physicalType.coding.code
Code(s): Location type bd: Bed (version = 2.0.1 )
Data Requirement Type: DocumentReference
Profile(s): DocumentReference
Code Filter(s):
Path: type.coding.code
Code(s): LOINC 11516-2: Physician Episode of care medical records
Data Requirement Type: Communication
Profile(s): Communication
Code Filter(s):
Path: category.coding.code
Code(s): CommunicationCategory notification: Notification
Library Content
CQL Content
library HRDMeasureStructureLibrary version '1.0.0'

using FHIR version '4.0.1'

include FHIRHelpers version '4.0.1' called FHIRHelpers

// Terminology definitions
codesystem "LOINC": 'http://loinc.org'
codesystem "SNOMED CT": 'http://snomed.info/sct&
codesystem "ICD-10-CM": 'http://hl7.org/fhir/sid/icd-10-cm'

// Value sets
valueset "Respiratory Specimen Collection Devices": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1146.1125'
valueset "COVID-19 Tests": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1146.1123'
valueset "Influenza Tests": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.102.12.1012'
valueset "RSV Tests": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1146.1124'
valueset "ICU Location Types": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.117.1.7.1.87'
valueset "Ventilator Device Types": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.5.1001'

// Parameter for measurement period
parameter "Measurement Period" Interval<Date>
  default Interval[@2025-03-01, @2025-03-07]

context Patient

// STRUCTURE MEASURE COMPONENTS
// For a structure measure, we assess capabilities, resources and organizational structures

// 1. Test for the presence of respiratory testing capabilities
define "Has COVID-19 Testing Capability":
  exists (
    [Device] Device
      where Device.type.coding in "COVID-19 Tests"
        and Device.status = 'active'
  )

define "Has Influenza Testing Capability":
  exists (
    [Device] Device
      where Device.type.coding in "Influenza Tests"
        and Device.status = 'active'
  )

define "Has RSV Testing Capability":
  exists (
    [Device] Device
      where Device.type.coding in "RSV Tests"
        and Device.status = 'active'
  )

define "Has Specimen Collection Capabilities":
  exists (
    [Device] Device
      where Device.type.coding in "Respiratory Specimen Collection Devices"
        and Device.status = 'active'
  )

define "Has ICU Locations":
  exists (
    [Location] Location
      where Location.type.coding in "ICU Location Types"
        and Location.status = 'active'
  )

define "Has Ventilator Resources":
  exists (
    [Device] Device
      where Device.type.coding in "Ventilator Device Types"
        and Device.status = 'active'
  )

define "Has HRD Reporting Protocol":
  exists (
    [DocumentReference] D
      where D.type.coding.code in {'11516-2'} // LOINC for infection control protocol
        and D.status = 'current'
        and D.description contains 'NHSN'
        and D.description contains 'HRD'
  )

// CONTINUOUS VARIABLE CALCULATIONS

// Hospital capacity metrics
define "Total Bed Capacity":
  Sum(
    [Location] Location
      where Location.status = 'active'
        and Location.physicalType.coding.code = 'bd'
      return (
        Location.extension E
          where E.url = 'http://hl7.org/fhir/StructureDefinition/location-bed-count'
          return E.valueInteger
      ).valueInteger
  )

define "ICU Bed Capacity":
  Sum(
    [Location] Location
      where Location.status = 'active'
        and Location.type.coding in "ICU Location Types"
        and Location.physicalType.coding.code = 'bd'
      return (
        Location.extension E
          where E.url = 'http://hl7.org/fhir/StructureDefinition/location-bed-count'
          return E.valueInteger
      ).valueInteger
  )

define "Ventilator Count":
  Count(
    [Device] Device
      where Device.type.coding in "Ventilator Device Types"
        and Device.status = 'active'
  )

// Weekly reporting compliance and metrics
define "Reporting Weeks in Measurement Period":
  Count(
    expand{2025-03-01, @2025-03-07, week}
  )

define "HRD Reports Submitted During Period":
  Count(
    [Communication] C
      where C.category.coding.code in {'notification'}
        and C.topic.text contains 'NHSN'
        and C.topic.text contains 'HRD'
        and C.sent during "Measurement Period"
  )

define "Weekly Reporting Compliance":
  "HRD Reports Submitted During Period" / "Reporting Weeks in Measurement Period"

// Structural readiness scores
define "Has All Testing Capabilities":
  if ("Has COVID-19 Testing Capability" and "Has Influenza Testing Capability" and "Has RSV Testing Capability")
    then 1
    else 0

define "Has Required Reporting Structure":
  if ("Has HRD Reporting Protocol") 
    then 1
    else 0

// Continuous variable for structural measure assessment
define "Structural Readiness Score":
  ("Has COVID-19 Testing Capability" as Integer +
   "Has Influenza Testing Capability" as Integer +
   "Has RSV Testing Capability" as Integer +
   "Has Specimen Collection Capabilities" as Integer +
   "Has ICU Locations" as Integer +
   "Has Ventilator Resources" as Integer +
    "Has HRD Reporting Protocol" as Integer) / 7.0 * 100.0

// Main measure calculation - now focusing on structural components and their ratings
define "Measure Population":
  true

define "Measure Observation":
  "Structural Readiness Score"
Generated using version 0.5.1-cibuild of the sample-content-ig Liquid templates