tlo.methods.hiv_tb_calibration module¶
Deviance measure
This module runs at the end of a simulation and calculates a weighted deviance measure for a given set of parameters using outputs from the demography (deaths), HIV and TB modules
- class Deviance(name=None, resourcefilepath=None)[source]¶
This module reads in logged outputs from HIV, TB and demography and compares them with reported data a deviance measure is calculated and returned on simulation end
Bases:
tlo.core.Module
Class attributes:
INIT_DEPENDENCIES : {‘Tb’, ‘Hiv’, ‘Demography’}
METADATA : {}
Functions (defined or overridden in class Deviance):
- __init__(name=None, resourcefilepath=None)[source]¶
Construct a new disease module ready to be included in a simulation.
Initialises an empty parameters dictionary and module-specific random number generator.
- Parameters
name – the name to use for this module. Defaults to the concrete subclass’ name.
- read_parameters(data_folder)[source]¶
Read parameter values from file, if required.
Must be implemented by subclasses.
- Parameters
data_folder – path of a folder supplied to the Simulation containing data files. Typically modules would read a particular file within here.
- initialise_population(population)[source]¶
Set our property values for the initial population.
Must be implemented by subclasses.
This method is called by the simulation when creating the initial population, and is responsible for assigning initial values, for every individual, of those properties ‘owned’ by this module, i.e. those declared in its PROPERTIES dictionary.
TODO: We probably need to declare somehow which properties we ‘read’ here, so the simulation knows what order to initialise modules in!
- Parameters
population – the population of individuals
- initialise_simulation(sim)[source]¶
Get ready for simulation start.
Must be implemented by subclasses.
This method is called just before the main simulation loop begins, and after all modules have read their parameters and the initial population has been created. It is a good place to add initial events to the event queue.
- on_birth(mother_id, child_id)[source]¶
Initialise our properties for a newborn individual.
Must be implemented by subclasses.
This is called by the simulation whenever a new person is born.
- Parameters
mother – the mother for this child (can be -1 if the mother is not identified).
child – the new child