Split policy conditions documentation into a new section (#169)

* added policy conditions documentation * moved conditions into new section * example fixes * example 10 and 11 * example 10 fix * clarifications * update following MD review * added loss examples * corrections and more loss examples * few corrections * spacing * edits following AK review * more corrections
OasisLMF · Nov 9, 2023 · fa10831 · fa10831
1 parent bafa1b0
commit fa10831
Show file tree

Hide file tree

Showing 3 changed files with 573 additions and 94 deletions.
diff --git a/OpenExposureData/6_OED_Financial_Details_Primary.rst b/OpenExposureData/6_OED_Financial_Details_Primary.rst
@@ -127,28 +127,13 @@ Policy Special Conditions
 
 Policy special conditions are financial structures that apply to only a subset of locations within a policy. They apply after all location terms, but before any blanket policy terms or layer terms.
 
-These require four types of information: (1) the scope of the condition telling us which locations are included, (2) the financial terms of the condition, (3) the classification of the condition and (4) the order in which the special conditions apply – i.e. does a special condition apply before or after other special conditions that apply to the same locations.
-
 The scope of each special condition is specified using a **CondTag** on each location (in the location input file) that corresponds with the **CondTag** in the account input file.
 
 A unique set of financial terms and a classification is identified by the **CondNumber** field in the account file.
 
 The specification of the financial details of the condition is done in the same way as any other financial structure within OED but using the field names starting with ‘Cond’. All of the coverage values deductible and limit types and codes can be used for a special condition to specify how the special condition financial structures work. 
 
-Furthermore, there are two classifications of special conditions which are identified by the **CondClass** field in the account file. A value of 0 means 'Sublimit' and a value of 1 means 'Policy restriction'. The difference between them is what happens to losses for locations under the account that are not under the scope of the condition.
-
-* When the condition is a sublimit - the locations that are outside of scope of the condition **will** contribute loss to the policy on the account.
-* When the condition is a policy restriction - the locations outside of scope of the condition **will not** contribute loss to the policy on the account.
-
-Policy restrictions can be used to vary the locations that contribute loss to each policy under the same account, by having a different condition for each policy.
-
-Special conditions are defined in the OED account input file and must have a **CondNumber** and **CondTag** in this input file. If multiple special conditions apply within the same policy, then multiple rows (with the same **PortNumber**, **AccNumber** and **PolNumber** but different **CondNumber** and **CondTag**) must be used. The same **CondNumber** may be applied to more than one **CondTag**, if the financial terms are identical.
-
-If the special condition financial terms vary by policy, then a different CondNumber should be used for each unique set of terms. However, the **CondTag** should not vary for each **CondNumber**, and the locations should be tagged with **CondTag** only once per location in the location file. 
-
-There is one exception to this rule where there are multiple heirarchal conditions on the same location.  The order in which special conditions apply is specified through the **CondPriority** field in the account input file: if multiple special conditions **at different priorities** apply to the same location then multiple rows must be used in the location input file. Each location row will be identical apart from **CondTag** and which denote the special conditions grouping applying to the location for each condition.
-
-See example 4 in the financial structures' examples section for an illustration of how special conditions are specified.
+See the Financial Details Policy Conditions section for a detailed description of how special conditions are specified, and some examples.
 
 |
 
@@ -323,84 +308,7 @@ The account table above shows one of the flexible features of the OED – the po
 
 |
 
-**Example 4 – Commercial lines – multiple locations per policy with location and policy deductibles but with a sublimit for tier 1 wind**
-
-The tables below show an example of a commercial portfolio with 1 account containing 6 locations. The policy covers earthquake and wind with the same overall policy limit for both perils. However, for certain locations two different sub-limits apply for wind. We show two examples of this below, firstly where the sub-limits are not nested (e.g. Florida wind sub-limit and Texas wind sub-limit), and secondly where the sub-limits are nested (e.g. Texas tier 1 wind sub-limit and Texas overall wind sub-limit).
-
-|
-
-OED Account file:
-
-.. csv-table::
-    :widths: 20,30,30, 30,30,30,30,30,25
-    :header: "AccNumber",	"PolNumber",	"PolPeril",	"PolLimit6All",	"CondTag", "CondNumber",	"CondPriority",	"CondPeril",	"CondLimit6All"
-
-    "1",	"1",	"QQ1;WW1",	"1,500,000", "1",	"1",	"1",    "WW1",	"250,000"
-    "1",	"1",	"QQ1;WW1",	"1,500,000", "2",	"2",	"1",	"WW1",	"500,000"
-
-|
-
-OED Location file:
-
-.. csv-table::
-    :widths: 15,15,20,25,20,15
-    :header: "LocNumber",	"AccNumber",	"BuildingTIV",	"LocDedType1Building",	"LocDed1Building",	"CondTag"
-
-    "1",	"1",	"1,000,000",	"0",	"10,000",	"1"
-    "2",	"1",	"1,000,000",	"2",	"0.01",	    "1"
-    "3",	"1",	"1,000,000",	"1",	"0.05",	    "2"
-    "4",	"1",	"2,000,000",	"0",	"15,000",	"2"
-    "5",	"1",	"2,000,000",	"0",	"10,000",	
-    "6",	"1",	"2,000,000",	"2",	"0.10",	
-
-|
-
-In the tables above, special condition 1 (**CondNumber** = 1 in the account table) applies to **CondTag** = 1 which is the group of locations 1 and 2 (**CondTag** = 1 in the location table) whereas special condition 2 applies to locations 3 and 4.
-
-In the account table, note again the use of a second row for the same account and policy to specify a second special condition. This feature of OED means that essentially an unlimited number of special conditions are possible. The **CondPeril** field in the account table indicates the peril (or perils) to which the special condition financial terms apply. 
-In this example the special conditions are not nested – meaning that each location has no more than one special condition. In this situation the special conditions do not need an order and so the **CondPriority** should be the same for both conditions.
-
-In the location table, **CondTag** denotes the scope of the special condition (or conditions) which is a group of locations. **CondTag** must match with **CondTag** in the account table. 
-
-If two special conditions are nested or overlap – meaning that some locations have two applicable special conditions (e.g. Texas tier 1 wind sub-limit of 250,000 (**CondNumber** = 1) and Texas overall wind sub-limit of 500,000 (**CondNumber** = 2)), the tables would be specified as shown below. The example below assumes that locations 1 and 2 are in the Texas tier 1 region, locations 3 and 4 are within Texas but not in the Tier 1 wind region, and locations 5 and 6 are outside Texas.
-
-|
-
-OED Account file:
-
-.. csv-table::
-    :widths: 20,20,30,30,20,20,20,25,25
-    :header: "AccNumber",	"PolNumber",	"PolPeril",	    "PolLimit6All",	 "CondTag",   "CondNumber",	"CondPriority",	"CondPeril",	"CondLimit6All"
-
-
-    "1",	"1",	"QQ1; WW1",	    "1,500,000", "1",	"1",	"1",	"WW1",	"250,000"
-    "1",	"1",	"QQ1; WW1",	    "1,500,000", "2",	"2",	"2",	"WW1",	"500,000"
-
-|
-
-OED Location file:
-
-.. csv-table::
-    :widths: 12,12,15,20,15,10 
-    :header: "LocNumber",	"AccNumber",	"BuildingTIV",	"LocDedType1Building",	"LocDed1Building",	"CondTag"
-
-    "1",	"1",	"1,000,000",	"0",	"10,000",   "1"
-    "1",	"1",	"1,000,000",	"0",	"10,000",	"2"
-    "2",	"1",	"1,000,000",	"2",	"0.01",	    "1"
-    "2",	"1",	"1,000,000",	"2",	"0.01",	    "2"
-    "3",	"1",	"1,000,000",	"1",	"0.05",	    "2"
-    "4",	"1",	"2,000,000",	"0",	"15,000",	"2"
-    "5",	"1",	"2,000,000",	"0",	"10,000"
-    "6",	"1",	"2,000,000",	"2",	"0.10"
-
-The location table now has two extra rows for locations 1 and 2 to specify a second special condition applying to these locations, with two distinct values of **CondTag**. The **CondPriority** field in the account file is used to specify the order in which these special conditions apply. The method of adding an extra location row to specify an extra hierarchy of special condition means that the OED design can cope with an unlimited number of nested special conditions. Overlapping special conditions (e.g. Texas wind sublimit and multi-State tier 1 wind sublimit) can also be specified in this way. 
-
-Although not shown in the examples above, the field **CondName** can also be specified in the account table to provide a text description of each special condition.
-
-
-|
-
-**Example 5 – Policy layers**
+**Example 4 – Policy layers**
 
 The tables below show an example of a commercial portfolio with 1 account containing 6 locations and two policy layers. Each location has a coverage deductible and each policy has an underlying deductible applying across all coverage types.