accession: Calculate accession from a movements account.

In StatisticsNZ/dembase: Analysing Cross-Classified Data about Populations

Description

Calculations accession from a movements account with an age dimension. Accession is the number of people reaching a given age during a given period. For instance, accession to age 65 during 2019 is the number of people turning 65 during 2019.

Usage

accession(object, births = TRUE, openAge = FALSE)

## S4 method for signature 'Movements'
accession(object, births = TRUE, openAge = FALSE)

Arguments

object	A Movements account.
births	If TRUE (the default), births are included in the answer; if FALSE, they are not.
openAge	If TRUE, the equivalent of accession is calculated for the oldest (open) age group. Defaults to FALSE.

Details

Births can be considered as accession to age 0. By default, the return value to accession includess age 0. If the account does not in fact include births, then accession to age 0 is set to 0.

When openAge is TRUE, the analogue of accession is calculated for the oldest age group: the number of people reaching the next oldest age group. This differs from accession for other age groups since the oldest age group potentially contains many cohorts.

Value

An object of class Counts.

Examples

population <- Counts(array(c(10, 15, 13, 16),
                           dim = c(2, 2),
                           dimnames = list(age = c("0-29", "30+"),
                                           time = c(1970, 2000))))
births <- Counts(array(13,
                       dim = c(1, 1),
                       dimnames = list(age = "30+",
                                       time = "1971-2000")))
deaths <- Counts(array(c(0, 9),
                       dim = c(2, 1),
                       dimnames = list(age = c("0-29", "30+"),
                                       time = c("1971-2000"))))
account <- Movements(population = population,
                     births = births,
                     exits = list(deaths = deaths))

accession(account)
accession(account, births = FALSE)
accession(account, openAge = TRUE)

StatisticsNZ/dembase documentation built on Dec. 25, 2021, 4:49 p.m.