tfr {dembase}R Documentation

Calculate total fertility rates.

Description

Calculate total fertility rates from age-specific fertility rates.

Usage

tfr(object)

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

Arguments

object

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

Details

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.

Value

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

Examples

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)

[Package dembase version 0.0.0.119 Index]