am: Life Annuities for a group
In DetLifeInsurance: Life Insurance Premium and Reserves Valuation

Description Usage Arguments Value Examples

Calculates the present value of a life annuity for a group.

am(
  x,
  h,
  n,
  k = 1,
  i = 0.04,
  data,
  prop = 1,
  type = "joint",
  quant = 1,
  assumption = "none",
  cap = 1
)

`x`	A vector of intergers representing the age of each individual of the group.
`h`	An integer. The deferral period.
`n`	An integer. Number of years of coverage.
`k`	An integer. Number of payments per year.
`i`	The interest rate. A numeric type value.
`data`	A data.frame of the mortality table, with the first column being the age, and the second one the probability of death.
`prop`	A numeric value. It represents the proportion of the mortality table being used (between 0 and 1).
`type`	A character string. Conditions to be met in order to access the benefit of the annuity ("joint", "exactly" or "atleast").
`quant`	An integer. Required only if type is not "joint". If type is "exactly" it represents the exact amount of survivors required for the endowment to be payed. If type is "atleast", it represents the minimum number of survivors required.
`assumption`	A character string. The assumption used for fractional ages ("UDD" for uniform distribution of deaths, "constant" for constant force of mortality and "none" if there is no fractional coverage).
`cap`	A numeric type value. The annualized value of the payment.

Returns a numeric value (actuarial present value).

ages<-c(23,34,21)
ages<-c(23,34,21)
am(ages,5,10,2,0.05,CSO80MALB,1,"joint",assumption="UDD")
am(ages,0,20,1,0.06,CSO80FALBsmoker,1,"atleast",1)
am(ages,2,15,2,0.07,CSO80FANBsmoker,0.8,"exactly",2,"constant")