claim_history {SPLICE}R Documentation

Development of Case Estimates

Description

Consolidates payments and incurred revisions and returns a full transactional history of all the individual claims (transaction being either a payment or a case estimate revision).

Usage

claim_history(
  claims,
  majRev_list,
  minRev_list,
  k1 = 0.95,
  k2 = 0.95,
  base_inflation_vector = NULL,
  keep_all = FALSE
)

Arguments

claims

an claims object containing all the simulated quantities (other than those related to incurred loss), see claims.

majRev_list

nested list of major revision histories, see claim_majRev.

minRev_list

nested list of minor revision histories, see claim_minRev.

k1

maximum amount of cumulative claims paid as a proportion of total incurred estimate for major revisions; between 0 and 1.

k2

maximum amount of cumulative claims paid as a proportion of total incurred estimate for minor revisions; between 0 and 1.

base_inflation_vector

vector showing quarterly base inflation rates (quarterly effective) for all the periods under consideration (default is nil base inflation), should be consistent with the input inflation vector in claim_payment_inflation. If a single number is provided, the function will assume constant quarterly inflation.

keep_all

TRUE to keep the paid, outstanding payments, total incurred estimates just before the revision, FALSE to keep only the estimates right after the revision (⁠_right⁠).

Details

This function works to generate the full history of claims paid and incurred estimates by consolidating all the simulated revision quantities. It should be noted that in this consolidation step, we make the following adjustments:

Value

A nested list structure such that the jth component of the ith sub-list provides a full transactional history of the jth claim of occurrence period i. The "unit list" (i.e. the smallest, innermost sub-list) contains the following components:

txn_delay Delays from notification to the transactions (payment or incurred revision).
txn_time Times of the transactions (from the commencement of the first occurrence period).
txn_type Types of the transactions, "Ma" for major revision, "Mi" for minor revision, "P" for payment, "PMa" for major revision coincident with a payment, "PMi" for minor revision coincident with a payment.
cumpaid_right Cumulative claim payments immediately after each of the transactions (in the "right" continuous sense).
OCL_right Case estimate of outstanding claim payments immediately after each of the transactions (in the "right" continuous sense).
incurred_right Case estimate of incurred loss immediately after each of the transactions (in the "right" continuous sense).
minRev A list containing full history of minor revisions (frequency, time and revision size); claim_minRev.
majRev A list containing full history of major revisions (frequency, time and revision size); see claim_majRev.

and optionally (by setting keep_all = TRUE),

cumpaid_left Cumulative claim payments just before each of the transactions.
OCL_left Case estimate of outstanding claim payments just before each of the transactions.
incurred_left Case estimate of incurred loss just before each of the transactions.

[Package SPLICE version 1.1.2 Index]