periodTransitionProbabilities {MortalityTables}

Return all period transition probabilities of the pension table

Description

Return all period transition probabilities of the pension table

Usage

periodTransitionProbabilities(object, ...)

## S4 method for signature 'pensionTable'
periodTransitionProbabilities(
  object,
  Period = 2017,
  ...,
  ages = NULL,
  OverallMortality = FALSE,
  retirement = NULL,
  invalids.retire = [e-mail],
  as.data.frame = TRUE
)

Arguments

object

A pension table object (instance of a pensionTable class)

...

Currently unused

Period

Observation year

ages

Desired age range (if NULL, the probabilities of the age range provided by the table will be returned), missing ages will be filled with NA

OverallMortality

Whether the overall mortality should be returned for actives, or the active mortality

retirement

Override the retirement transition probabilities of the pension table. Possible values are:

• Single age (describing a deterministric retirement at the given age)

• mortalityTable object: transition probabilities for retirement

invalids.retire

Override the pensionTable's invalids.retire flag, which indicates whether invalids retire like actives (i.e. same death probabilities after retirement) or stay invalid until death.

as.data.frame

Whether the return value should be a data.frame or an array containing transition matrices

Methods (by class)

• periodTransitionProbabilities(pensionTable): Return all transition probabilities of the pension table for the period Period

Examples

pensionTables.load("USA_PensionPlans")
# transitionProbabilities internally calls periodTransitionProbabilities
# if a Period is given:
transitionProbabilities(RP2014.male, Period = 1955)
periodTransitionProbabilities(RP2014.male, Period = 1955)
periodTransitionProbabilities(RP2014.male, Period = 2025)