maple_plt: Generate a period life table.

In vkontis/maple: Model averaged projections of life expectancy

Description

Generate a period life table.

Usage

maple_plt(death.rates, ax = NULL, check.conv = FALSE, full.table = FALSE)

Arguments

death.rates	A matrix of death rates, with 18 rows, one for each 5-year age group 0-4, ..., 80-84, 85+ and one column for each year.
ax	A matrix (in the same row/column format as death.rates) containing the number of years lived on average in the current age group, by those who die in each age group. For example, if all deaths in the age group 60-64 happened exactly at the middle of the age group, this would be equal to 2.5. If the number of columns ax is smaller than that of death.rates, the values in the last column are repeated for all missing columns. This is useful when calculating life tables for death rate projections; the ax values for the last year of data will be used to calculate the life tables for all future years. If this matrix is not supplied, the assumed numbers are 0.5 for the first age group (0-4 years) and 2.5 for all other age groups. The ax values for all but the first age group are calibrated as described in Notes, so not supplying ax values should not have a large impact on the resulting estimates.
check.conv	If TRUE, it will test that the iterative procedure to estimate ax (see Notes) has converged.
full.table	If TRUE, returns all the columns of the period life table, instead of just death rates, life expectancy and probability of dying.

Value

A period life table with death rates (mx), life expectancy (ex) and probability of dying (qx) for each age groupa and year.

Note

The ax for the open-ended age group 85+ is calculated using the Kannisto-Thatcher method [Thatcher et al, The survivor ratio method for estimating numbers at high ages, Demographic Research (6), 2002]. For age groups 5-9 to 80-84 the ax are calibrated using an iterative procedure described on p.47 of [Preston et al, Demography: measuring and modeling population processes, 2001].

Examples

data(maple.deaths)
data(maple.population)
data(maple.ax)
plt <- maple_plt(maple.deaths / maple.population, maple.ax)

vkontis/maple documentation built on July 15, 2019, 5:08 p.m.