- Info
Component Library
Note: Return to reference manual view.
WORK IN PROGRESS: This manual contains descriptions needed by users and developers.
1.
Lines of Business
Lines of business are structuring elements. We call them composed components because they do not contain any business logic like algorithms. However they include several other components such as underwriting information, claims generators and sometimes reinsurance components.
1.1.
Example Lob
Example Lob is a composed component containing segmented underwriting information, an attritional and single claims generator and a reinsurance program with three contracts in a fixed order.
This component is used in the Capital Eagle model for the mtpl, motor hull and personal accident lines of business.
- Underwriting information
- Claims generators
- Sum insured allocator
- Reinsurance program
1.2.
Property Lob
Property Lob is a composed component containing segmented underwriting information, different claims generators, and a reinsurance program with three contracts in a fixed order.
This component is used in the Capital Eagle model for the property line of business. The difference between this component and the example line of business are the additional event claims generators for the perils earthquake, storm and flood.
- Underwriting information
- Claims generators
- Sum insured allocator
- Reinsurance program
1.3.
Minimal Line of Business
Minimal Line of Business ss a composed component containing underwriting information and an attritional and single claims generator.
Compared with other lines of business, this component doesn't contain any reinsurance contracts. This component may be of use in a model with a global/ multiline reinsurance program.
- Underwriting information
- Claims generators
2.
Underwriting Information
There are different components that provide different granularities of specifying underwriting information.
2.1.
Underwriting Information Based on Risk Bands
Underwriting information contains at least one risk band.
In motor third party liability possible risk bands might be i.e. private cars, taxis, trucks, petrol trucks. Each risk band is specified in an own table row containing the following information:
- maximal sum insured
- average sum insured
- premium
- number of policies
In case the parameterization contains surplus reinsurance treaties, the sum insured information and at least two risk bands are required. When using a surplus contract, it is also essential to select the allocation properties.
The following components are normally requesters of underwriting information:
- claims generators, as their calibration may be based on sum insured, premium, number of policies;
- frequency generators, as their calibration may be based on number of policies;
- sum insured to claims allocators;
- proportional reinsurance contracts as they need gross underwriting information in order to calculate the ceded underwriting information;
- working/cat excess of loss and stop loss reinsurance contracts, as the ceded premium may be specified as gnpi, rate on line and number of policies.
2.2.
Modelling Risk Profiles
Currently available claims generators generate claims without having access to the information about the risk profile they belong too. In order to model surplus reinsurance, such information is necessary.
There are different ways of generating claims containing risk profiles:
- a claims generator per risk profile
- allocating a risk profile to a claim. The current allocator component offers three different strategies:
- none: if a parameterization has no surplus contracts, there is no sense to waste runtime by allocating claims to risk profiles
- risk to band
- sum insured generator
Detailed information on the later two strategies is available in a pdf.
2.3.
Underwriting Segment
This component allows to model underwriting information with a minimal set of parameters.
Parameterization is done with a quantity structure describing the price per exposure unit, the written exposure and the used exposure base (i.e. absolute, written premium, number of policies, sum insured).
3.
Generators
The current toolbox allows to generate different kinds of claims, frequencies and severities.
3.1.
Claims Generators Overview
There are three different kinds of claims generators in RiskAnalytics.
Usage in Models
- A line of business normally contains different kinds of claims generators, i.e. an attritional claims generator and a single claims generator or several event claims generator.
- If an event affects several lines of business, the event generator will rather be part of a cat model than of a single line of business.
Attritional Claims Generator
generate one claim of type attritional per period. Attritional claims are covered by proportional reinsurance contracts such as quota share and surplus and stop loss contracts.
Single Claims Generator
generate a certain number of claims of type single per period. The number is normally received from a frequency generator. Single claims are covered by proportional reinsurance contracts and the working excess of loss (WXL) and stop loss contract.
Event Claims Generator
generate a certain number of claims of type event aggregate per period. The number is normally received from an event generator. Event aggregate claims are covered by proportional contracts, cat excess of loss (CXL) and stop loss contracts.
Common Parameterization Structure
Independent of the generated claim type the following parameters may be set:
Base: Apart from an absolute parameterization it is possible to calibrate the claim size based on premium written, number of policies and sum insured. In a first step a random number is generated according to the selected distribution and parameters. This number is then multiplied with the ‘base’ value. If the underwriting information consists of several risk bands the selected base values will be added up.
Distribution: The following ‘distributions’ are included. Adding further distributions is easy.
- chi square quadrat
- constant
- discrete empirical
- discrete empirical cumulative
- inverse Gaussian
- lognormal (mean, standard deviation)
- lognormal (mu, sigma)
- negative binomial
- normal
- pareto
- poisson
- piece wise linear
- piece wise linear empirical
- student
- triangular
- uniform
Parameter labels will be are switched in the tree view, if a different distribution is selected.
Modification: There are several ways to modify the random value, namely to censor, shift or truncate.
Background Information on Random Numbers
We use the SSJ Library from the University of Montreal for random number generators. Currently all random number generators are using F2NL607.
3.2.
Attritional and Single Claims Generator
This claim generator includes an attritional and single claims generator.
3.3.
Attritional, Single and Events Claims Generator
This component allows to generate attritional, single, earthquake, flood and storm claims.
It is used currently used for the property line of business in the Capital Eagle model.
3.4.
Attritional Claims Generator
This component generates one claim of type attritional per period. Attritional claims are covered by proportional reinsurance contracts such as quota share and surplus and stop loss contracts.
3.5.
Single Claims Generator
This component generates single claims by using a frequency and a claims size generator.
In a first step the number of claims is generated using the frequency generator. This number is sent to the claims generator that will generate as many single claims as defined by the frequency generator.
Parameterization possibilities
Explanations on claim types
3.6.
Frequency Generators
A frequency generator is typically used in the context of frequency severity models (single and event claims generation). Also frequency generators could be used for modeling causal dependencies.
Base: Apart from an absolute parameterization it is possible to calibrate the frequency based on number of policies. In a first step a random number is generated according to the selected distribution and parameters. This number is then multiplied with the ‘base’ value. If the underwriting information consists of several risk bands the selected base values will be added up.
Distribution: The following ‘distributions’ are included. In general you will select a discrete distribution.
- chi square quadrat
- constant
- discrete empirical,
- discrete empirical cumulative
- inverse Gaussian
- lognormal (mean, standard deviation)
- lognormal (mu, sigma)
- negative binomial
- normal
- pareto
- poisson
- piece wise linear
- piece wise linear empirical
- student
- triangular
- uniform
Parameter labels will be switched in the tree view, if a different distribution is selected.
Background Information on Random Numbers
We use the SSJ Library from the University of Montreal for random number generators. Currently all random number generators are using F2NL607.
3.7.
Event Claims Generator
This component generates event claims by using a frequency, event and claims size generator.
In the first step the number of claims is generated by using the
frequency generator. Afterwards the event generator fetches the according number of event severities. Finally the claims generator generates
the event claims using an inverse function.
Claim size
parameterization possibilities
For the
severities there are the same distributions as for the claims size available.
Explanations
on claim types
3.8.
Event Generator
This component generates events according to the frequency it receives. Events have a date and severity and are normally attached to a claim.
Causal
dependency modeling is possible using the same event to generate several claims
in different lines of business.
4.
Reinsurance
Different kinds of contracts and programs are available.
4.1.
Reinsurance Overview
Reinsurance contracts are usually grouped in a reinsurance program. It is possible to model reinsurance programs per line of business, global reinsurance programs with multi line coverage or a mixture of both concepts.
Available are programs with a fixed number of serial ordered contracts or 'dynamic' programs allowing the user to add and remove contracts within the graphical user interface and to define the order in which they are applied.
The graphical user interface allows selecting a ‘strategy’ per contract. Currently implemented strategies are:
- quota share
- quota share with annual aggregate limit
- surplus
- working excess of loss
- cat excess of loss
- stop loss
4.2.
Reinsurance Program
This reinsurance program has a fixed number of three reinsurance contracts. Contracts are processed in serial order.
- Each reinsurance contract is a template for any of the contracts available. The 'strategy' can be selected in the parameterization setting for different contract types.
- Net claims of contract 1 will be transfered to contract 2, in which those formely net claims will be interpreted as gross claims.
- The parameter insuring priority is not available in this program.
Additionally to this reinsurance program with a fixed order and number of contracts there is also a dynamic version available. The dynamic version provides the user a higher flexibility.
This reinsurance program is used in the Capital Eagle Model.
4.3.
Dynamic Reinsurance Program
A dynamic reinsurance program enables the user to specify the number and order of contracts with the parameterization.
- In order to add an additional contract to the reinsurance program right click on reinsurance program and select 'Add'.

- To remove a contract, right click on it and select 'Remove'.

- Each reinsurance contract is a template for any of the available
contracts available. The 'strategy' can be selected in the
parameterization setting different contract types.
- The order of the contracts is defined with the parameter inuring priority.
- The contract with the smallest inuring priority will be the first executed. If several contracts have the same inuring priority they will be applied on the same 'gross' claims and underwriting figures.
- If a program has several excess of loss (XL) layers, add as many contracts as layers are required and set the inuring priority to an equal number.
- In order to keep a program flexible for extensions it makes sense to use i.e. 10, 20, 30 as priorities. These gaps allow to easily insert further contracts between already existing contracts.
If a model shouldn't allow a user to edit the number and order of contracts there are also programs with a fixed number and order available.
4.4.
Dynamic Multi Line Reinsurance Program
A dynamic multi line reinsurance program is not part of any line of business. However, the dynamic multi line reinsurance program is usually attached on the same level as lines of business in the model tree.
- Dynamic multi line reinsurance programs have the same properties as dynamic reinsurance programs.
- Each contract has a 'covered lines' property as additional property. Double click on the list in order to select the covered lines using combo boxes.
4.5.
Reinsurance Contract
Each reinsurance contract has a strategy defining the contract type.
Common parameters to all strategies are
- covered by reinsurer defining the share signed
- Inuring priority is used if the user can add and remove contracts. It allows to define the order of applied contracts. Claims and underwriting information are first processed by the contract with the lowest inuring priority. The resulting net is then processed by the contract with the next higher inuring priority. If several contracts have the same inuring priority, they are applied in parallel. Parallel contracts may be used in combination with "covered by reinsurer" if a contract is splited among several reinsurers. Another use case consists of several XL layers.
Possible Strategies
- A quota share contract will have a proportional effect on all claim types.
4.6.
Multi Line Reinsurance Contract with Default
This contract allows to define the covered lines and the reinsurer as counter party of the contract.
By defining the reinsurer it is possible to model reinsurer defaults. The model should contain a reinsurer rating table and default probabilities per rating. If a reinsurer defaulti all contracts with this reinsurer will stop ceding claims.
If a contract is placed at different reinsurers, this can be done by selecting combinations of 'covered by reinsurer' and 'reinsurer'.
4.7.
Finite Reinsurance
Multi-period contract with an experience account and a risk component.
The finite reinsurance contract consists of two parts: An experience account and a risk part. This contract is a multi-period contract.
Input:
Model inputs:
For each period t, the finite re component receives list of claims C. These can be the ceded or the net claims produced by another reinsurance component. This has been decided by the model developer and cannot be changed by a model user.
User inputs: t refers to a time period
- the overall premium P(t) of the finite re contract in period t
- The fraction α(t) of the premium which is allocated to the experience account.
Output:
Experience Account
- premium P_ ea(t)
- claims C_ea(t)
- balance B(t) of the experience account
Risk Part:
- premium P_risk(t)
- claims C_risk(t)
- result R_risk(t) from the outset until the end of period t

Validation:
none implemented, but should be
Calculation:
- P_ea(t) = α(t) * P(t)
- P_risk(t) = (1 - α(t)) * P(t)
Both of these values are deterministic since α and the total premium P are fixed, deterministic values.
- C_ea(t) = min(B(t-1) + P_ea(t), C(t)), if t-1 refers to a period before the start of the contract, then B(t-1) is set to 0
- C_risk(t) = C(t) - C_ea(t)
- B(t) = B(t-1) + P_ea(t) - C_ea(t). The definition of C_ea(t) ensures that the B(t) >= 0
- R_risk(t) = R_risk(t-1) + P_risk(t) - C_risk(t), if t-1 refers to a period before the start of the contract, then R_risk(t-1) is set to 0
5.
Default Modelling
A reinsurer may fail with a small probability. To model such corporate defaults, we use
a rating table in which default probabilities can be associated with ratings and a table listing the ratings of the reinsurers. The reinsurance contracts also contain a description of counterparty that show which part is underwritten by which reinsurer. These three elements allow us to model reinsurance defaults in the obvious way.
6.
Object Datatypes
In PillarOne RiskAnalytics we use different kinds of objects for data shared between components. The principle could be compared to a parcel containing different goods.
6.1.
Claims
A claim is more than a number.
It is possible to generate the following claim types:
Each claim consists of a value and a date. Ceded claims keep a reference to the original claim. Furthermore event claims have a reference to the event they belong too.
Actually the different claim types are required for reinsurance modeling as different contracts require different levels of information to calculate correctly the ceded part.
Reinsurance Coverage
| Reinsurance Contract Type |
Attritional Claims |
Single Claims |
Event Claims |
| quota share |
covered |
covered |
covered |
| surplus |
covered |
covered |
covered |
| working excess of loss (WXL) |
|
covered |
|
| cat excess of loss (CXL) |
|
|
covered |
| stop loss |
covered |
covered |
covered |
|
|