site

📢 Latest update

The malariaverse site files and several supporting packages have had a significant update that changes the site-file structure and may break existing workflows. Please read Latest changes to malariaverse for what’s changed and how to keep reproducing existing work.

The site package supports malariaverse users to:

1. Access and download the latest country site-files 🌐 ➡️ 💻
2. Translate site file information into malariasimulation parameters 🌍 ➡️ 📉

⚠️ The site package streamlines model runs for specific geographies, but it also encapsulates many underlying assumptions, limitations, and uncertainties. Mis-specifying inputs or misinterpreting outputs from the complex malariasimulation model remains very possible. We strongly recommend consulting a member of the Imperial College modelling team before using these results for science, policy or decision-making purposes.

⚠️ While every effort has been made to ensure the reliability of the package and its outputs, the authors, contributors, and affiliated institutions accept no responsibility or liability for any errors, omissions, or consequences arising from their use. All results should be interpreted with caution and professional judgement.

Email: malariaverse@imperial.ac.uk

The site-file

The site-file is the file storing all of the sub nationally disaggregated information for a country. Components of the site-file include:

1. The Metadata, with high level information about the country, site-file version and spatial boundaries.
2. Historical Epidemiological Data with estimates of cases, deaths and parasite prevalence, the calibrated baseline EIR and bias-correction factors.
3. Population and Demography information.
4. Estimates of the Historical Intervention Use in the country.
5. Rainfalll and Seasonality data.
6. Information on the Mosquito Vectors.
7. Blood Disorders and Accessibility, with inherited blood-disorder frequencies and travel-time accessibility metrics.

Data inputs

Data inputs are linked throughout via the data buttons which link to all information on the data sources.

Accessing and downloading site-files

Please see this detailed guide for information on how to gain access and download site files. When using site, use should acknowledge and cite these sources.

Translating site-file information to malariasimulation parameters

If we have access a site file, then all we need to do to run the model is

1. Isolate a single site, this is a single sub-national unit within the country
2. Create the parameter list
3. Pass that to malariasimulation to run the simulation

# Pull information for a single sub-national unit from the site-file
site <- create_example_site(itn_use = 0)

# Convert site information to malariasimulation parameters
site_par <- site_parameters(
  interventions = site$interventions,
  demography = site$demography,
  vectors = site$vectors,
  seasonality = site$seasonality,
  eir = site$eir$eir,
  overrides = list(
    human_population = 1000
  ),
  start_year = 2000,
  end_year = 2002
)

# Run the model!
site_sim <- malariasimulation::run_simulation(
  timesteps = site_par$timesteps,
  parameters = site_par
)

Installation

You can install the development version of site from GitHub with:

# install.packages("pak")
pak::pak("mrc-ide/site")

Analytics

Visits to the live site are counted anonymously with GoatCounter — a cookieless, privacy-friendly analytics service that collects no personal data.