Calculate accession from a movements account.

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

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)