TB simple model

Name: Simple TB

Description: Framework for a simple TB model, without vital dynamics or new cases

Compartments

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: Notified and 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: Successfully treated (comp)

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

Characteristics

Characteristic: TB burden

  • Code name: all_people
  • Value can be used for calibration
  • Includes:
    • Undiagnosed
    • Diagnosed
    • Notified and treated
    • Lost to follow-up
    • Successfully treated (comp)
  • Appears in the databook
  • Databook values will be used for model initialization
  • Description:
  • Data entry guidance:

Characteristic: Notified

  • Code name: all_dx
  • Value can be used for calibration
  • Includes:
    • Diagnosed
    • Notified and treated
    • Lost to follow-up
    • Successfully treated (comp)
  • Appears in the databook
  • Databook values will be used for model initialization
  • Description:
  • Data entry guidance:

Characteristic: In care

  • Code name: all_curr_linked
  • Value can be used for calibration
  • Includes:
    • Diagnosed
    • Notified and treated
    • Successfully treated (comp)
  • Appears in the databook
  • Databook values will be used for model initialization
  • Description:
  • Data entry guidance:

Characteristic: Treated

  • Code name: all_tx
  • Value can be used for calibration
  • Includes:
    • Notified and treated
    • Successfully treated (comp)
  • Appears in the databook
  • Databook values will be used for model initialization
  • Description:
  • Data entry guidance:

Characteristic: Successfully treated

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

Parameters

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
  • Units/format: probability
  • Value restrictions: 0-1.0000
  • Default value: None
  • Appears in the databook
  • 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: 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:
    • “Diagnosed” to “Notified and treated”
    • “Lost to follow-up” to “Notified and treated”
  • Default value: None
  • Does not appear in the databook
  • This parameter’s value is computed by a function: num_initiate/max(dx,num_initiate)
  • Depends on:
    • “Diagnosed”
    • “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:
    • “Notified and treated” to “Lost to follow-up”
    • “Successfully treated (comp)” to “Lost to follow-up”
  • Default value: None
  • Appears in the databook
  • Description:
  • Data entry guidance:

Parameter: Time after initiating treatment to treatment success (years)

  • Code name: succ_rate
  • Units/format: duration
  • Value restrictions: At least 0
  • Contributes to transitions from:
    • “Notified and treated” to “Successfully treated (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:
    • “Successfully treated (comp)” to “Notified and treated”
  • Default value: 0.16
  • Appears in the databook
  • Description:
  • Data entry guidance:

Interactions

Cascades

Cascade: TB care cascade

  • Description:
  • Stages:
    • TB burden
      • TB burden
    • Notified
      • Notified
    • In care
      • In care
    • Treated
      • Treated
    • Successfully treated
      • Successfully treated