demography (version 1.20)

hmd.mx: Read demographic data from the Human Mortality Database

Description

hmd.mx reads "Mx" (1x1) data from the Human Mortality Database (HMD http://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)

Arguments

country

Directory abbreviation from the HMD. For instance, Australia = "AUS". See below for other countries.

username

HMD username (case-sensitive)

password

HMD password (case-sensitive)

label

Character string giving name of country from which the data are taken.

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.

Details

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

The country codes (as at 23 December 2016) are as follows.

Australia AUS
Austria AUT
Belarus BLR
Belgium BEL
Bulgaria BGR
Canada CAN
Chile CHL
Czech Republic CZE
Denmark DNK
Estonia EST
Finland FIN
France -- France total population
FRATNP -- France civilian population
FRACNP Germany
-- Germany total population DEUTNP
-- West Germany DEUTFRG
-- East Germany DEUTGDR
Greece GRC
Hungary HUN
Iceland ISL
Ireland IRL
Israel ISR
Italy ITA
Japan JPN
Latvia LVA
Lithuania LTU
Luxembourg LUX
Netherlands NLD
New Zealand -- NZ total population
NZL_NP -- NZ Maori
NZL_MA -- NZ non-Maori
NZL_NM Norway
NOR Poland
POL Portugal
PRT Russia
RUS Slovakia
SVK Slovenia
SVN Spain
ESP Sweden
SWE Switzerland
CHE Taiwan
TWN United Kingdom
-- UK Total Population GBR_NP
-- England & Wales Total Population GBRTENW
-- England & Wales Civilian Population GBRCENW
-- Scotland GBR_SCO
-- Northern Ireland GBR_NIR
U.S.A. USA
Ukraine UKR

See Also

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

Examples

Run this code
# NOT RUN {
norway <- hmd.mx("NOR", username, password, "Norway")
summary(norway)
# }

Run the code above in your browser using DataCamp Workspace