Learn R Programming

LifeTables (version 1.0)

mod.lt: Calculate a Model Life Table

Description

This function takes as arguments a value for child mortality, an indication of which child mortality indicator is supplied (defaults to 5q0), a possible value for 45q15, a possible target life expectancy to determine the level of mortality and the sex of the desired life table (defaults to "female"). The function selects the appropriate family (and level if a desired life expectancy is supplied or a value for alpha) and returns a life table. The resulting life table defaults to alpha=0.

Usage

mod.lt(child.value, child.mort=4, e0.target=NULL, adult.mort=NULL, sex="female", alpha=0)

Arguments

child.value
A numeric value for one of four child mortality measures.
child.mort
An integer (1-4) to indicate which child mortality indicator is being supplied (1 - 1m0; 2 - 5m0; 3 - 1q0; 4 - 5q0). Defaults to 5q0.
e0.target
The desired life expectancy for the life table. If no life expectancy is supplied the resulting life table defaults to alpha=0.
sex
"male" or "female" indicates the sex for the desired life table. Defaults to "female".
adult.mort
Optional. If supplied, the function uses both the child mortality measure and 45q15 to select the family. Otherwise, just the child mortality indicator is used.
alpha
If e0.target is not supplied, alpha defaults to 0. This can be any number with negative values producing lower mortality and positive values producing higher mortality.

Value

lt.out
The life table output from the function lt.mx including $e0, life expectancy at birth, $lt.5q0, the probability of death between birth and age 5, $lt.4q15, the probability of death between age 15 and 60, and $lt, the complete, resulting life table with columns for age, nax, nmx, nqx, npx, ndx, lx, nLx, Tx, and ex.
alpha
The alpha value which produced the table. This value is either user supplied or calculated from the user supplied e0.target.
sex
Sex of the life table.
family
An integer (1-5) to indicate the life table family/pattern.

References

S. Clark and D. Sharrow (2011) "Contemporary Model Life Tables for Developed Countries: An Application of Model-Based Clustering." Paper presented at the annual meeting of the Population Association of America. http://paa2011.princeton.edu/abstracts/111808

Human Mortality Database University of California, Berkeley (USA), and Max Planck Institute for Demographic Research (Germany). Available at www.mortality.org or www.humanmortality.de (data downloaded February 2015).

See Also

hmd.DA, alpha.e0, mortmod, lt.mx

Examples

Run this code
## Example input data from USA females 1955-59 using a desired e0
mod.lt(child.value=0.02769, child.mort=4, sex="female", 
  adult.mort=0.13461, e0.target=72.5) 
  
## The user can also supply an alpha value directly
mod.lt(child.value=0.02769, child.mort=4, sex="female", 
  adult.mort=0.13461, alpha=0.233) 

Run the code above in your browser using DataLab