fccp_net0: Cohort Component Population Projection Model based on a...

In gjabel/demoproj: Demographic Projection Models

Description

A cohort component projection model based on a closed female population,

N(t+5) = L[t, t+1] ≤ft( N(t) + \frac{1}{2} M[t, t+1] \right) + \frac{1}{2} M[t, t+1]

where the Leslie matrix, eqnL, is created given user defined age specific fertility and survivorship rates.

Usage

fccp_net0(n = NULL, x = NULL, p = NULL, Nx = NULL, sx = NULL,
  fx = NULL, sn = NULL, sex_ratio = 1/(1 + 1.05), Mx = NULL,
  tidy_output = TRUE, age_lab = x, gender_lab = "Female", ...)

fccp_net(n = NULL, x = NULL, p = NULL, Nx = NULL, sx = NULL,
  fx = NULL, sn = NULL, sex_ratio = 1/(1 + 1.05), Mx = NULL,
  tidy_output = TRUE, age_lab = x, gender_lab = "Female", ...)

Arguments

n	Numeric value for the number of projection steps.
x	Vector containing a character string of age group labels.
p	Numeric value for step size of the population projection.
Nx	Vector containing numeric values of the initial female population size in each age group (x).
sx, fx, Mx	Vectors containing numeric values of the age specific female survival and fertility rates and net migration counts. If fccp_net0 is used a single vector is required. If fccp_net is used a matrix of period specific rates (or counts for net migration) is required, where rows represent age groups and columns future periods. If a single vector is passed to fccp_net a matrix based on constant assumptions in all future rates and net migration counts will be constructed.
sn, sex_ratio	Numeric value of the survivorship of new-born female babies from birth to the end of the interval and the sex ratio at birth of new-born babies. If fccp_net0 is used a single value is required. If fccp_net is used a vector of period specific values is required. If a single value is passed to fccp_net a vector based on constant assumptions in all future rates will be constructed.
tidy_output	Logical value to indicate if projection output should be in a tidy data format (TRUE, the default) or as a matrix where rows represent age and gender groups and columns the projection year.
age_lab, gender_lab	Vector containing a character string of age and gender group labels. Only used if projection output is in a tidy data format. See tidy_pp for more details.
...	Additional arguments passed to tidy_pp to build a tidy data frame (if chosen from tidy_output).

Value

Projected populations by age and gender for n future steps, given the fertility and survivorship rates and net migration counts. Depending on the tidy_output value the projections will be returned as either a matrix or a tibble. Both versions contain the initial population sizes given in Nx.

fccp_net0 produces population projections based strictly on constant future rates.

fccp_net produces population projections based non-constant future rates.

Examples

df0 <- sweden1993

# matrix output
fccp_net0(n = 5, x = df0$x, p = 5, Nx = df0$Nx_f,
          sx = df0$sx_f,
          fx = df0$fx, sn = df0$Lx_f[1]/(5*100000),
          Mx = df0$Mx_f,
          tidy_output = FALSE)

# tidy data frame output
fccp_net0(n = 5, x = df0$x, p = 5, Nx = df0$Nx_f,
          sx = df0$sx_f,
          fx = df0$fx, sn = df0$Lx_f[1]/(5*100000),
          Mx = df0$Mx_f,
          year0 = 1993, age_lab = df0$age)

# setting up non-constant future net migrant counts
MM <- matrix(df0$Mx_f, nrow = length(df0$Mx_f), ncol = 5)
MM <- sweep(MM, 2, seq(from = 1, to = 1.5, length = 5), "*")
# net migration increase
colSums(MM)
# run projection with increasing net migration, fx and sx remains constant
fccp_net(n = 5, x = df0$x, p = 5, Nx = df0$Nx_f,
         sx = df0$sx_f,
         fx = df0$fx, sn = df0$Lx_f[1]/(5*100000),
         Mx = MM,
         tidy_output = FALSE)

gjabel/demoproj documentation built on May 17, 2019, 6:01 a.m.