avg_yll {yll}

Compute average years of life lost (YLL)

Description

avg_yll computes the average expected years of life lost (YLL), given the number of deaths, the average age of death and the standard life expectancy.

Usage

avg_yll(ndeaths, avg.age.death, life.expectancy, discount.rate = 0.03,
  beta = 0.04, modulation = 0, adjustment = 0.1658)

Arguments

ndeaths

Number of deaths (numeric).

avg.age.death

Average age of death (numeric).

life.expectancy

The interpolated life expectancy at that age. In other words, the expected remaining number of years to live (numeric).

discount.rate

Discount rate (default is set to 0.03) (numeric).

beta

Age-weighting constant (default is set to 0.04) (numeric).

modulation

Age-weighting modulation constant (= 0, no weighting; = 1, weighting, default is set to 0) (numeric).

adjustment

Adjustment constant for age-weights (default is set to 0.1658) (numeric).

Details

avg_yll computes the average expected years of life lost (YLL). The average YLL, which highlights premature causes of death and brings attention to preventable deaths is computed by dividing the standard YLL by the number of deaths (Aragon et al., 2008). The number of deaths, the average age of death and the standard life expectancy at least must be provided (as numeric vectors). Other arguments are provided to incorporate time discounting and age weighting.

Value

Since all inputs are numeric vectors, the output will be a numeric vector.

Author(s)

Antoine Soetewey [e-mail]

References

Aragon, T. J., Lichtensztajn, D. Y., Katcher, B. S., Reiter, R., & Katz, M. H. (2008). Calculating expected years of life lost for assessing local ethnic disparities in causes of premature death. BMC public health, 8(1), 116.

See Also

yll for the standard measure of years of life lost.

Examples

# For 100 deaths with an average age of death of 60 years
# and an expected remaining number of years to live of 20 years:

avg_yll(100, 60, 20)

# Without discounting:

avg_yll(100, 60, 20, discount.rate = 0)

## Not run: 
avg_yll("a", "b", "c") # arguments must be numeric
avg_yll(100) # avg.age.death and life.expectancy are missing,
# with no default
avg_yll(100, 60) # life.expectancy is missing,
# with no default

## End(Not run)