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]