WHO SMART Guidelines - HIV
0.3.0 - ci-build

WHO SMART Guidelines - HIV - Local Development build (v0.3.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Library: HIV.IND.73 Logic (Experimental)

Official URL: http://smart.who.int/hiv/Library/HIVIND73Logic Version: 0.3.0
Draft as of 2024-12-06 Computable Name: HIVIND73Logic

% of people living with HIV who tested positive for gonorrhoea during the reporting period

Title: HIV.IND.73 Logic
Id: HIVIND73Logic
Version: 0.3.0
Url: HIV.IND.73 Logic
Status: draft
Experimental: true
Type:

system: http://terminology.hl7.org/CodeSystem/library-type

code: logic-library

Date: 2024-12-06 22:28:12+0000
Publisher: WHO
Description:

% of people living with HIV who tested positive for gonorrhoea during the reporting period

Content: text/cql
/**
 * Library: HIV.IND.73 Logic
 * Ref No: STI.5B
 * Short Name: Gonorrhoea test positivity, HIV-positive clients
 *
 * Definition: % of people living with HIV who tested positive for gonorrhoea during the reporting period
 *
 * Numerator: Number of people living with HIV who tested positive for gonorrhoea during the reporting period
 * Numerator Calculation: COUNT of clients with "HIV status"='HIV-positive' AND "Gonorrhoea test date" in the reporting period AND "Gonorrhoea test result"='Positive'
 * Numerator Exclusions: 
 *
 * Denominator: Number of people living with HIV tested for gonorrhoea (using a molecular test, culture or POC test) while attending HIV care and treatment services during the reporting period
 * Denominator Calculation: COUNT of clients with "HIV status"='HIV-positive' AND "Gonorrhoea test date" in the reporting period
 * Denominator Exclusions: 
 *
 * Disaggregations:
 * • Gender (male, female, other*) 
 *  • Age (15–19, 20–24, 25–29, 30–49, 50+ years) 
 *  • Key populations (men who have sex with men, people living in prisons and other closed settings, people who inject drugs, sex workers, trans and gender diverse people)** 
 *  • Diagnostic test used and anatomic site sampled 
 *  • Cities and other administrative regions of epidemiologic importance
 *
 * Disaggregation Elements: Gender | Age | Key population member type | Type of specimen | Neisseria gonorrhoeae test type
 *
 * Numerator and Denominator Elements:
 * Gonorrhoea test date 
 *  Gonorrhoea test result 
 *  HIV status
 *
 * Reference: Consolidated guidelines on person-centred HIV strategic information: strengthening routine data for impact. Geneva: World Health Organization; 2022
 * 
 * Data Concepts:
 * HIV.A.DE17: Age | Calculated age (number of years) of the client based on date of birth
 * HIV.A.DE18: Gender* | Gender of the client*
 * HIV.A.DE19: Female | Client identifies as female
 * HIV.A.DE20: Male | Client identifies as male
 * HIV.A.DE21: Transgender male | Client identifies as transgender male
 * HIV.A.DE22: Transgender female | Client identifies as transgender female
 * HIV.A.DE23: Other | Additional category
 * HIV.B.DE50: Key population member type* | The type of key population that the client is included in
 * HIV.B.DE51: Sex worker | Client is a sex worker
 * HIV.B.DE52: Men who have sex with men | Client is a man who has sex with men
 * HIV.B.DE53: Trans and gender-diverse people | Client identifies as trans and gender-diverse
 * HIV.B.DE54: People who inject drugs | Client is a person who injects drugs
 * HIV.B.DE55: People living in prisons and other closed settings | Client lives in a prison or another closed setting
 * HIV.B.DE115: HIV status | HIV status reported after applying the national HIV testing algorithm. No single HIV test can provide an HIV-positive diagnosis.
 * HIV.B.DE116: HIV-positive | Client is HIV-positive
 * HIV.B.DE117: HIV-negative | Client is HIV-negative
 * HIV.B.DE118: Unknown | Client has unknown HIV status
 * HIV.B.DE255: Gonorrhoea test date | Date of Gonorrhoea test
 * HIV.B.DE256: Gonorrhoea test result | Result from Gonorrhoea test
 * HIV.B.DE257: Positive | Test result is positive for Neisseria gonorrhoeae
 * HIV.B.DE258: Negative | Test result is negative for Neisseria gonorrhoeae
 * HIV.B.DE259: Inconclusive | Test result is inconclusive
 * HIV.B.DE261: Type of specimen | Type of specimen to be collected
 * HIV.B.DE262: Blood | Blood specimen to be collected
 * HIV.B.DE263: Urine | Urine specimen to be collected
 * HIV.B.DE264: Cervical or vaginal swab | Cervical or vaginal swab to be collected
 * HIV.B.DE265: Urethral or penile swab | Urethral or penile swab to be collected
 * HIV.B.DE266: Rectal swab | Rectal swab to be collected
 * HIV.B.DE267: Other | Other specimen type to be collected
 * HIV.B.DE276: Neisseria gonorrhoeae test type | Type of diagnostic test used for Neisseria gonorrhoeae
 * HIV.B.DE277: NAAT | Nucleic Acid Amplification Test (NAAT) used
 * HIV.B.DE278: POC Test | Point-of-care (POC) test used
 * HIV.B.DE279: Culture | Culture test used
 * HIV.B.DE280: Microscopy | Microscopy test used
 * HIV.B.DE281: Other | Other type of test used
 * HIV.D.DE807: Gonorrhoea test date | Date of Gonorrhoea test
 * HIV.D.DE808: Gonorrhoea test result | Result from Gonorrhoea test
 * HIV.D.DE809: Positive | Test result is positive for Neisseria gonorrhoeae
 * HIV.D.DE810: Negative | Test result is negative for Neisseria gonorrhoeae
 * HIV.D.DE811: Inconclusive | Test result is inconclusive
 * HIV.D.DE813: Type of specimen | Type of specimen to be collected
 * HIV.D.DE814: Blood | Blood specimen to be collected
 * HIV.D.DE815: Urine | Urine specimen to be collected
 * HIV.D.DE816: Cervical or vaginal swab | Cervical or vaginal swab to be collected
 * HIV.D.DE817: Urethral or penile swab | Urethral or penile swab to be collected
 * HIV.D.DE818: Rectal swab | Rectal swab to be collected
 * HIV.D.DE819: Other | Other specimen type to be collected
 * HIV.D.DE828: Neisseria gonorrhoeae test type | Type of diagnostic test used for Neisseria gonorrhoeae
 * HIV.D.DE829: NAAT | Nucleic Acid Amplification Test (NAAT) used
 * HIV.D.DE830: POC Test | Point-of-care (POC) test used
 * HIV.D.DE831: Culture | Culture test used
 * HIV.D.DE832: Microscopy | Microscopy test used
 * HIV.D.DE833: Other | Other type of test used
 * HIV.E.DE114: Key population member type* | The type of key population that the infant's mother is included in
 * HIV.E.DE115: Sex worker | Infant's mother is a sex worker
 * HIV.E.DE116: People who inject drugs | Infant's mother is a person who injects drugs
 * HIV.E.DE117: Trans and gender-diverse people | Infant's mother identifies as trans and gender-diverse
 * HIV.E.DE118: People living in prisons and other closed setting | Infant's mother is in a prison or closed setting
 *
 * Additional Context
 * - what it measures: A: % of people attending HIV prevention services who were tested for gonorrhoea and | had a positive test result during the reporting period | B: % of people living with HIV who were tested for gonorrhoea and had a positive test result during the reporting period
 * - rationale: • Gonorrhoea test positivity can be used to highlight areas within a country that require additional support and provide early warning of potential changes in HIV and sexually transmitted infection transmission in the general population. | • Gonorrhoea test positivity is important information for generating national, regional and global incidence and prevalence estimates for gonorrhoea. | • Data on gonorrhoea test positivity are important for understanding the challenges imposed by increasing resistance to currently recommended treatment options.
 * - method: Individual-level data obtained from programme records.   |  | If individual-level data are not available, the indicator can be reported using aggregate programme data.
 * 
 * Suggested Scoring Method: proportion | http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/proportion-measure-cqfm
 */

  /*
  * Profiles:
  * - HivGonorrhoeaTest
  * - HivStatusObservation
  * - HivStatusCondition
  */ 

library HIVIND73Logic

// Included Libraries
using FHIR version '4.0.1'

include HIVCommon version '0.0.1' called HIC
include FHIRHelpers version '4.0.1'

include WHOCommon called WCom
include HIVElements called HE
include HIVIndicatorElements called HIE
include HIVConfig called Config

// Indicator Definition
parameter "Measurement Period" Interval<Date> default Interval[@2023-01-01, @2023-01-30]

context Patient
/* Populations */

/*
 *Initial Population
 */

define "Initial Population":
  true

/**
 * Numerator
 * 
 * Definition: Number of people living with HIV who tested positive for gonorrhoea during the reporting period
 * Calculation: COUNT of clients with "HIV status"='HIV-positive' AND "Gonorrhoea test date" in the reporting period AND "Gonorrhoea test result"='Positive'
 */

define "Numerator":
  HIE."Has HIV-positive Status" and
  exists(HIE."Positive B.DE257" G)

/**
 * Denominator
 *
 * Definition: Number of people living with HIV tested for gonorrhoea (using a molecular test, culture or POC test) while attending HIV care and treatment services during the reporting period
 * Calculation: COUNT of clients with "HIV status"='HIV-positive' AND "Gonorrhoea test date" in the reporting period
 */

define "Denominator":
  HIE."Has HIV-positive Status" and
  HIE."Gonorrhoea test result B.DE256":
    

/* end Populations */

/*
 * Disaggregators
 */

define "Administrative Gender Stratifier":
	HIE."By Administrative Gender Stratifier"

define "Age Stratifier":
	HIE."By Age Stratifier 2"

define "Geographic Region Stratifier":
	HIE."By Geographic Region Stratifier"

define "patientGroups Stratifier":
	HIE."patientGroups"

define "Stratification":
 HIE."By Administrative Gender Stratifier".code 
  + ':' + HIE."By Age Stratifier 2"
+ ':' + HIE."By Geographic Region Stratifier"
+ Combine(HIE.patientGroups, ':')


//need to add Diagnostic test used and anatomic site sampled 
Content: application/elm+xml