bayesPop (version 6.0-1)

age.specific.migration: Reconstruction of Sex- and Age-specific Migration

Description

Reconstructs the sex- and age-specific net migration datasets out of the total net migration using a residual method.

Usage

age.specific.migration(wpp.year = 2015, years = seq(1955, 2100, by = 5),  countries = NULL, smooth = TRUE, write.to.disk = FALSE,  directory = getwd(), file.prefix = "migration", verbose = TRUE)

Arguments

wpp.year

Integer determining which wpp package should be used to get the necessary data from. That package is required to have a dataset on total net migration (called migration). Currently, only the wpp2015 package contains it (see Details).

years

Array of years that the reconstruction should be made for. This should be a subset of years for which the total net migration is available.

countries

Numerical country codes to do the reconstruction for. By default it is performed on all countries included in the migration dataset where aggregations are excluded.

smooth

Logical controlling if smoothing of the reconstructed curves is required. Due to rounding issues the residual method often yields unrealistic zig-zags on migration curves by age. Smoothing usually improves their look.

write.to.disk

If TRUE results are written to disk.

directory

Directory where to write the results if write.to.disk is TRUE.

file.prefix

If write.to.disk is TRUE results are written into two text files with this prefix, a letter “M” and “F” determining the sex, and concluded by the “.txt” suffix. By default “migrationM.txt” and “migrationF.txt”.

verbose

Logical controlling the amount of output messages.

Value

List of two data frames (male and female), each having the same structure as migrationM.

Warning

Due to rounding issues and slight differences in the methodology, this function does not reproduce the unpublished UN datasets exactly. It is only an approximation! Especially, the first age groups might be more off than other ages.

Details

Unlike in wpp2012, for the newest release of the WPP, the wpp2015, the UN Population Division did not publish the sex- and age-specific net migration counts, only the totals. However, since the sex- and age-schedules are needed for population projections, this function tries to reconstruct those missing datasets. It uses the published population projections by age and sex, fertility and mortality projections from the wpp package. It computes the population projection without migration and sets the residual to the published population projection as the net migration. Such numbers are then scaled so that the sum over sexes and ages correspond to the total migration count.

If smooth is TRUE a smoothing procedure is performed over ages where necessary. Also, for simplicity, we set migration of old ages (90+) to zero. Both is done before the scaling.

See Also

pop.predict, migration migrationM

Examples

## Not run: 
# asmig <- age.specific.migration()
# head(asmig$male)
# head(asmig$female)## End(Not run)