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-08-18 Computable Name: HIVIND73Logic

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

Generated Narrative: Library HIVIND73Logic

Related Artifacts

Depends OnLibrary HIChttp://smart.who.int/hiv/Library/HIVCommon|0.0.1
Depends OnLibrary WComWHOCommon

Parameters

Measurement Periodin01Period
Patientout01Patient
Initial Populationout01boolean
Numeratorout01boolean
Denominatorout01boolean

Contents

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
 */

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

// 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":
  true


/**
 * 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":
  true
    

/* end Populations */

Content not shown - (application/elm+xml, size = 14Kb )