ineq_H: ineq_H

View source: R/indices.R

ineq_HR Documentation

ineq_H

Description

Calculate a lifetable column for the quantity H, generally referred to as either the lifetable entropy Keyfitz (1977) or the elasticity of life expectancy Leser (1955).

Usage

ineq_H(age, dx, lx, ex, ax, check = TRUE, distribution_type = "rl")

Arguments

age

numeric. vector of lower age bounds.

dx

numeric. vector of the lifetable death distribution.

lx

numeric. vector of the lifetable survivorship.

ex

numeric. vector of remaining life expectancy.

ax

numeric. vector of the average time spent in the age interval of those dying within the interval.

check

logical. Shall we perform basic checks on input vectors? Default TRUE

Details

All input vectors must be the same length. Also, we recommend using input data from a life table by single year of age with a highest age group of at least age 110. If your data have a lower upper age bound, consider extrapolation methods, for instance a parametric Kannisto model (implemented in MortalityLaws::MortalityLaw). If your data are abridged, consider first smoothing over age, and calculating a life table by single year of age (for instance by smoothing with a pclm model in package ungroup or with a penalized B-spline approach in package MortalitySmooth).

References

\insertRef

keyfitz1977mortalityLifeIneq \insertRefleser1955variationsLifeIneq

See Also

MortalityLaws::MortalityLaw

ungroup::pclm

MortalitySmooth::Mort1Dsmooth

Examples


data(LT)
# A vector containing the conditional H values
H = ineq_H(age=LT$Age,dx=LT$dx,lx=LT$lx,ex=LT$ex,ax=LT$ax)
# The H from birth
H[1]
# The H conditional upon survival to age 10
H[11]

alysonvanraalte/LifeIneq documentation built on March 12, 2024, 1:42 p.m.