GetLossAnalysisSummaryResults Method

Retrieves Touchstone® Loss Analysis Summary Results for a given Detailed Loss Analysis.

Loss Analysis Summary Results are the Average Annual Losses (AAL), as opposed to the Event Losses. The data that the GetLossAnalysisSummaryResults() method returns includes the following:

Returned Data

Description

Type of loss

Summary Exceedance Probability (EP) or Tail Value at Risk (TVAR). The EP is the probability that various levels of loss will be exceeded. This is the basis upon which insurers estimate their likelihood of experiencing various levels of loss. The TVAR is the average of all losses beyond a specified return period.

Aggregate or Occurrence

Indicates whether the annual loss is the sum of all event losses in a single model year (aggregate loss) or the maximum event loss in a single model year (occurrence loss).

Financial Perspective

Indicates whether the loss is a gross, ground-up, net of pre-CAT, post-CAT net, pre-layer gross, or retained loss.

Financial Perspective	Description
Gross Loss	The total loss due to an event after limits and deductibles are applied
Ground-up Loss	The total loss due to an event before limits and deductibles are applied
Net Loss	The loss after applying all reinsurance treaties
Net of Pre-CAT Loss	The loss after application of all reinsurance treaties, except for CAT Excess of Loss (XOL) treaties
Post-CAT Net Loss	The loss after application of all reinsurance treaties, including CAT Excess of Loss (XOL) treaties
Pre-layer Gross Loss	The loss after applying Location-level limits and deductibles
Retained Loss	The loss after applying Location and Contract-level limits and deductibles

The expected value for the loss.

The standard deviation from the expected value.

EP1 - EP15

The probability that 15 points of loss will be exceeded. Some default levels are .1% (0.00100), .2% (0.00200), .4% (0.00400), 1% (0.01000), 2% (0.02000), and 5% (0.05000). An EP of 5% means that the loss value is likely to be equaled or exceeded 5% of the time.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

Public Function GetLossAnalysisSummaryResults( _
   ByVal request As GetLossAnalysisSummaryResultsRequest _
) As GetLossAnalysisSummaryResultsResponse

Dim instance As LossAnalysisServiceClient
Dim request As GetLossAnalysisSummaryResultsRequest
Dim value As GetLossAnalysisSummaryResultsResponse
 
value = instance.GetLossAnalysisSummaryResults(request)

public GetLossAnalysisSummaryResultsResponse GetLossAnalysisSummaryResults( 
   GetLossAnalysisSummaryResultsRequest request
)

Parameters

request: Contains a GetLossAnalysisSummaryResultsRequest that identifies the Touchstone-generated Analysis Sequential Identifier (SID) of the analysis for which you want to view Loss Analysis Summary Results, along with the desired type of coverage, perils, type of annual loss, type of Financial Perspective, and type of summary loss to include in the summary results, as well as the associated Business Unit SID and SQL Instance SID.

Return Value

A GetLossAnalysisSummaryResultsResponse containing the Loss Analysis Summary Results that you have requested, including EP Curve information and the summary EP distribution.

Remarks

To find the Business Unit SID to pass into this method, call the GetBusinessUnits() method.

To find the SQL Instance SID to pass into this method, call the GetSqlInstances() method.

To find the Analysis SID to pass into this method, call the GetDetailedLossAnalyses() method.

Example

The following example shows how to retrieve Touchstone Loss Analysis Summary Results using the GetLossAnalysisSummaryResults() method:

using System;
using AIR.Services.Common.Data;
using AIR.Services.LossAnalysis.Api;
using AIR.Services.LossAnalysis.Data;
            
class SnippetGetLossAnalysisSummaryResultsRequest
{
   private static void GetLossAnalysisResultSummary(int businessUnitSid, int sqlInstanceSid, int analysisSid)
   {
       LossAnalysisServiceClient client = new LossAnalysisServiceClient();
       GetLossAnalysisSummaryResultsRequest request = new GetLossAnalysisSummaryResultsRequest();
       request.BusinessUnitSid = businessUnitSid;
       request.SqlInstanceSid = sqlInstanceSid;
       request.AnalysisSid = analysisSid;
       request.AnnualTypeFilter = LossAnnualType.Aggregate | LossAnnualType.Occurrence;
       request.SummaryTypeFilter = LossSummaryType.EP | LossSummaryType.TVAR;
       request.PerspectiveFilter = FinancialPerspectives.Gross | FinancialPerspectives.GroundUp;
       GetLossAnalysisSummaryResultsResponse response = client.GetLossAnalysisSummaryResults(request);
       if (response.Status.Code == StatusCode.Success)
       {
           foreach (SummaryEPDistribution ep in response.Results)
           {
               Console.WriteLine("EPTypeCode: " + ep.EPTypeCode);
               Console.WriteLine("AnnualTypeCode: " + ep.AnnualTypeCode);
               Console.WriteLine("Perspective: " + ep.Perspective);
               Console.WriteLine("ExpectedValue: " + ep.ExpectedValue);
               Console.WriteLine("StandardDeviation: " + ep.StandardDeviation);
               Console.WriteLine("EP1Loss: " + ep.EP1Loss);
               Console.WriteLine("EP2Loss: " + ep.EP2Loss);
               Console.WriteLine("EP3Loss: " + ep.EP3Loss);
               Console.WriteLine("EP4Loss: " + ep.EP4Loss);
               Console.WriteLine("EP5Loss: " + ep.EP5Loss);
               Console.WriteLine("EP6Loss: " + ep.EP6Loss);
               Console.WriteLine("EP7Loss: " + ep.EP7Loss);
               Console.WriteLine("EP8Loss: " + ep.EP8Loss);
               Console.WriteLine("EP9Loss: " + ep.EP9Loss);
               Console.WriteLine("EP10Loss: " + ep.EP10Loss);
           }
       }
   }
}

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

LossAnalysisServiceClient Class
LossAnalysisServiceClient Members