HPVsim methods manuscript

This repository includes the code for reproducing the figures and analyses of the HPVsim methods manuscript. The original scientific paper describing HPVsim is available at http://paper.hpvsim.org. The recommended citation is:

HPVsim: An agent-based model of HPV transmission and cervical disease. Stuart RM, Cohen JC, Kerr CC, Abeysuriya RG, Zimmermann M, Rao DW, Boudreau MC, Klein DJ (2023).

This repository contains scripts for creating Figures 1, 4, 5, and 6. The code for Figure 2 is in a separate repository located here: https://github.com/hpvsim/hpvsim_india, and Figure 3 is a schematic.

Organization

The repository is organized as follows:

Running scripts

There are separate scripts for running and plotting each figure and the use cases. Specifically:

plot_fig1.py

• This script can be used to reproduce Figure 1.

plot_fig4.py

• This script can be used to reproduce Figure 4, the first figure in the results section.

plot_fig56.py

This script is used for running and plotting the results for the remaining two case studies in the results section.

• The sections run_simple, calibrate and plot_calibrate are legacy code that was used for validating the exercises - these sections can safely be ignored.
• The section run_sims runs the simulations and creates the plotting objects used for section 3.2 of the methods paper.
• The section plot_fig5_sims can be used to reproduce Figure 5.
• The section run_screening runs the simulations and creates the plotting objects used for section 3.3 of the methods paper.
• The section plot_fig6_screening can be used to reproduce Figure 6.

Additional utility scripts

• utils.py contains utilities for numerical calculations and creating plots.

Installation

If HPVsim is already installed (pip install hpvsim), the only other required dependency is seaborn. Alternatively, to install this code as a Python library, run pip install -e . (including the dot). This will install the latest version of each library (including HPVsim). You can also install with pip install -e .[frozen] to use the versions of libraries (including HPVsim) that were originally used for these analyses.

Usage

Run the desired analyses by running one of the scripts described above.

Further information

Further information on HPVsim is available here. If you have further questions or would like technical assistance, please reach out to us at info@hpvsim.org.