HIV with dynamics¶

Name: HIV with dynamics

Description: Framework for an HIV model with vital dynamics and new infections

Contents¶

Compartments
Characteristics
Parameters
Interactions
Cascades

Compartments¶

Compartment: Source¶

Code name: source
Is source
Does not appear in the databook
Description:
Data entry guidance:

Compartment: Susceptible¶

Code name: sus
Does not appear in the databook
Description:
Data entry guidance:

Compartment: Undiagnosed¶

Code name: undx
Does not appear in the databook
Description:
Data entry guidance:

Compartment: Diagnosed¶

Code name: dx
Does not appear in the databook
Description:
Data entry guidance:

Compartment: Linked to care¶

Code name: linked
Does not appear in the databook
Description:
Data entry guidance:

Compartment: Treated¶

Code name: tx
Does not appear in the databook
Description:
Data entry guidance:

Compartment: Lost to follow-up¶

Code name: lost
Does not appear in the databook
Description:
Data entry guidance:

Compartment: Virally suppressed (comp)¶

Code name: vs
Does not appear in the databook
Description:
Data entry guidance:

Compartment: Dead (HIV/AIDS)¶

Code name: dead_hiv
Is sink
Does not appear in the databook
Description:
Data entry guidance:

Compartment: Dead (other)¶

Code name: dead_other
Is sink
Does not appear in the databook
Description:
Data entry guidance:

Characteristics¶

Characteristic: Population size¶

Code name: alive
Value can be used for calibration
Includes:
- Susceptible
- Undiagnosed
- Diagnosed
- Linked to care
- Treated
- Lost to follow-up
- Virally suppressed (comp)
Appears in the databook
Databook values will be used for model initialization
Description:
Data entry guidance:

Characteristic: All PLHIV¶

Code name: all_people
Value can be used for calibration
Includes:
- Undiagnosed
- Diagnosed
- Linked to care
- Treated
- Lost to follow-up
- Virally suppressed (comp)
Appears in the databook
Databook values will be used for model initialization
Description:
Data entry guidance:

Characteristic: Aware of their status¶

Code name: all_dx
Value can be used for calibration
Includes:
- Diagnosed
- Linked to care
- Treated
- Lost to follow-up
- Virally suppressed (comp)
Appears in the databook
Databook values will be used for model initialization
Description:
Data entry guidance:

Characteristic: Ever in care¶

Code name: all_ever_linked
Value can be used for calibration
Includes:
- Linked to care
- Treated
- Lost to follow-up
- Virally suppressed (comp)
Appears in the databook
Databook values will be used for model initialization
Description:
Data entry guidance:

Characteristic: Currently in care¶

Code name: all_curr_linked
Value can be used for calibration
Includes:
- Linked to care
- Treated
- Virally suppressed (comp)
Appears in the databook
Databook values will be used for model initialization
Description:
Data entry guidance:

Characteristic: Currently treated¶

Code name: all_tx
Value can be used for calibration
Includes:
- Treated
- Virally suppressed (comp)
Appears in the databook
Databook values will be used for model initialization
Description:
Data entry guidance:

Characteristic: Virally suppressed¶

Code name: all_vs
Value can be used for calibration
Includes:
- Virally suppressed (comp)
Appears in the databook
Databook values will be used for model initialization
Description:
Data entry guidance:

Parameters¶

Parameter: Annual number of births¶

Code name: birth_rate
Units/format: number
Value restrictions: At least 0
Contributes to transitions from:
- “Source” to “Susceptible”
Default value: None
Appears in the databook
Description:
Data entry guidance:

Parameter: Estimated number of new HIV infections annually¶

Code name: num_acq
Units/format: number
Value restrictions: At least 0
Default value: None
Appears in the databook
Used to compute:
- “Acquisition rate”
Description:
Data entry guidance:

Parameter: Acquisition rate¶

Code name: acq_rate
Units/format: probability
Value restrictions: 0-1.0000
Contributes to transitions from:
- “Susceptible” to “Undiagnosed”
Default value: None
Does not appear in the databook
This parameter’s value is computed by a function: num_acq/max(sus,num_acq)
Depends on:
- “Susceptible”
- “Estimated number of new HIV infections annually”
Description:
Data entry guidance:

Parameter: Annual number of tests done¶

Code name: num_test
Units/format: number
Value restrictions: At least 0
Default value: None
Appears in the databook
Used to compute:
- “Annual number tested positive”
Description:
Data entry guidance:

Parameter: Test yield¶

Code name: test_yield
Value can be used for calibration
Units/format: probability
Value restrictions: 0-1.0000
Default value: None
Does not appear in the databook
This parameter’s value is computed by a function: undx/(undx+sus)
Depends on:
- “Susceptible”
- “Undiagnosed”
Used to compute:
- “Annual number tested positive”
Description:
Data entry guidance:

Parameter: Annual number tested positive¶

Code name: pos_test
Units/format: number
Value restrictions: At least 0
Default value: None
Does not appear in the databook
This parameter’s value is computed by a function: num_test*test_yield
Depends on:
- “Annual number of tests done”
- “Test yield”
Used to compute:
- “Test sensitivity”
Description:
Data entry guidance:

Parameter: Test sensitivity¶

Code name: diag
Value can be used for calibration
Units/format: probability
Value restrictions: 0-1.0000
Contributes to transitions from:
- “Undiagnosed” to “Diagnosed”
Default value: None
Does not appear in the databook
This parameter’s value is computed by a function: pos_test/max(undx,pos_test)
Depends on:
- “Undiagnosed”
- “Annual number tested positive”
Description:
Data entry guidance:

Parameter: Average time taken to be linked to care (years)¶

Code name: link_time
Value can be used for calibration
Units/format: duration
Value restrictions: At least 0
Contributes to transitions from:
- “Diagnosed” to “Linked to care”
- “Lost to follow-up” to “Linked to care”
Default value: None
Appears in the databook
Description:
Data entry guidance:

Parameter: Annual number newly initiated onto treatment¶

Code name: num_initiate
Units/format: number
Value restrictions: At least 0
Default value: None
Appears in the databook
Used to compute:
- “Initiation rate”
Description:
Data entry guidance:

Parameter: Initiation rate¶

Code name: initiate
Value can be used for calibration
Units/format: probability
Value restrictions: 0-1.0000
Contributes to transitions from:
- “Linked to care” to “Treated”
Default value: None
Does not appear in the databook
This parameter’s value is computed by a function: num_initiate/max(linked,num_initiate)
Depends on:
- “Linked to care”
- “Annual number newly initiated onto treatment”
Description:
Data entry guidance:

Parameter: Loss-to-follow-up rate¶

Code name: loss
Value can be used for calibration
Units/format: probability
Value restrictions: 0-1.0000
Contributes to transitions from:
- “Linked to care” to “Lost to follow-up”
- “Treated” to “Lost to follow-up”
- “Virally suppressed (comp)” to “Lost to follow-up”
Default value: None
Appears in the databook
Description:
Data entry guidance:

Parameter: Time after initiating ART to achieve viral suppression (years)¶

Code name: supp_rate
Units/format: duration
Value restrictions: At least 0
Contributes to transitions from:
- “Treated” to “Virally suppressed (comp)”
Default value: 0.2
Appears in the databook
Description:
Data entry guidance:

Parameter: Treatment failure rate¶

Code name: fail_rate
Value can be used for calibration
Units/format: probability
Value restrictions: 0-1.0000
Contributes to transitions from:
- “Virally suppressed (comp)” to “Treated”
Default value: 0.16
Appears in the databook
Description:
Data entry guidance:

Parameter: Death rate for those with untreated HIV¶

Code name: death_hiv
Units/format: probability
Value restrictions: 0-1.0000
Contributes to transitions from:
- “Undiagnosed” to “Dead (HIV/AIDS)”
- “Diagnosed” to “Dead (HIV/AIDS)”
- “Linked to care” to “Dead (HIV/AIDS)”
- “Lost to follow-up” to “Dead (HIV/AIDS)”
Default value: 0.053
Appears in the databook
Description:
Data entry guidance:

Parameter: Death rate for those with on unsuppressive ART¶

Code name: death_hivtx
Units/format: probability
Value restrictions: 0-1.0000
Contributes to transitions from:
- “Treated” to “Dead (HIV/AIDS)”
Default value: 0.0258534
Appears in the databook
Description:
Data entry guidance:

Parameter: Death rate for those with on suppressive ART¶

Code name: death_hivvs
Units/format: probability
Value restrictions: 0-1.0000
Contributes to transitions from:
- “Virally suppressed (comp)” to “Dead (HIV/AIDS)”
Default value: 0.01219
Appears in the databook
Description:
Data entry guidance:

Parameter: Background mortality rate¶

Code name: death_other
Units/format: probability
Value restrictions: 0-1.0000
Contributes to transitions from:
- “Susceptible” to “Dead (other)”
- “Undiagnosed” to “Dead (other)”
- “Diagnosed” to “Dead (other)”
- “Linked to care” to “Dead (other)”
- “Treated” to “Dead (other)”
- “Lost to follow-up” to “Dead (other)”
- “Virally suppressed (comp)” to “Dead (other)”
Default value: 0.015
Appears in the databook
Description:
Data entry guidance:

Interactions¶

Cascades¶

Cascade: HIV care cascade¶

Description:
Stages:
- All PLHIV
  - All PLHIV
- Aware of their status
  - Aware of their status
- Ever in care
  - Ever in care
- Currently in care
  - Currently in care
- Currently treated
  - Currently treated
- Virally suppressed
  - Virally suppressed