get_pif: Get potential impact fraction (PIF)

In healthiar: Quantifying and Monetizing Health Impacts Attributable to Exposure

Get potential impact fraction (PIF)

Description

This function calculates the potential impact fraction of a health outcome due to exposure to an environmental stressor

Usage

get_pif(rr_at_exp_1, rr_at_exp_2, prop_pop_exp_1, prop_pop_exp_2)

Arguments

rr_at_exp_1	Numerical value showing the risk estimate of the concentration response function for a specific concentration in the scenario 1. The population attributable fraction is normally calculated using the risk estimate that refers to the concentration that reflects the population exposure and the cut-off. This risk estimate is obtained after re-scaling from the epidemiological study with a particular increment (e.g. for PM2.5 10 or 5 ug/m3) to the aimed concentration.
rr_at_exp_2	Numerical value showing the risk estimate of the concentration response function for a specific concentration in the scenario 2. The population attributable fraction is normally calculated using the risk estimate that refers to the concentration that reflects the population exposure and the cut-off. This risk estimate is obtained after re-scaling from the epidemiological study with a particular increment (e.g. for PM2.5 10 or 5 ug/m3) to the aimed concentration.
prop_pop_exp_1	Numerical value showing the fraction ([0,1]) of population exposed to the environmental stressor in the scenario 1. Per default = 1 (i.e. 100% of population is exposed).
prop_pop_exp_2	Numerical value showing the fraction ([0,1]) of population exposed to the environmental stressor in the scenario 1. Per default = 1 (i.e. 100% of population is exposed).

Details

Methodology

This function is internally used inside the healthiar function compare(). The potential impact fraction (PIF) is calculated as described in \insertCiteWHO2003_report;textualhealthiar, \insertCiteMurray2003_spbm;textualhealthiar and \insertCiteAskari2020_ijph;textualhealthiar.

Detailed information about the methodology (including equations) is available in the package vignette. More specifically, see chapters:

• comparison of two health scenarios

Value

This function returns the potential impact fraction as a numeric value.

Author(s)

Alberto Castro & Axel Luyten

References

\insertAllCited

See Also

• Alternative: compare

Examples

# Goal: calculate the potential impact fraction (PIF)
results <- get_pif(
  rr_at_exp_1 = 1.043879,
  rr_at_exp_2 = 1.011217,
  prop_pop_exp_1 = 1,
  prop_pop_exp_2 = 1
)
print(results)

healthiar documentation built on March 12, 2026, 5:07 p.m.