hadwiger: Hadwiger Fertility Model Schedule.

Description Usage Arguments Value Author(s) References See Also Examples

Description

Provides a scaled Hadwiger fertility schedule,

f(x) = \frac{H}{T √{π}} ≤ft( \frac{T}{x - d} \right) ^ \frac{3}{2} \exp ≤ft\{-H^2 ≤ft(\frac{T}{x-d} \frac{x-d}{T} -2\right) \right\}

for a given set of parameter values and sequence of ages.

Usage

1
2
3
hadwiger(tfr = NULL, x = seq(from = 0, to = 100, by = 1), H = NULL,
  T = NULL, d = NULL, start_fertage = 15, width_fertage = 35,
  scaled = TRUE)

Arguments

tfr

Numeric value for total fertitliy rate of the returned age schedule.

x

Vector for the sequence of ages.

H

Numeric value for the H parameter in the equation above.

T

Numeric value for the T parameter in the equation above.

d

Numeric value for the d parameter in the equation above.

start_fertage

Numeric value for the start of the fertility age range.

width_fertage

Numeric value for the width of the fertility age range.

scaled

Boolean value to return age specific fertility rates that scale to sum to tfr or not. Default TRUE.

Value

Returns the f(x) values from the Hadwiger schedule of age specific fertility, later refined by Gilje and Yntema. The age range for the calculation can take any sequence of positive numbers, such as ages in single or 5-year intervals. The function is primarily intended for use in decomposing a total fertility rate into an age-specific values.

The parameters relate to the shape of the schedule (H, T and d). The shape parameters have no demographic interpretion.

The arguments for the start and width of the fertility age range (start_fertage, width_fertage) are used to select where the distribution is applied over the range of ages given in x.

The adapted version in this function, to allow scaling to a known TFR, was based on IUSSP Demographic Models online section (see http://papp.iussp.org/sessions/papp103_s03/PAPP103_s03_040_090.html for more details).

Author(s)

Guy J. Abel

References

Gilje E. and Yntema L. (1970). 'The shifted Hadwiger fertility function'. Working Paper No IO70/14. Oslo: Central Bureau of Statistics of Norway.

Hadwiger H. (1940). Eine analytische Reprodutionsfunktion fur biologische Gesamtheiten. Skandinavisk Aktuarietidskrift 23(101-113)

See Also

.

Examples

1
2
3
4
5
6
7
8
#single year
f0 <- hadwiger(tfr = 1.8, H = 4, T = 28, d = 2)
plot(f0, type = "l")

#five year
f1 <- hadwiger(tfr = 5.8, x = seq(from = 0, to = 100, by = 5), H = 3, T = 26, d = 2, width_fertage = 40)
plot(f1, type = "l")
sum(f1) * 5

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