accession: Calculate accession from a movements account.

Description Usage Arguments Details Value Examples

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

1
2
3
4
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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
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.