Reference Schema
The entities in the reference schema store reference data used by Contract Definition Language (CDL) and by analyses. Many of the tables include seeded data to which you can add your own. See for their descriptions. For the full specification of fields, data types, and values, see the Reference Schema and Reference Schema--RiskItem tabs of the RDOS schema specification RDOS_Schema.xlsx.
The entities are grouped as follows:
- Address tables
- Contract/Financial tables
- Population tables
- Portfolio and Structure tables
- Results and Settings tables
- Risk Item tables
Causes of Loss and Loss Types
Cause of Loss
Cause of loss is a collection of perils covered by a contract layer and specified in the Reference schema, ContractLayer.causeOfLossCode field. Peril models assess damage from natural catastrophe causes of loss (such as windstorm, earthquake, or flood) to real property. In the same way that some perils include sub-perils (or secondary perils), causes of loss can include subsidiary causes. For example, the earthquake cause of loss could include earthquake–fire following, earthquake–ground shaking, and earthquake–sprinkler leakage.
The Reference schema allows causes of loss to be grouped to form other causes of loss. The following Reference schema tables store information about causes of loss:
- Reference schema, CauseOfLoss table—Defines cause of loss codes used by contracts.
- Reference schema, CauseOfLossHierarchy table—Defines cause of loss groupings. For example, windstorm wind and windstorm storm surge can be combined into windstorm. Contract layers can cover windstorm or cover only windstorm wind or only windstorm storm surge.
The Reference schema defines codes for the causes of loss in Table 1. The cause of loss ALL acts as the parent cause of loss. Map any new cause of loss to a parent cause of loss.
Loss Types
Loss types represent the kind of exposure that damage to a risk item can cause an exposed party. For example, the following CDL applies a policy coverage level deductible for loss type building:
Deductibles
5k for Building
The following Reference schema tables store information about loss types:
- Reference schema, LossType table—Defines loss type codes used by contracts.
- Reference schema, LossTypeHierarchy table—Maps any new loss types to parent loss types. See Table 2.
Loss Type |
Parent Loss Type |
---|---|
BI |
Business interruption |
Building |
Property |
Casualty |
Loss |
Contents |
Property |
CovA |
Building |
CovB |
Building |
CovC |
Contents |
CovD |
BI |
Property |
Loss |
Cause of Loss and Loss Type Hierarchies
Cause of Loss and Loss Type hierarchies are used when you define which term of a CDL contract to process first. For example, for the two terms below:
Deductibles
5k for Building
10k for Property
The deductible for Building would be processed first and send its output as input to the deductible for Property since Building is a child loss type of Property (see Table 2), and loss type is the only constraint on these terms.
Similarly, if the causeOfLossHierarchy defines CS, FL, FR, WS, WT as children of "Climate" which is a child of "ALL," then the terms below in a CDL contract:
Sublimits
100k by WS
100k by FL
100k by EQ
200k Aggregate by Climate
the sublimits by WS and FL are processed before (and send their output to) the sublimit by Climate. The sublimit by EQ does not affect any of the other sublimits.