MortalityTables (version 2.0)

periodTransitionProbabilities: 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 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)

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

Examples

# NOT RUN {
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)

# }