accession {dembase} | R Documentation

## 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

`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)

[Package dembase version 0.0.0.119 Index]