reaggregate_rates: Reaggregate age rates

In ageutils: Collection of Functions for Working with Age Intervals

Reaggregate age rates

Description

reaggregate_rates() converts rates over one interval range to another with optional weighting by a known population.

Usage

reaggregate_rates(...)

## Default S3 method:
reaggregate_rates(
  bounds,
  rates,
  new_bounds,
  ...,
  population_bounds = NULL,
  population_weights = NULL
)

Arguments

...	Further arguments passed to or from other methods.
bounds	⁠[numeric]⁠ The current boundaries in (strictly) increasing order. These correspond to the left hand side of the intervals (e.g. the closed side of [x, y). Double values are coerced to integer prior to categorisation.
rates	⁠[numeric]⁠ Vector of rates corresponding to the intervals defined by bounds.
new_bounds	⁠[numeric]⁠ The desired boundaries in (strictly) increasing order.
population_bounds	⁠[numeric]⁠ Interval boundaries for a known population weighting given by the population_weights argument.
population_weights	⁠[numeric]⁠ Population weightings corresponding to population_bounds. Used to weight the output across the desired intervals. If NULL (default) rates are divided proportional to the interval sizes.

Value

A data frame with 4 entries; interval, lower_bound, upper_bound and a corresponding rate.

Examples

reaggregate_rates(
    bounds = c(0, 5, 10),
    rates = c(0.1, 0.2 ,0.3),
    new_bounds = c(0, 2, 7, 10),
    population_bounds = c(0, 2, 5, 7, 10),
    population_weights = c(100, 200, 50, 150, 100)
)

ageutils documentation built on Sept. 11, 2024, 7:54 p.m.