tfr: Calculate total fertility rates.
In StatisticsNZ/dembase: Analysing Cross-Classified Data about Populations

Description Usage Arguments Details Value Examples

Calculate total fertility rates from age-specific fertility rates.

tfr(object)

## S4 method for signature 'Values'
tfr(object)

object

An object of class Values. object must have a dimension with dimtype "age".

The total fertility rate (TFR) is a summary measure commonly used by demographers. It is the number of births that the average woman have if she survived to the end the reproductive ages, and if current age-specific fertility rates were to persist indefinitely.

object will typically contain dimensions other than age, such as time or region. Separate total fertility rates are calculated for each combination of these other variables.

The calculations are done aggregating the "age", and, if present, "sex" and Lexis triangle dimensions. See dimtypes for more on age, sex, and Lexis triangle dimtypes.) If object containsa "sex" dimension, this is assumed to be the sex of the child, not the parent. Total fertility rates do not distinguish female and male births.

If object has iterations, to capture uncertainty, so will the return value.

An object of class Values, with no "age", "sex", or Lexis triangle dimensions, or a numeric vector.

births <- demdata::nz.births.reg
popn <- demdata::nz.popn.reg
births <- Counts(births, dimscales = c(year = "Intervals"))
## use mid-year population to approximate person-years lived
## over year
popn <- Counts(popn, dimscales = c(year = "Intervals"))
females <- subarray(popn, sex == "Female")
fert.rates <- births / females
tfr(fert.rates)