WHO SMART Guidelines - HIV
0.4.4 - ci-build

WHO SMART Guidelines - HIV, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.4.4 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-hiv/tree/main and changes regularly. See the Directory of published versions

Measure: HIV.IND.42 Final outcome of PMTCT (Experimental)

Official URL: http://smart.who.int/hiv/Measure/HIVIND42 Version: 0.4.4
Draft as of 2024-08-18 Computable Name: HIVIND42

% of HIV-exposed infants whose final HIV outcome status is known

Knowledge Artifact Metadata
Name (machine-readable) HIVIND42
Title (human-readable) HIV.IND.42 Final outcome of PMTCT
Status Draft
Experimental true
Description

% of HIV-exposed infants whose final HIV outcome status is known

Measure Steward WHO
Steward Contact Details WHO: http://who.int
Measure Metadata
Version Number 0.4.4
Measure Scoring Proportion
Improvement Notation Increased score indicates improvement
Population Basis boolean
Measure Population Criteria
Initial Population ID: HIV.IND.42.IP
Description:

Initial Population

Logic Definition: Initial Population
Denominator ID: HIV.IND.42.DEN
Description:

a) Programme-based/service delivery denominator | Number of HIV-exposed infants who were born within the 12 months (or 24 months in breastfeeding settings) prior to the reporting period and registered in the birth cohort | For example, for the reporting period January to December 2021 the denominator would be the number of HIV-exposed infants born between January to December 2020 in non-breast feeding settings and January to December 2019 in breastfeeding settings. | | b) Population-based denominator | Estimated number of HIV-positive women who delivered within the past 12 months | (or 24 months in breastfeeding settings)

Logic Definition: Denominator
Numerator ID: HIV.IND.42.NUM
Description:

HIV-exposed infants born within the past 12 months (or 24 months in breastfeeding settings) who have known final HIV outcome status

Logic Definition: Numerator
Measure Logic
Primary Library HIV.IND.42 Logic
Dependency Description: FHIR model information
Resource: http://fhir.org/guides/cqf/common/Library/FHIR-ModelInfo|4.0.1
Canonical URL: http://fhir.org/guides/cqf/common/Library/FHIR-ModelInfo|4.0.1
Dependency Description: Library HIE
Resource: HIVIndicatorElements
Canonical URL: http://smart.who.int/hiv/Library/HIVIndicatorElements
Dependency Description: Library FHIRHelpers
Resource: http://fhir.org/guides/cqf/common/Library/FHIRHelpers|4.0.1
Canonical URL: http://fhir.org/guides/cqf/common/Library/FHIRHelpers|4.0.1
Dependency Description: Library Elements
Resource: HIVElements
Canonical URL: http://smart.who.int/hiv/Library/HIVElements
Dependency Description: Library Concepts
Resource: http://smart.who.int/hiv/Library/HIVConcepts|0.0.2
Canonical URL: http://smart.who.int/hiv/Library/HIVConcepts|0.0.2
Dependency Description: Library WC
Resource: WHOCommon
Canonical URL: http://smart.who.int/hiv/Library/WHOCommon
Dependency Description: Code system HIVConcepts
Resource: WHO SMART HIV Concepts CodeSystem
Canonical URL: http://smart.who.int/hiv/CodeSystem/HIVConcepts
Direct Reference Code Display: HIV-exposed infant or child
Code: HIV.E.DE112
System: http://smart.who.int/hiv/CodeSystem/HIVConcepts
Direct Reference Code Display: Live birth
Code: HIV.E.DE48
System: http://smart.who.int/hiv/CodeSystem/HIVConcepts
Direct Reference Code Display: Breastfeeding
Code: HIV.B.DE32
System: http://smart.who.int/hiv/CodeSystem/HIVConcepts
Direct Reference Code Display: Registered in birth cohort
Code: HIV.E.DE179
System: http://smart.who.int/hiv/CodeSystem/HIVConcepts
Direct Reference Code Display: Final diagnosis of HIV-exposed infant
Code: HIV.E.DE230
System: http://smart.who.int/hiv/CodeSystem/HIVConcepts
Parameter Name: Measurement Period
Use: In
Min Cardinality: 0
Max Cardinality: 1
Type: Period
Parameter Name: Numerator
Use: Out
Min Cardinality: 0
Max Cardinality: 1
Type: boolean
Parameter Name: Denominator
Use: Out
Min Cardinality: 0
Max Cardinality: 1
Type: boolean
Parameter Name: Initial Population
Use: Out
Min Cardinality: 0
Max Cardinality: 1
Type: boolean
Measure Logic Data Requirements
Data Requirement Type: Patient
Profile(s): Patient
Data Requirement Type: Observation
Profile(s): Observation
Must Support Elements: code, status, effective
Code Filter(s):
Path: code
Code:
Data Requirement Type: Observation
Profile(s): Observation
Must Support Elements: code, status, value, effective
Code Filter(s):
Path: code
Code:
Data Requirement Type: Observation
Profile(s): Observation
Must Support Elements: code, status, value
Code Filter(s):
Path: code
Code:
Data Requirement Type: Observation
Profile(s): Observation
Must Support Elements: code, status, value, effective
Code Filter(s):
Path: code
Code:
Data Requirement Type: Observation
Profile(s): Observation
Must Support Elements: code, status, effective
Code Filter(s):
Path: code
Code:
Measure Logic Definitions
Logic Definition Library Name: HIVIndicatorElements
define "Is Infant Patient":
  Patient.birthDate is not null
  and difference in years between Patient.birthDate and start of "Measurement Period" < 1
Logic Definition Library Name: HIVElements
/* End of Age of infant */

/*
@dataElement: HIV.E.DE112 - HIV-exposed infant or child
@activity: HIV.F6 Check whether infant/child had HIV exposure
@description: Whether the infant or child was determined to have had HIV exposure
*/
define "HIV-exposed infant or child E.DE112":

  [Observation: Concepts."HIV-exposed infant or child - HIV.E.DE112"] O
    where O.status in { 'final', 'amended', 'corrected' }
Logic Definition Library Name: HIVIndicatorElements
/* End of Age of infant */

/*
@dataElement: HIV.E.DE112 - HIV-exposed infant or child
@activity: HIV.F6 Check whether infant/child had HIV exposure
@description: Whether the infant or child was determined to have had HIV exposure
*/
define "is HIV-exposed infant or child E.DE112":
  "Is Infant Patient" and 
  exists(Elements."HIV-exposed infant or child E.DE112" O
    where O.effective.toInterval() during "Measurement Period")
Logic Definition Library Name: HIVElements
/* End of Newly on ART during labour and delivery */

/*
@dataElement: HIV.E.DE46 - Delivery date
@activity: HIV.E1 Capture or update mother's history
@description: Date on which the woman delivered
*/
define "Live Birth Delivery":
  [Observation: Concepts."Live birth"] O
    where O.status in { 'final', 'amended', 'corrected' }
Logic Definition Library Name: HIVIndicatorElements
/* End of Newly on ART during labour and delivery */

/*
@dataElement: HIV.E.DE46 - Delivery date
@activity: HIV.E1 Capture or update mother's history
@description: Date on which the woman delivered
*/
define "Live Birth Delivery":
  Elements."Live Birth Delivery" O
    where O.effective.toInterval() during "Measurement Period"
Logic Definition Library Name: HIVElements
/* End of Currently pregnant B.DE29 */

/*
@dataElement: HIV.B.DE32 - Breastfeeding
@activity: HIV.B6 Capture or update client history
@description: Infant is being breastfed by mother
*/

define "Breastfeeding B.DE32":
  [Observation: Concepts."Breastfeeding - HIV.B.DE32"] O
    where O.status in { 'final', 'amended', 'corrected' }
      and O.value is true
Logic Definition Library Name: HIVIndicatorElements
/* End of Currently pregnant B.DE29 */

/*
@dataElement: HIV.B.DE32 - Breastfeeding
@activity: HIV.B6 Capture or update client history
@description: Infant is being breastfed by mother
*/

define "Breastfeeding B.DE32":
  Elements."Breastfeeding B.DE32" O
    where O.effective.toInterval() during "Measurement Period"
Logic Definition Library Name: HIVElements
/* End of First visit after the end of breastfeeding */

/*
@dataElement: HIV.E.DE179 - Registered in birth cohort
@activity: HIV.F3 Capture or update infant's/child's history
@description: Whether the infant has been registered in a birth cohort
*/

define "Registered in birth cohort":
  [Observation: Concepts."Registered in birth cohort"] O
    where O.status in { 'final', 'amended', 'corrected' }
      and O.value is true
Logic Definition Library Name: HIVIndicatorElements
/* End of First visit after the end of breastfeeding */

/*
@dataElement: HIV.E.DE179 - Registered in birth cohort
@activity: HIV.F3 Capture or update infant's/child's history
@description: Whether the infant has been registered in a birth cohort
*/

define "Registered in birth cohort":
  exists Elements."Registered in birth cohort" O
    where O.effective.toInterval() during "Measurement Period"
Logic Definition Library Name: HIVElements
define "Final diagnosis of HIV-exposed infant E.DE230 Observation":
  [Observation: Concepts."Final diagnosis of HIV-exposed infant - HIV.E.DE230"] O
    where O.status in { 'final', 'amended', 'corrected' }
Logic Definition Library Name: HIVElements
/* End of Infant ART start date */

/*
@dataElement: HIV.E.DE230 - Final diagnosis of HIV-exposed infant
@activity: HIV.F20 Record infant's/child's final HIV diagnosis
@description: HIV-exposed infant final status at 18 months or 3 months after cessation of breastfeeding (whichever is later).
*/

define "Final diagnosis of HIV-exposed infant E.DE230":
  First("Final diagnosis of HIV-exposed infant E.DE230 Observation".value) as FHIR.CodeableConcept
Logic Definition Library Name: HIVIND42Logic
/**
 * Numerator
 * 
 * Definition: HIV-exposed infants born within the past 12 months (or 24 months in breastfeeding settings) who have known final HIV outcome status
 * Calculation: COUNT of infants who are an "HIV-exposed infant or child" AND [(with an "Infant date of birth" in past 12 months) OR (with an "Infant date of birth" in past 24 months IF mothers are "Breastfeeding")] AND "Registered in birth cohort"=True AND with a "Final diagnosis of HIV-exposed infant" of NOT NULL
 */

define "Numerator":
  HIE."is HIV-exposed infant or child E.DE112"
  and
  (exists(HIE."Live Birth Delivery" B where months between end of B.effective.toInterval() and end of  "Measurement Period" < 12 months)
  or 
  (
  exists(HIE."Breastfeeding B.DE32" B) and
  exists(HIE."Live Birth Delivery" B where months between end of B.effective.toInterval() and end of  "Measurement Period" < 24 months)
  )
  )
  and HIE."Registered in birth cohort"
  and HE."Final diagnosis of HIV-exposed infant E.DE230" is not null
Logic Definition Library Name: HIVIND42Logic
/**
 * Denominator
 *
 * Definition: a) Programme-based/service delivery denominator | Number of HIV-exposed infants who were born within the 12 months (or 24 months in breastfeeding settings) prior to the reporting period and registered in the birth cohort | For example, for the reporting period January to December 2021 the denominator would be the number of HIV-exposed infants born between January to December 2020 in non-breast feeding settings and January to December 2019 in breastfeeding settings. |  | b) Population-based denominator | Estimated number of HIV-positive women who delivered within the past 12 months | (or 24 months in breastfeeding settings)
 * Calculation: COUNT of infants who are an "HIV-exposed infant or child" AND [(with an "Infant date of birth" within past 12 months) OR (with an "Infant date of birth" within past 24 months IF mothers are "Breastfeeding")] AND "Registered in birth cohort"=True
 */

define "Denominator":
  HIE."is HIV-exposed infant or child E.DE112"
  and
  (exists(HIE."Live Birth Delivery" B where months between end of B.effective.toInterval() and end of  "Measurement Period" < 12 months)
  or 
  (
  exists(HIE."Breastfeeding B.DE32" B) and
  exists(HIE."Live Birth Delivery" B where months between end of B.effective.toInterval() and end of  "Measurement Period" < 24 months)
  )
  )
  and HIE."Registered in birth cohort"
Logic Definition Library Name: HIVIND42Logic
/* Populations */

/*
 *Initial Population
 */

define "Initial Population":
  true
Logic Definition Library Name: FHIRHelpers
define function ToDate(value date): value.value
Logic Definition Library Name: FHIRHelpers
define function ToString(value ObservationStatus): value.value
Logic Definition Library Name: FHIRHelpers
define function ToBoolean(value boolean): value.value
Generated using version 0.4.6 of the sample-content-ig Liquid templates