HIV with dynamics

Name: HIV with dynamics

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

Contents

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