HIV with dynamics

Name: HIV with dynamics

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

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