hmd: Read data from HMD and construct a mortality demogdata object

In demography: Forecasting Mortality, Fertility, Migration and Population Data

Read data from HMD and construct a mortality demogdata object

Description

hmd.mx reads "Mx" (1x1) data from the Human Mortality Database (HMD https://www.mortality.org) and constructs a demogdata object suitable for plotting using plot.demogdata and fitting an LC or BMS model using lca or an FDA model using fdm. hmd.pop reads "Population" (1x1) data from the HMD and constructs a demogdata object suitable for plotting using plot.demogdata. hmd.e0 reads life expectancy at birth from the HMD and returns the result as a ts object.

Usage

hmd.mx(country, username, password, label = country)

hmd.e0(country, username, password)

hmd.pop(country, username, password, label = country)

Arguments

country	Directory abbreviation from the HMD. For instance, Australia = "AUS".
username	HMD username (case-sensitive)
password	HMD password (case-sensitive)
label	Character string giving name of country from which the data are taken.

Details

In order to read the data, users are required to create their account via the HMD website (https://www.mortality.org), and obtain a valid username and password.

Value

hmd.mx returns an object of class demogdata with the following components:

year	Vector of years
age	Vector of ages
rate	A list containing one or more rate matrices with one age group per row and one column per year.
pop	A list of the same form as rate but containing population numbers instead of demographic rates.
type	Type of object: “mortality”, “fertility” or “migration”.
label	label

hmd.pop returns a similar object but without the rate component. hmd.e0 returns an object of class ts with columns male, female and total.

Author(s)

Rob J Hyndman

See Also

demogdata,read.demogdata,plot.demogdata, life.expectancy

Examples

## Not run: 
norway <- hmd.mx("NOR", username, password, "Norway")
summary(norway)

## End(Not run)

demography documentation built on Feb. 16, 2023, 7:02 p.m.