lyl_aggregated: Life Years Lost at one specific age using aggregated data.

View source: R/lyl_aggregated.R

lyl_aggregatedR Documentation

Life Years Lost at one specific age using aggregated data.

Description

lyl estimates differences in remaining life expectancy and Life Years Lost for two given life tables data and data0 after a specific age age_speficic and restrictied to a maximum theoretical age \tau.

Usage

lyl_aggregated(
  data,
  age,
  rates,
  surv,
  data0,
  age0,
  rates0,
  surv0,
  age_specific,
  censoring_label = "Alive",
  death_labels = "Dead",
  tau = 100
)

Arguments

data

A dataframe, where each raw represents an age, for the population of interest. The dataframe will contain information on age-specific mortality rates or survivial probability (if both parameters are provided, rates will be used).

age

Variable in data containing information on age.

rates

Variable in data containing information on age-specific mortality rates.

surv

Variable in data containing information on age-specific survival probability.

data0

A dataframe, where each raw represents an age, for the population of reference The dataframe will contain information on age-specific mortality rates or survivial probability (if both parameters are provided, rates will be used).

age0

Variable in data0 containing information on age.

rates0

Variable in data0 containing information on age-specific mortality rates.

surv0

Variable in data0 containing information on age-specific survival probability.

age_specific

Specific age at which the Life Years Lost have to be estimated.

censoring_label

Label for censoring status ("Alive" by default).

death_labels

Label for event status ("Dead" by default).

tau

Remaining life expectancy and Life Years Lost are estimated restrictied to a maximum theoretical age \tau (\tau=100 years by default).

Value

A list with class "lyl_aggregated" containing the following components:

  • data: Name of the dataset preovided in parameter data

  • data0: Name of the dataset preovided in parameter data0

  • LYL: Data frame with 1 observation and 3 variables: age which corresponds to age_spefific; and life_exp and life_exp0 which are the estimated remaining life expectancies at age age_specific years and before age tau years for the population provided in data and data0, respectively

  • tau: Maximum theoretical age \tau

  • age_specific: Specific age at which the Life Years Lost have been estimated

  • data_plot: A data frame in long format with 3 variables time, cause, and cip used to create a Figure of Life Years Lost with function plot.

  • censoring_label: Label for censoring status

  • death_labels: Label(s) for death status

  • type: Whether the estimation is at "age_specific" or "age_range"

References

  • Andersen PK. Life years lost among patients with a given disease. Statistics in Medicine. 2017;36(22):3573- 3582.

  • Andersen PK. Decomposition of number of life years lost according to causes of death. Statistics in Medicine. 2013;32(30):5278-5285.

  • Plana-Ripoll et al. lillies – An R package for the estimation of excess Life Years Lost among patients with a given disease or condition. PLoS ONE. 2020;15(3):e0228073.#'

See Also

  • lyl_aggregated_range for estimation of Life Years Lost for a range of different ages.

  • summary.lyl_aggregated to summarize objects obtained with function lyl_aggregated.

  • plot.lyl_aggregated to plot objects obtained with function lyl_aggregated.

Examples

# Load simulated data as example
data(aggreg_data)
data(pop_ref)

# Estimate remaining life expectancy and Life Years
# Lost after age 70 years and before age 90 years
lyl_summary_data70 <- lyl_aggregated(data = aggreg_data, age = age, rates = rate,
                                     data0 = pop_ref, age0 = age, surv0 = survival,
                                     age_specific = 70, tau = 90)

# Summarize and plot the data
summary(lyl_summary_data70)
plot(lyl_summary_data70)


lillies documentation built on Aug. 7, 2023, 5:09 p.m.