Description Usage Arguments Details Value References See Also
Format data from the Human Mortality Database for use in the MortHump package
1 2 |
country |
|
year |
year (or birth cohort) for which the data is required |
dim |
dimension (period or cohort) |
xtra |
if TRUE extrapolates non-extinct cohorts |
sex |
sex for which the data is required ("females", "males" or "total") |
min |
age at which the data should be left-censored |
max |
age at which the data should be right-censored |
username |
personal HMD username for web access |
password |
personal HMD password for web access |
path |
path to the HMD folder for local access (containing the country folders) |
Two methods are available to access the data, either online or locally. Web access is advised to guarantee the most recent data, but can be slow. For a fast access, download first the complete zipped data files (choose "All countries for the HMD"), and then indicate the path to the general folder. The data collection method will be adapted depending if you indicate a path or a username and a password.
If you choose cohort data, you have the option of either work with the observed data, or to extrapolate the non-extinct cohorts. In the latter case, a variant of the Lee-Carter model is used to extrapolate the period mortality rates, which are used to identify cohort rates in the diagonal of the Lexis matrix. This option uses a variant of the Lee-Carter model, namely the functional model proposed by Hyndman and Ullah (2007) and available in the demography package.
The list of available countries and period coverage can be found on the HMD website.
This list is also accessible with the function getHMDcountries()
from the HMDHFDplus package.
The max
argument is designed to deal with either the presence of a mortality plateau among centenarians, which can be diffcult to capture with parametric models, or
a high level of stochasticity at old ages due to a small number of survivors. It is recommended to keep the value of max
above 80 or 90.
A data frame containing the following variables.
x
vector of ages.
d
vector of death counts.
n
vector of population exposures.
m
vector of death rates.
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.
This function makes use of the functions readHMD
and readHMDweb
from the HMDHFDplus package.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.