Population

The vivarium_public_health population package provides components to create and maintain a population of simulants over the course of a simulation. While the core vivarium framework supplies the population management machinery (the state table, population views, and simulant creation), the public health population package is used to model simulant demographics by sampling age, sex, and location from empirical data, aging simulants forward through time, managing which are alive or dead, and introducing new simulants through fertility.

The package is organized around three cooperating concerns:

1. Base population — initialization of demographic attributes from artifact data, deterministic aging on each time step, and age-based untracking.

2. Mortality — mortality rates with support for modeled and unmodeled cause-specific contributions.

3. Fertility — introduction of newborn simulants via deterministic, crude-birth-rate, or age-specific-rate models.