T4 - People, populations, and networks

This tutorial gives a brief introduction to people, populations, and contact layers.

Click here to open an interactive version of this notebook.

Demographic data

HPVsim includes pre-downloaded demographic data for almost all countries, including:

  • Population sizes from 1950-2100 from the UN’s World Population Projections;

  • Birth rates from 1950-2100 from the World Bank;

  • Age- and sex-specific mortality rates from 1950-2100 from the UN’s World Population Projections.

As we saw in Tutorial 1, you can load these data simply by using the location parameter. You can show a list of all available locations with hpv.data.show_locations().

People and contact network layers

Agents in HPVsim are contained in an object called People, which contains all of the agents’ properties, as well as methods for changing them from one state to another (e.g., from susceptible to infected).

HPV transmits via sexual contact, and in HPVsim this is represented by sexual networks that allow agents to interact with one another. For the moment, HPVsim only models heterosexual partnerships. The sexual contact networks in HPVsim can have multiple contact layers, with each layer having different properties that characterize sexual contact, including the duration of the contact, age mixing preferences of partners, etc. HPVsim comes with two options for the sexual network:

  • The random option has a single contact layer. The number of partners that each agent has is Poisson distributed with a mean of 1.

  • The default option has 3 contact layers, representing marital, casual, and one-off partnership types.