Description Usage Format Value Methods References

Class providing an interface for a generic VA product object.
This class shouldn't be instantiated but used as base class for
implementing products with contract riders such as GMAB, GMIB, etc.
It supports a simple state-dependent fee structure with a single barrier.

See **References** for a description of variable annuities life
insurance products, their guarantees and fee structures.

1 |

`R6Class`

object.

Object of `R6Class`

`new`

Constructor method with arguments:

`payoff`

`payoff`

object of the GMAB guarantee`t0`

`timeDate`

object with the issue date of the contract`t`

`timeDate`

object with the end date of the accumulation period`t1`

`timeDate`

object with the end date of the life benefit payment`age`

`numeric`

positive scalar with the age of the policyholder`fee`

`constant_parameters`

object with the fee`barrier`

`numeric`

positive scalar with the state-dependent fee barrier`penalty`

`penalty_class`

object with the penalty

`get_times`

get method for the product time-line. Returns a

`timeDate`

object`get_age`

get method for the age of the insured

`set_age`

set method for the age of the insured

`get_barrier`

get method for the state-dependent fee barrier. Returns a positive scalar with the barrier

`set_barrier`

set method for the state-dependent fee barrier. Argument must be a positive scalar.

`set_penalty_object`

the argument

`penalty`

is a`penalty_class`

object which is stored in a private field.`get_penalty_object`

gets the

`penalty_class`

object.`set_penalty`

set method for the penalty applied in case of surrender. The argument must be a scalar between 0 and 1.

`get_penalty`

get method for the surrender penalties. It can be a scalar between 0 and 1 in case the penalty is constant or a numeric vector in case the penalty varies with time.

`set_fee`

set method for the contract fee. The argument is a

`constant_parameters`

object with the fee.`set_payoff`

set method for the

`payoff_guarantee`

object.`survival_benefit_times`

returns a

`numeric`

vector with the survival benefit time indexes.`surrender_times`

returns a

`numeric`

vector with the surrender time indexes. Takes as argument a string with the frequency of the decision if surrendering the contract, e.g. "3m" corresponds to a surrender decision taken every 3 months.`times_in_yrs`

returns the product time-line in fraction of year

`cash_flows`

returns a

`numeric`

vector with the cash flows of the product. It takes as argument`spot_values`

a`numeric`

vector which holds the values of the underlying fund this method will calculate the cash flows from`survival_benefit`

Returns a numeric scalar corresponding to the survival benefit. The arguments are

`spot_values`

vector which holds the values of the underlying fund and`t`

the time index of the survival benefit. The function will return 0 if there's no survival benefit at the specified time`get_premium`

Returns the premium as non negative scalar

[BMOP2011] Bacinello A.R., Millossovich P., Olivieri A., Pitacco E., "Variable annuities: a unifying valuation approach." In: Insurance: Mathematics and Economics 49 (2011), pp. 285-297.

[BHM2014] Bernard C., Hardy M. and Mackay A. "State-dependent fees for variable annuity guarantees." In: Astin Bulletin 44 (2014), pp. 559-585.

IvanZoccolan/valuer documentation built on May 7, 2019, 6:45 a.m.

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.