0.1.0 - ci-build
HIVFHIRIG, published by intellisoftkenya. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IntelliSOFT-Consulting/HIV-FHIR-IG/ and changes regularly. See the Directory of published versions
| Draft as of 2024-09-16 |
<Measure xmlns="http://hl7.org/fhir">
<id value="HIVIND27"/>
<meta>
<profile
value="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cv-measure-cqfm"/>
<profile
value="http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-shareablemeasure"/>
<profile
value="http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-publishablemeasure"/>
<profile
value="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/computable-measure-cqfm"/>
</meta>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Measure HIVIND27</b></p><a name="HIVIND27"> </a><a name="hcHIVIND27"> </a><a name="HIVIND27-en-US"> </a><p><b>org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis</b>: boolean</p><p><b>org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem</b>: <a href="Device-cqf-tooling.html">Device: manufacturer = CQFramework; type = tooling</a></p><p><b>org/fhir/us/cqfmeasures/StructureDefinition/cqfm-effectiveDataRequirements</b>: <a href="#hcHIVIND27/effective-data-requirements">EffectiveDataRequirements</a></p><p><b>url</b>: <a href="Measure-HIVIND27.html">Measure HIV.IND.27 People living with HIV on ART</a></p><p><b>version</b>: 0.1.0</p><p><b>name</b>: HIVIND27</p><p><b>title</b>: HIV.IND.27 People living with HIV on ART</p><p><b>status</b>: Draft</p><p><b>experimental</b>: true</p><p><b>date</b>: 2024-09-16</p><p><b>publisher</b>: intellisoftkenya</p><p><b>contact</b>: intellisoftkenya: <a href="https://www.intellisoftkenya.com/">https://www.intellisoftkenya.com/</a></p><p><b>description</b>: </p><div><p>Number and % of people on ART among all people living with HIV at the end of the reporting period</p>
</div><p><b>library</b>: <code>https://IntelliSOFT-Consulting.github.io/HIV-FHIR-IG/Library/HIVIND27Logic</code></p><p><b>scoring</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-scoring continuous-variable}">Continuous Variable</span></p><blockquote><p><b>group</b></p><blockquote><p><b>population</b></p><blockquote><p><b>id</b></p>HIV.IND.27.IP</blockquote><p><b>code</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-population initial-population}">Initial Population</span></p><p><b>description</b>: Initial Population</p><h3>Criteria</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td style="display: none">*</td><td>CQL</td><td>Initial Population</td></tr></table></blockquote><blockquote><p><b>population</b></p><blockquote><p><b>id</b></p>HIV.IND.27.MP</blockquote><p><b>org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis</b>: boolean</p><p><b>code</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-population measure-population}">Measure Population</span></p><p><b>description</b>: Measure Population</p><h3>Criteria</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td style="display: none">*</td><td>CQL</td><td>Measure Population</td></tr></table></blockquote><blockquote><p><b>population</b></p><blockquote><p><b>id</b></p>HIV.IND.27.MO</blockquote><p><b>org/fhir/us/cqfmeasures/StructureDefinition/cqfm-criteriaReference</b>: measure-population</p><p><b>org/fhir/us/cqfmeasures/StructureDefinition/cqfm-aggregateMethod</b>: count</p><p><b>code</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/measure-population measure-observation}">Measure Observation</span></p><p><b>description</b>: Measure Observation</p><h3>Criteria</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td style="display: none">*</td><td>CQL</td><td>Measure Observation</td></tr></table></blockquote><blockquote><p><b>stratifier</b></p><blockquote><p><b>id</b></p>HIV.IND.27.S</blockquote><h3>Criteria</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td style="display: none">*</td><td>CQL</td><td>Stratification</td></tr></table></blockquote></blockquote></div>
</text>
<contained>
<Library>
<id value="effective-data-requirements"/>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.A.DE20"/>
<display value="Male"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.A.DE19"/>
<display value="Female"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.A.DE22"/>
<display value="Transgender female"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.A.DE21"/>
<display value="Transgender male"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.A.DE23"/>
<display value="Other"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE49"/>
<display value="Key population member*"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system
value="http://terminology.hl7.org/CodeSystem/observation-category"/>
<code value="social-history"/>
<display value="Social History"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE116"/>
<display value="HIV-positive"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system
value="http://terminology.hl7.org/CodeSystem/condition-clinical"/>
<code value="active"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system
value="http://terminology.hl7.org/CodeSystem/condition-category"/>
<code value="encounter-diagnosis"/>
<display value="Encounter Diagnosis"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE115"/>
<display value="HIV status"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-directReferenceCode">
<valueCoding>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.H.DE47"/>
<display value="On ART"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIND27Logic"/>
</extension>
<extension url="name">
<valueString value="Initial Population"/>
</extension>
<extension url="statement">
<valueString
value="/*
* As defined by Member States
*/
define "Initial Population":
true"/>
</extension>
<extension url="displaySequence">
<valueInteger value="0"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="By Administrative Gender Stratifier"/>
</extension>
<extension url="statement">
<valueString
value="/* End of Age */
/*
@dataElement: HIV.A.DE18 - Gender
@activity: HIV.A6.1 Review sociodemographic data with client | HIV.A5 Create new client record
@description: Gender of the client
*/
/*
* By Administrative Gender of Patient Stratifier
* Need to expand codes
*/
define "By Administrative Gender Stratifier":
case
when Patient.gender = 'male' then Concepts."Male"
when Patient.gender = 'female' then Concepts."Female"
when Patient.gender = 'transgender female' then Concepts."Transgender female"
when Patient.gender = 'transgender male' then Concepts."Transgender male"
else Concepts."Other - HIV.A.DE23"
end"/>
</extension>
<extension url="displaySequence">
<valueInteger value="1"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="Age In Years"/>
</extension>
<extension url="statement">
<valueString
value="/* End of Visit date A.DE3 */
/*
@dataElement: HIV.A.DE17 - Age
@activity: HIV.A6.1 Review sociodemographic data with client | HIV.A5 Create new client record
@description: Calculated age (number of years) of the client based on date of birth
*/
define "Age In Years":
AgeInYearsAt(start of "Measurement Period")"/>
</extension>
<extension url="displaySequence">
<valueInteger value="2"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="By Age Stratifier"/>
</extension>
<extension url="statement">
<valueString
value="/*
* By Age Stratifiers
* (0–4, 5–9, 10–14, 15–19, 20–24, 25–29, 30–34, 35–39, 40–44, 45–49, 50+ years)
*
*/
define "By Age Stratifier":
case
when "Age In Years" <= 4 then '0-4'
when "Age In Years" <= 9 then '5-9'
when "Age In Years" <= 14 then '10–14'
when "Age In Years" <= 19 then '15–19'
when "Age In Years" <= 24 then '20–24'
when "Age In Years" <= 29 then '25–29'
when "Age In Years" <= 34 then '30–34'
when "Age In Years" <= 39 then '35–39'
when "Age In Years" <= 44 then '40–44'
when "Age In Years" <= 49 then '45–49'
when "Age In Years" >= 50 then '50+'
else null
end"/>
</extension>
<extension url="displaySequence">
<valueInteger value="3"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="By Geographic Region Stratifier"/>
</extension>
<extension url="statement">
<valueString
value="// Geographic Region
define "By Geographic Region Stratifier":
First(Patient.address A where A.use in { 'home' }).state"/>
</extension>
<extension url="displaySequence">
<valueInteger value="4"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVElements"/>
</extension>
<extension url="name">
<valueString value="Key population member type Observation"/>
</extension>
<extension url="statement">
<valueString
value="/* End of Key population member B.DE49 */
/*
@dataElement: HIV.B.DE50 - Key population member type
@activity: HIV.B6 Capture or update client history
@description: The type of key population that the client is included in
*/
define "Key population member type Observation":
[Observation: Concepts."Key population member - HIV.B.DE49"] O
where O.status in { 'final', 'amended', 'corrected' }
and exists(O.category OC where OC ~ ConceptsCustom."social-history")"/>
</extension>
<extension url="displaySequence">
<valueInteger value="5"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="Key population member type Observation"/>
</extension>
<extension url="statement">
<valueString
value="define "Key population member type Observation":
Elements."Key population member type Observation" O
where O.effective.toInterval() before end of "Measurement Period"
or O.issued before end of "Measurement Period""/>
</extension>
<extension url="displaySequence">
<valueInteger value="6"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="patientGroups"/>
</extension>
<extension url="statement">
<valueString
value="// Stratifier
define patientGroups:
"Key population member type Observation" O
return Combine(O.code.coding.code, ':')"/>
</extension>
<extension url="displaySequence">
<valueInteger value="7"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIND27Logic"/>
</extension>
<extension url="name">
<valueString value="Stratification"/>
</extension>
<extension url="statement">
<valueString
value="define "Stratification":
HIE."By Administrative Gender Stratifier".code
+ ':' + HIE."By Age Stratifier"
+ ':' + HIE."By Geographic Region Stratifier"
+ Combine(HIE.patientGroups, ':')"/>
</extension>
<extension url="displaySequence">
<valueInteger value="8"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVElements"/>
</extension>
<extension url="name">
<valueString value="HIV Status Positive Condition"/>
</extension>
<extension url="statement">
<valueString
value="define "HIV Status Positive Condition":
[Condition: Concepts."HIV-positive - HIV.B.DE116"] C
where C.clinicalStatus ~ ConceptsCustom."active"
and exists(C.category CC where CC ~ ConceptsCustom."encounter-diagnosis")
sort by start of onset.toInterval()"/>
</extension>
<extension url="displaySequence">
<valueInteger value="9"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="HIV Status Positive Condition"/>
</extension>
<extension url="statement">
<valueString
value="define "HIV Status Positive Condition":
Elements."HIV Status Positive Condition" C
where C.onset before end of "Measurement Period""/>
</extension>
<extension url="displaySequence">
<valueInteger value="10"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVElements"/>
</extension>
<extension url="name">
<valueString value="HIV Status Observation"/>
</extension>
<extension url="statement">
<valueString
value="/* End of HIV-inconclusive */
/*
@dataElement: HIV.B.DE115 - HIV status
@activity: HIV.B7 Test for HIV using testing algorithm
@description: HIV status reported after applying the national HIV testing algorithm. No single HIV test can provide an HIV-positive diagnosis.
*/
define "HIV Status Observation":
[Observation: Concepts."HIV status"] O
where O.status in { 'final', 'amended', 'corrected' }"/>
</extension>
<extension url="displaySequence">
<valueInteger value="11"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVElements"/>
</extension>
<extension url="name">
<valueString value="HIV Status Positive Observation"/>
</extension>
<extension url="statement">
<valueString
value="define "HIV Status Positive Observation":
"HIV Status Observation" O
where O.value ~ Concepts."HIV-positive - HIV.B.DE116"
sort by start of effective.toInterval()"/>
</extension>
<extension url="displaySequence">
<valueInteger value="12"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="HIV Status Positive Observation"/>
</extension>
<extension url="statement">
<valueString
value="define "HIV Status Positive Observation":
Elements."HIV Status Positive Observation" O
where O.issued before end of "Measurement Period"
or O.effective.toInterval() starts before end of "Measurement Period""/>
</extension>
<extension url="displaySequence">
<valueInteger value="13"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="Has HIV-positive Status"/>
</extension>
<extension url="statement">
<valueString
value="define "Has HIV-positive Status":
exists "HIV Status Positive Condition"
or exists "HIV Status Positive Observation""/>
</extension>
<extension url="displaySequence">
<valueInteger value="14"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVElements"/>
</extension>
<extension url="name">
<valueString value="On ART H.DE47"/>
</extension>
<extension url="statement">
<valueString
value="/* End of Refused stopped treatment */
/*
@dataElement: HIV.H.DE47 - On ART
@activity: HIV.H3 Record outreach and result
@description: Client is currently taking ART
*/
define "On ART H.DE47":
[MedicationStatement] MS
where exists(MS.reasonCode C where C ~ Concepts."On ART - HIV.H.DE47")
sort by start of effective.toInterval()"/>
</extension>
<extension url="displaySequence">
<valueInteger value="15"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="On ART H.DE47"/>
</extension>
<extension url="statement">
<valueString
value="/* End of Refused stopped treatment */
/*
@dataElement: HIV.H.DE47 - On ART
@activity: HIV.H3 Record outreach and result
@description: Client is currently taking ART
*/
define "On ART H.DE47":
exists(Elements."On ART H.DE47" ART
where ART.effective.toInterval() starts before end of "Measurement Period"
and (ART.effective.toInterval() ends after start of "Measurement Period")
)"/>
</extension>
<extension url="displaySequence">
<valueInteger value="16"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVElements"/>
</extension>
<extension url="name">
<valueString value="Death documented"/>
</extension>
<extension url="statement">
<valueString
value="/* End of Transferred out */
/*
@dataElement: HIV.H.DE44 - Death documented
@activity: HIV.H3 Record outreach and result
@description: People living with HIV previously on ART who are confirmed to have died from any cause
*/
define "Death documented":
case
when Patient.deceased is FHIR.boolean and Patient.deceased ~ true then Patient.meta.lastUpdated.value
when Patient.deceased is FHIR.dateTime then Patient.deceased as FHIR.dateTime
else null
end"/>
</extension>
<extension url="displaySequence">
<valueInteger value="17"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="Has death documented"/>
</extension>
<extension url="statement">
<valueString
value="/* End of Transferred out */
/*
@dataElement: HIV.H.DE44 - Death documented
@activity: HIV.H3 Record outreach and result
@description: People living with HIV previously on ART who are confirmed to have died from any cause
*/
define "Has death documented":
Elements."Death documented" before end of "Measurement Period""/>
</extension>
<extension url="displaySequence">
<valueInteger value="18"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVElements"/>
</extension>
<extension url="name">
<valueString value="Transferred out status"/>
</extension>
<extension url="statement">
<valueString
value="define "Transferred out status":
[EpisodeOfCare] EOC
where exists(EOC.type T where T ~ Concepts."On ART - HIV.H.DE47")
and EOC.status = 'finished'
return EOC.period"/>
</extension>
<extension url="displaySequence">
<valueInteger value="19"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVElements"/>
</extension>
<extension url="name">
<valueString value="Transferred out statusHistory"/>
</extension>
<extension url="statement">
<valueString
value="define "Transferred out statusHistory":
[EpisodeOfCare] EOC
where exists(EOC.type T where T ~ Concepts."On ART - HIV.H.DE47")
and (exists (
EOC.statusHistory H
where H.status = 'finished'
and H.period is not null))"/>
</extension>
<extension url="displaySequence">
<valueInteger value="20"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVElements"/>
</extension>
<extension url="name">
<valueString value="Transferred out"/>
</extension>
<extension url="statement">
<valueString
value="define "Transferred out":
flatten{"Transferred out status","Transferred out statusHistory".statusHistory.period}"/>
</extension>
<extension url="displaySequence">
<valueInteger value="21"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="Has transferred out"/>
</extension>
<extension url="statement">
<valueString
value="/* End of Lost to follow-up */
/*
@dataElement: HIV.H.DE43 - Transferred out
@activity: HIV.H3 Record outreach and result
@description: The client transferred to another facility
*/
define "Has transferred out":
exists(Elements."Transferred out" t where t ends during "Measurement Period")"/>
</extension>
<extension url="displaySequence">
<valueInteger value="22"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVConfig"/>
</extension>
<extension url="name">
<valueString value="LTFU Days"/>
</extension>
<extension url="statement">
<valueString value="define "LTFU Days":
28 days"/>
</extension>
<extension url="displaySequence">
<valueInteger value="23"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="Lost to follow-up"/>
</extension>
<extension url="statement">
<valueString
value="/* End of HIV treatment outcome */
/*
@dataElement: HIV.H.DE42 - Lost to follow-up
@activity: HIV.H3 Record outreach and result
@description: Twenty-eight days or more since last missed appointment
*/
define "Lost to follow-up":
Elements."On ART H.DE47" H
where H.effective starts before end of "Measurement Period"
and H.effective ends after start of "Measurement Period"
and not (H.effective ends after (end of "Measurement Period" - Config."LTFU Days"))"/>
</extension>
<extension url="displaySequence">
<valueInteger value="24"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIndicatorElements"/>
</extension>
<extension url="name">
<valueString value="Is lost to follow-up"/>
</extension>
<extension url="statement">
<valueString
value="define "Is lost to follow-up":
exists("Lost to follow-up")"/>
</extension>
<extension url="displaySequence">
<valueInteger value="25"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIND27Logic"/>
</extension>
<extension url="name">
<valueString value="Measure Population"/>
</extension>
<extension url="statement">
<valueString
value="/*
* Many indicator specifications in ANC and Immunization have context as patient.
* I believe these should be unfiltered to get all observations not just those related to a current patient
* Should discuss.
*/
define "Measure Population":
HIE."Has HIV-positive Status"
and HIE."On ART H.DE47"
and not HIE."Has death documented"
and not HIE."Has transferred out"
and not HIE."Is lost to follow-up""/>
</extension>
<extension url="displaySequence">
<valueInteger value="26"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToString"/>
</extension>
<extension url="statement">
<valueString
value="define function ToString(value AdministrativeGender): value.value"/>
</extension>
<extension url="displaySequence">
<valueInteger value="27"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToString"/>
</extension>
<extension url="statement">
<valueString
value="define function ToString(value string): value.value"/>
</extension>
<extension url="displaySequence">
<valueInteger value="28"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToString"/>
</extension>
<extension url="statement">
<valueString
value="define function ToString(value AddressUse): value.value"/>
</extension>
<extension url="displaySequence">
<valueInteger value="29"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToString"/>
</extension>
<extension url="statement">
<valueString
value="define function ToString(value ObservationStatus): value.value"/>
</extension>
<extension url="displaySequence">
<valueInteger value="30"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToConcept"/>
</extension>
<extension url="statement">
<valueString
value="define function ToConcept(concept FHIR.CodeableConcept):
if concept is null then
null
else
System.Concept {
codes: concept.coding C return ToCode(C),
display: concept.text.value
}"/>
</extension>
<extension url="displaySequence">
<valueInteger value="31"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToDateTime"/>
</extension>
<extension url="statement">
<valueString
value="define function ToDateTime(value instant): value.value"/>
</extension>
<extension url="displaySequence">
<valueInteger value="32"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToDateTime"/>
</extension>
<extension url="statement">
<valueString
value="define function ToDateTime(value dateTime): value.value"/>
</extension>
<extension url="displaySequence">
<valueInteger value="33"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToBoolean"/>
</extension>
<extension url="statement">
<valueString
value="define function ToBoolean(value boolean): value.value"/>
</extension>
<extension url="displaySequence">
<valueInteger value="34"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToString"/>
</extension>
<extension url="statement">
<valueString
value="define function ToString(value EpisodeOfCareStatus): value.value"/>
</extension>
<extension url="displaySequence">
<valueInteger value="35"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="FHIRHelpers"/>
</extension>
<extension url="name">
<valueString value="ToInterval"/>
</extension>
<extension url="statement">
<valueString
value="define function ToInterval(period FHIR.Period):
if period is null then
null
else
if period."start" is null then
Interval(period."start".value, period."end".value]
else
Interval[period."start".value, period."end".value]"/>
</extension>
<extension url="displaySequence">
<valueInteger value="36"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-logicDefinition">
<extension url="libraryName">
<valueString value="HIVIND27Logic"/>
</extension>
<extension url="name">
<valueString value="Measure Observation"/>
</extension>
<extension url="statement">
<valueString
value="/*
* NOTE: Modeled as a Continuous Variable measure because this is an estimated denominator proportion measure
*/
define function "Measure Observation"(Patient "Patient"):
1"/>
</extension>
<extension url="displaySequence">
<valueInteger value="37"/>
</extension>
</extension>
<name value="EffectiveDataRequirements"/>
<status value="active"/>
<type>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/library-type"/>
<code value="module-definition"/>
</coding>
</type>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library HIE"/>
<resource value="Library/HIVIndicatorElements"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library FHIRHelpers"/>
<resource value="Library/FHIRHelpers|4.0.1"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library Concepts"/>
<resource value="Library/HIVConcepts"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library FHIRHelpers"/>
<resource value="Library/FHIRHelpers|4.0.1"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library Elements"/>
<resource value="Library/HIVElements"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library Concepts"/>
<resource value="Library/HIVConcepts"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library FHIRHelpers"/>
<resource value="Library/FHIRHelpers|4.0.1"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library ConceptsCustom"/>
<resource value="Library/HIVConceptsCustom"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library WC"/>
<resource value="Library/WHOCommon"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library WC"/>
<resource value="Library/WHOCommon"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Library Config"/>
<resource value="Library/HIVConfig"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Code system HIVConcepts"/>
<resource value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Code system ObservationCategoryCodes"/>
<resource
value="http://terminology.hl7.org/CodeSystem/observation-category"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Code system ConditionClinicalStatusCodes"/>
<resource
value="http://terminology.hl7.org/CodeSystem/condition-clinical"/>
</relatedArtifact>
<relatedArtifact>
<type value="depends-on"/>
<display value="Code system ConditionCategoryCodes"/>
<resource
value="http://terminology.hl7.org/CodeSystem/condition-category"/>
</relatedArtifact>
<parameter>
<name value="Measurement Period"/>
<use value="in"/>
<min value="0"/>
<max value="1"/>
<type value="Period"/>
</parameter>
<parameter>
<name value="Initial Population"/>
<use value="out"/>
<min value="0"/>
<max value="1"/>
<type value="boolean"/>
</parameter>
<parameter>
<name value="Stratification"/>
<use value="out"/>
<min value="0"/>
<max value="1"/>
<type value="string"/>
</parameter>
<parameter>
<name value="Measure Population"/>
<use value="out"/>
<min value="0"/>
<max value="1"/>
<type value="boolean"/>
</parameter>
<dataRequirement>
<type value="Patient"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Patient"/>
</dataRequirement>
<dataRequirement>
<type value="Patient"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Patient"/>
<mustSupport value="use"/>
</dataRequirement>
<dataRequirement>
<type value="Observation"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Observation"/>
<mustSupport value="code"/>
<mustSupport value="status"/>
<mustSupport value="category"/>
<codeFilter>
<path value="code"/>
<code>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE49"/>
<display value="Key population member*"/>
</code>
</codeFilter>
</dataRequirement>
<dataRequirement>
<type value="Observation"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Observation"/>
<mustSupport value="code"/>
<mustSupport value="status"/>
<mustSupport value="category"/>
<mustSupport value="effective"/>
<mustSupport value="issued"/>
<codeFilter>
<path value="code"/>
<code>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE49"/>
<display value="Key population member*"/>
</code>
</codeFilter>
</dataRequirement>
<dataRequirement>
<type value="Observation"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Observation"/>
<mustSupport value="code"/>
<mustSupport value="status"/>
<mustSupport value="category"/>
<mustSupport value="effective"/>
<mustSupport value="issued"/>
<mustSupport value="code.coding"/>
<codeFilter>
<path value="code"/>
<code>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE49"/>
<display value="Key population member*"/>
</code>
</codeFilter>
</dataRequirement>
<dataRequirement>
<type value="Condition"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Condition"/>
<mustSupport value="code"/>
<mustSupport value="clinicalStatus"/>
<mustSupport value="category"/>
<codeFilter>
<path value="code"/>
<code>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE116"/>
<display value="HIV-positive"/>
</code>
</codeFilter>
</dataRequirement>
<dataRequirement>
<type value="Condition"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Condition"/>
<mustSupport value="code"/>
<mustSupport value="clinicalStatus"/>
<mustSupport value="category"/>
<mustSupport value="onset"/>
<codeFilter>
<path value="code"/>
<code>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE116"/>
<display value="HIV-positive"/>
</code>
</codeFilter>
</dataRequirement>
<dataRequirement>
<type value="Observation"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Observation"/>
<mustSupport value="code"/>
<mustSupport value="status"/>
<codeFilter>
<path value="code"/>
<code>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE115"/>
<display value="HIV status"/>
</code>
</codeFilter>
</dataRequirement>
<dataRequirement>
<type value="Observation"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Observation"/>
<mustSupport value="code"/>
<mustSupport value="status"/>
<mustSupport value="value"/>
<codeFilter>
<path value="code"/>
<code>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE115"/>
<display value="HIV status"/>
</code>
</codeFilter>
</dataRequirement>
<dataRequirement>
<type value="Observation"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Observation"/>
<mustSupport value="code"/>
<mustSupport value="status"/>
<mustSupport value="value"/>
<mustSupport value="issued"/>
<mustSupport value="effective"/>
<codeFilter>
<path value="code"/>
<code>
<system value="http://smart.who.int/hiv/CodeSystem/HIVConcepts"/>
<code value="HIV.B.DE115"/>
<display value="HIV status"/>
</code>
</codeFilter>
</dataRequirement>
<dataRequirement>
<type value="MedicationStatement"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/MedicationStatement"/>
<mustSupport value="reasonCode"/>
</dataRequirement>
<dataRequirement>
<type value="MedicationStatement"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/MedicationStatement"/>
<mustSupport value="reasonCode"/>
<mustSupport value="effective"/>
</dataRequirement>
<dataRequirement>
<type value="Patient"/>
<profile value="http://hl7.org/fhir/StructureDefinition/Patient"/>
</dataRequirement>
<dataRequirement>
<type value="EpisodeOfCare"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/EpisodeOfCare"/>
<mustSupport value="type"/>
<mustSupport value="status"/>
<mustSupport value="period"/>
</dataRequirement>
<dataRequirement>
<type value="EpisodeOfCare"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/EpisodeOfCare"/>
<mustSupport value="type"/>
<mustSupport value="statusHistory"/>
</dataRequirement>
<dataRequirement>
<type value="EpisodeOfCare"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/EpisodeOfCare"/>
<mustSupport value="type"/>
<mustSupport value="statusHistory"/>
</dataRequirement>
<dataRequirement>
<type value="EpisodeOfCare"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/EpisodeOfCare"/>
<mustSupport value="type"/>
<mustSupport value="statusHistory"/>
<mustSupport value="period"/>
</dataRequirement>
<dataRequirement>
<type value="MedicationStatement"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/MedicationStatement"/>
<mustSupport value="reasonCode"/>
<mustSupport value="effective"/>
</dataRequirement>
<dataRequirement>
<type value="EpisodeOfCare"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/EpisodeOfCare"/>
<mustSupport value="type"/>
<mustSupport value="status"/>
<mustSupport value="period"/>
</dataRequirement>
<dataRequirement>
<type value="MedicationStatement"/>
<profile
value="http://hl7.org/fhir/StructureDefinition/MedicationStatement"/>
<mustSupport value="reasonCode"/>
<mustSupport value="effective"/>
</dataRequirement>
</Library>
</contained>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis">
<valueCode value="boolean"/>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem">
<valueReference>🔗
<reference value="Device/cqf-tooling"/>
</valueReference>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-effectiveDataRequirements" id="effective-data-requirements">
<valueReference>
<reference value="#effective-data-requirements"/>
</valueReference>
</extension>
<url value="http://smart.who.int/hiv/Measure/HIVIND27"/>
<version value="0.1.0"/>
<name value="HIVIND27"/>
<title value="HIV.IND.27 People living with HIV on ART"/>
<status value="draft"/>
<experimental value="true"/>
<date value="2024-09-16"/>
<publisher value="intellisoftkenya"/>
<contact>
<name value="intellisoftkenya"/>
<telecom>
<system value="url"/>
<value value="https://www.intellisoftkenya.com/"/>
</telecom>
</contact>
<description
value="Number and % of people on ART among all people living with HIV at the end of the reporting period"/>
<library
value="https://IntelliSOFT-Consulting.github.io/HIV-FHIR-IG/Library/HIVIND27Logic"/>
<scoring>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/measure-scoring"/>
<code value="continuous-variable"/>
<display value="Continuous Variable"/>
</coding>
</scoring>
<group>
<population id="HIV.IND.27.IP">
<code>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/measure-population"/>
<code value="initial-population"/>
<display value="Initial Population"/>
</coding>
</code>
<description value="Initial Population"/>
<criteria>
<language value="text/cql"/>
<expression value="Initial Population"/>
</criteria>
</population>
<population id="HIV.IND.27.MP">
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis">
<valueCode value="boolean"/>
</extension>
<code>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/measure-population"/>
<code value="measure-population"/>
<display value="Measure Population"/>
</coding>
</code>
<description value="Measure Population"/>
<criteria>
<language value="text/cql"/>
<expression value="Measure Population"/>
</criteria>
</population>
<population id="HIV.IND.27.MO">
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-criteriaReference">
<valueString value="measure-population"/>
</extension>
<extension
url="http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-aggregateMethod">
<valueCode value="count"/>
</extension>
<code>
<coding>
<system
value="http://terminology.hl7.org/CodeSystem/measure-population"/>
<code value="measure-observation"/>
<display value="Measure Observation"/>
</coding>
</code>
<description value="Measure Observation"/>
<criteria>
<language value="text/cql"/>
<expression value="Measure Observation"/>
</criteria>
</population>
<stratifier id="HIV.IND.27.S">
<criteria>
<language value="text/cql"/>
<expression value="Stratification"/>
</criteria>
</stratifier>
</group>
</Measure>