plot_rr_by_pm

Generates one or more plots showing relative risk estimates across PM2.5
levels. If multiple regions are present, plots are created per region and
for all regions combined. Optionally saves the output as a PDF.

internal

Tools for producing climate-health indicators and supporting
official statistics from health and climate data. Implements analytical
workflows for temperature-related mortality, wildfire smoke exposure,
air pollution, suicides related to extreme heat, malaria, and
diarrhoeal disease outcomes, with utilities for descriptive statistics, model
validation, attributable fraction and attributable number estimation,
relative risk estimation, minimum mortality temperature estimation,
and plotting for reporting. These six indicators are endorsed by
the United Nations Statistical Commission for inclusion in the
Global Set of Environment and Climate Change Statistics.
Implemented methods include distributed lag non-linear models (DLNM),
quasi-Poisson time-series regression, case-crossover analysis,
Bayesian spatio-temporal models using the Integrated Nested Laplace
Approximation ('INLA'), and multivariate meta-analysis for
sub-national estimates. The package is based on methods developed
in the Standards for Official Statistics on Climate-Health
Interactions (SOSCHI) project
<https://climate-health.officialstatistics.org>. For methodologies,
see Watkins et al. (2025) <doi:10.5281/zenodo.14865904>,
Brown et al. (2024) <doi:10.5281/zenodo.14052183>,
Pearce et al. (2024) <doi:10.5281/zenodo.14050224>,
Byukusenge et al. (2025) <doi:10.5281/zenodo.15585042>,
Dzakpa et al. (2025) <doi:10.5281/zenodo.14881886>, and
Dzakpa et al. (2025) <doi:10.5281/zenodo.14871506>.

Kenechi Omeke

climatehealth

Statistical Tools for Modelling Climate-Health Impacts

Charlie Browning

Etse Yawo Dzakpa

Gladin Jose

Matt Pearce

Ellie Watkins

Claire Hunt

Beatrice Byukusenge

Cassien Habyarimana

Venuste Nyagahakwa

Felix Scarbrough

Treesa Shaji

Bonnie Lewis

Maquines Odhiambo Sewe

Vijendra Ingole

Sean Lovell

Antony Brown

Euan Soutter

Gillian Flower

David Furley

Joe Panes

Charlotte Romaniuk

Milly Powell

Wellcome 

Office for National Statistics 

plot_rr_by_pm function

<dl><dt>data</dt>
<dd>A data frame with columns: pm_levels, relative_risk, ci_lower,
ci_upper, and region.</dd>
<dt>save_fig</dt>
<dd>Logical. If TRUE, saves the plot(s) as a PDF file in
output_dir. Defaults to FALSE.</dd>
<dt>output_dir</dt>
<dd>Character. Directory path where the PDF file will be
saved if save_fig is TRUE. Must exist. Defaults to NULL.</dd></dl>

Arguments

Plot relative risk by PM2.5 levels for all regions and individually — plot_rr_by_pm

<dl>

<dt>data</dt>
<dd>A data frame with columns: pm_levels, relative_risk, ci_lower,
ci_upper, and region.</dd>


<dt>save_fig</dt>
<dd>Logical. If TRUE, saves the plot(s) as a PDF file in
output_dir. Defaults to FALSE.</dd>


<dt>output_dir</dt>
<dd>Character. Directory path where the PDF file will be
saved if save_fig is TRUE. Must exist. Defaults to NULL.</dd>

</dl>

Plot relative risk by PM2.5 levels for all regions and individually

plot_rr_by_pm: Plot relative risk by PM2.5 levels for all regions and individually

Description

Usage

Value

Arguments