Your User Friendly Name for MyContentIG Here
0.5.3 - CI Build

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.3 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

## Library: HIVViralSuppressionFHIRExample

Official URL: http://somewhere.org/fhir/uv/mycontentig/Library/HIVViralSuppressionFHIRExample | Version: 0.5.3
Draft as of 2025-12-10 | Computable Name: HIVViralSuppressionFHIRExample

Metadata
Version | 0.5.3
Status | Draft
Jurisdiction | 001 from http://unstats.un.org/unsd/methods/m49/m49.htm
Steward (Publisher) | HL7 International - [Some] Work Group
Type | logic-library from http://terminology.hl7.org/CodeSystem/library-type
Dependency | Description: Library FHIRHelpers Resource: `http://somewhere.org/fhir/uv/mycontentig/Library/FHIRHelpers|4.0.1` Canonical URL: `http://somewhere.org/fhir/uv/mycontentig/Library/FHIRHelpers|4.0.1`
Dependency | Description: Library CQMCommon Resource: CQMCommonExample Canonical URL: `http://somewhere.org/fhir/uv/mycontentig/Library/CQMCommonExample`
Dependency | Description: Library QICoreCommon Resource: QICoreCommonExample Canonical URL: `http://somewhere.org/fhir/uv/mycontentig/Library/QICoreCommonExample`
Dependency | Description: Library SDE Resource: SupplementalDataElementsExample Canonical URL: `http://somewhere.org/fhir/uv/mycontentig/Library/SupplementalDataElementsExample`
Dependency | Description: Code system SNOMEDCT Resource: SNOMED CT (all versions) Canonical URL: `http://snomed.info/sct`
Dependency | Description: Code system CPT Resource: Current Procedural Terminology (CPT®) Canonical URL: `http://www.ama-assn.org/go/cpt`
Dependency | Description: Value set Annual Wellness Visit Resource: Annual Wellness Visit Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.526.3.1240`
Dependency | Description: Value set Face-to-Face Interaction Resource: Face-to-Face Interaction Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1048`
Dependency | Description: Value set HIV Resource: HIV Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.120.12.1003`
Dependency | Description: Value set HIV Viral Load Resource: HIV Viral Load Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.120.12.1002`
Dependency | Description: Value set Home Healthcare Services Resource: Home Healthcare Services Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1016`
Dependency | Description: Value set Office Visit Resource: Office Visit Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1001`
Dependency | Description: Value set Outpatient Consultation Resource: Outpatient Consultation Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1008`
Dependency | Description: Value set Preventive Care Services Established Office Visit, 18 and Up Resource: Preventive Care Services Established Office Visit, 18 and Up Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1025`
Dependency | Description: Value set Preventive Care Services Initial Office Visit, 18 and Up Resource: Preventive Care Services Initial Office Visit, 18 and Up Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1023`
Dependency | Description: Value set Preventive Care Services Other Resource: Preventive Care Services Other Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1030`
Dependency | Description: Value set Preventive Care Services, Initial Office Visit, 0 to 17 Resource: Preventive Care Services, Initial Office Visit, 0 to 17 Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1022`
Dependency | Description: Value set Preventive Care, Established Office Visit, 0 to 17 Resource: Preventive Care, Established Office Visit, 0 to 17 Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1024`
Dependency | Description: Value set Telehealth Services Resource: Telehealth Services Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1031`
Dependency | Description: Value set Telephone Visits Resource: Telephone Visits Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1080`
Data Requirement | Type: Patient Profile(s): QICore Patient
Data Requirement | Type: Condition Profile(s): `http://hl7.org/fhir/us/qicore/StructureDefinition/qicore-condition` Must Support Elements: code Code Filter(s): Path: code ValueSet: HIV
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Office Visit
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Outpatient Consultation
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Annual Wellness Visit
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Face-to-Face Interaction
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Home Healthcare Services
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Preventive Care Services Established Office Visit, 18 and Up
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Preventive Care Services Initial Office Visit, 18 and Up
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Preventive Care Services, Initial Office Visit, 0 to 17
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Preventive Care, Established Office Visit, 0 to 17
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Telephone Visits
Data Requirement | Type: Encounter Profile(s): QICore Encounter Must Support Elements: type, period Code Filter(s): Path: type ValueSet: Preventive Care Services Other
Data Requirement | Type: Observation Profile(s): QICore Observation Must Support Elements: code, effective Code Filter(s): Path: code ValueSet: HIV Viral Load
Parameters
Name | Use | Card. | Type | Documentation
Measurement Period | In | 0..1 | Period |
Patient | Out | 0..1 | Resource |
Has Active HIV Diagnosis Before or in First 90 Days of Measurement Period | Out | 0..1 | boolean |
Has Qualifying Encounter During First 240 Days of Measurement Period | Out | 0..1 | boolean |
Initial Population | Out | 0..1 | boolean |
Denominator | Out | 0..1 | boolean |
SDE Ethnicity | Out | 0..1 | Resource |
SDE Payer | Out | 0..* | Resource |
SDE Race | Out | 0..1 | Resource |
SDE Sex | Out | 0..1 | Coding |
Most Recent Viral Load Test During Measurement Period | Out | 0..1 | Resource |
Numerator | Out | 0..1 | boolean |
Library Content
CQL Content |
    library HIVViralSuppressionFHIRExample version '0.5.3-cibuild'

    using QICore version '4.1.1'

    include FHIRHelpers version '4.0.1' called FHIRHelpers
    include CQMCommonExample called CQMCommon
    include QICoreCommonExample called QICoreCommon
    include SupplementalDataElementsExample called SDE

    codesystem "SNOMEDCT": 'http://snomed.info/sct'
    codesystem "CPT": 'http://www.ama-assn.org/go/cpt'

    valueset "Annual Wellness Visit": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.526.3.1240'
    valueset "Face-to-Face Interaction": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1048'
    valueset "HIV": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.120.12.1003'
    valueset "HIV Viral Load": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.120.12.1002'
    valueset "Home Healthcare Services": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1016'
    valueset "Office Visit": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1001'
    valueset "Outpatient Consultation": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1008'
    valueset "Preventive Care Services Established Office Visit, 18 and Up": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1025'
    valueset "Preventive Care Services Initial Office Visit, 18 and Up": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1023'
    valueset "Preventive Care Services Other": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1030'
    valueset "Preventive Care Services, Initial Office Visit, 0 to 17": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1022'
    valueset "Preventive Care, Established Office Visit, 0 to 17": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1024'
    valueset "Telehealth Services": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1031'
    valueset "Telephone Visits": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1080'

    code "Below threshold level (qualifier value)": '260988000' from "SNOMEDCT" display 'Below threshold level (qualifier value)'
    code "Not detected (qualifier value)": '260415000' from "SNOMEDCT" display 'Not detected (qualifier value)'
    /*code "Unlisted preventive medicine service": '99429' from "CPT" display 'Unlisted preventive medicine service'*/
      /*additional info can be found in CQLIT-368*/

    parameter "Measurement Period" Interval<DateTime>
      default Interval[@2024-01-01T00:00:00.0, @2025-01-01T00:00:00.0)

    context Patient

    define "Denominator":
      "Initial Population"

    define "SDE Ethnicity":
      SDE."SDE Ethnicity"

    define "SDE Payer":
      SDE."SDE Payer"

    define "SDE Race":
      SDE."SDE Race"

    define "SDE Sex":
      SDE."SDE Sex"

    define "Has Active HIV Diagnosis Before or in First 90 Days of Measurement Period":
      exists ["Condition": "HIV"] HIVDx
        where QICoreCommon."ToPrevalenceInterval" ( HIVDx ) starts before day of ( start of "Measurement Period" + 90 days )

    define "Initial Population":
      "Has Active HIV Diagnosis Before or in First 90 Days of Measurement Period"
        and "Has Qualifying Encounter During First 240 Days of Measurement Period"

    define "Most Recent Viral Load Test During Measurement Period":
      Last(["Observation": "HIV Viral Load"] ViralLoad
          where QICoreCommon."Latest"(ViralLoad.effective) during day of "Measurement Period"
          sort by start of QICoreCommon."ToInterval"(effective)
      )

    define "Has Qualifying Encounter During First 240 Days of Measurement Period":
      exists ( ["Encounter": "Office Visit"]
        union ["Encounter": "Outpatient Consultation"]
        union ["Encounter": "Annual Wellness Visit"]
        union ["Encounter": "Face-to-Face Interaction"]
        union ["Encounter": "Home Healthcare Services"]
        union ["Encounter": "Preventive Care Services Established Office Visit, 18 and Up"]
        union ["Encounter": "Preventive Care Services Initial Office Visit, 18 and Up"]
        union ["Encounter": "Preventive Care Services, Initial Office Visit, 0 to 17"]
        union ["Encounter": "Preventive Care, Established Office Visit, 0 to 17"]
        union ["Encounter": "Telephone Visits"]
        union ["Encounter": "Preventive Care Services Other"] ) QualifyingEncounter
        where QualifyingEncounter.period during day of Interval[start of "Measurement Period", start of "Measurement Period" + 240 days]

    define "Numerator":
      "Most Recent Viral Load Test During Measurement Period".value < 200 '{copies}/mL'
        or "Most Recent Viral Load Test During Measurement Period".value ~ "Below threshold level (qualifier value)"
        or "Most Recent Viral Load Test During Measurement Period".value ~ "Not detected (qualifier value)"
    // or "Most Recent Viral Load Test During Measurement Period".value = "Below threshold level (qualifier value)"
    // or "Most Recent Viral Load Test During Measurement Period".value = "Not detected (qualifier value)"
ELM XML Content |
    Encoded data
ELM JSON Content |
    Encoded data
Generated using version 0.5.3 of the sample-content-ig Liquid templates