pensionTable-class: Class pensionTable

In MortalityTables: A Framework for Various Types of Mortality / Life Tables

Class pensionTable

Description

Class pensionTable is the (virtual) base class for all pensions tables. It contains the name and some general values applying to all types of tables. In particular, it holds individual tables for each of the transition probabilities. Possible states are:

• active: healty, no pension, typically paying some kin of premium

• incapacity: disablity pension, in most cases permanent, not working, early pension

• retirement: old age pension, usually starting with a fixed age

• dead

  • Widow/widower pension

Correspondingly, the following transition probabilities can be given:

qxaa

death probability of actives (active -> dead)

ix

invalidity probability (active -> incapacity)

qix

death probability of invalid (invalid -> dead)

rx

reactivation probability (incapacity -> active)

apx

retirement probability (active -> retirement), typically 1 for a fixed age

qpx

death probability of retired (retired -> dead)

hx

probability of a widow at moment of death (dead -> widow), y(x) age difference

qxw

death probability of widows/widowers

qgx

death probability of total group (irrespective of state)

invalids.retire

Flag to indicate whether invalid persons retire like active (one death probability for all retirees) or whether they stay invalid until death with death probabilities specific to invalids.

Slots

qx

Death probability table of actives (derived from mortalityTable)

ix

Invalidity probability of actives (derived from mortalityTable)

qix

Death probability table of invalids (derived from mortalityTable)

rx

Reactivation probability of invalids (derived from mortalityTable)

apx

Retirement probability of actives (derived from mortalityTable)

qpx

Death probability of old age pensioners (derived from mortalityTable)

hx

Probability of a widow at the moment of death (derived from mortalityTable)

qwy

Death probability of widow(er)s (derived from mortality Table)

yx

Age difference of the widow to the deceased

qgx

Death probability of whole group (derived from mortalityTable), irrespective of state

invalids.retire

Whether invalids retire like actives or stay invalid until death

probs.arrange

A function that takes the individual transition probabilities of all the components and creates one object (a data.frame or a list) that will be returned by the method transitionProbabilities. The default arranges all tables without further modification. However, some pension tables (like the german Heubeck table) require the total mortality to be recalculated from the individual mortalities of actives and disabled. In this case, the function assigned to this slot will also calculate that total probability.

MortalityTables documentation built on Nov. 2, 2023, 5:52 p.m.