SubmitMarginalImpactAnalysis Method

Submits a new Touchstone® Marginal Impact Analysis job.

A Marginal Impact Analysis enables you to view the effect that a specific loss results set (the target or new Portfolio/Contract) has on another loss results set (the Reference Portfolio). For example, an underwriter may want to assess the potential consequences of adding a new Contract or Portfolio to an existing Portfolio.

Marginal Impact combines two loss results sets, providing users with two outputs, one for Portfolio Impact and another for Marginal Impact. Touchstone stores summary EP data (aggregate and occurrence), event totals, and distribution based on the geographic resolution used to save the loss results, for both sets of impact results. You can use the Portfolio Impact results to determine capacity and the Marginal Impact results to determine pricing.

The calculation for the Portfolio Impact is equal to (Reference + New), while the calculation for the Marginal Impact is equal to (Reference + New) - Reference. (The calculation for Marginal Impact is not a mathematical formula and is, therefore, not equal to "New.")

Syntax

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

Public Function SubmitMarginalImpactAnalysis( _
   ByVal request As SubmitMarginalImpactAnalysisRequest _
) As SubmitMarginalImpactAnalysisResponse

Dim instance As MarginalImpactServiceClient
Dim request As SubmitMarginalImpactAnalysisRequest
Dim value As SubmitMarginalImpactAnalysisResponse
 
value = instance.SubmitMarginalImpactAnalysis(request)

public SubmitMarginalImpactAnalysisResponse SubmitMarginalImpactAnalysis( 
   SubmitMarginalImpactAnalysisRequest request
)

Parameters

request: Contains a SubmitMarginalImpactAnalysisRequest that identifies the Analysis Options associated with the Marginal Impact Analysis job that you want to run, along with the associated Business Unit SID and SQL Instance SID.

Return Value

A SubmitMarginalImpactAnalysisResponse containing the Activity SID that uniquely identifies the asynchronous web service call that you made to submit the specified Marginal Impact Analysis job.

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.

For information about retrieving the results of a Touchstone Marginal Impact Analysis, see GetMarginalImpactAnalysisResult().

Example

The following example shows how to submit a Touchstone Marginal Impact Analysis job using the SubmitMarginalImpactAnalysis() method:

using System;
using AIR.Services.Common.Data;
using AIR.Services.LossAnalysis.Data;
using AIR.Services.MarginalImpact.Api;
using System.Collections.Generic;
            
class SnippetSubmitMarginalImpactAnalysisRequest
{
    private static void SubmitMarginalImpactAnalysis(int businessUnitSid, int sqlInstanceSid, int projectSid, int resultDataSourceSid,
        int newPortfolioTargetSid, int referencePortfolioTargetSid, string currency, int currencyExchangeRateSid)
    {
        MarginalImpactServiceClient client = new MarginalImpactServiceClient();
            
        SubmitMarginalImpactAnalysisRequest request = new SubmitMarginalImpactAnalysisRequest();
        request.BusinessUnitSid = businessUnitSid;
        request.SqlInstanceSid = sqlInstanceSid;
   
        request.AnalysisOptions = new MarginalImpactLossAnalysisOptions();
            
        request.AnalysisOptions.Name = "Marginal Impact Analysis: " + DateTime.Now.Ticks;
        request.AnalysisOptions.Description = "Created by API at " + DateTime.Now.ToString("MMMM dd yyyy H mm ss"); ;
        request.AnalysisOptions.Currency = currency;
        request.AnalysisOptions.CurrencyExchangeRateSid = currencyExchangeRateSid;
            
        request.AnalysisOptions.ProjectSid = projectSid;
   
        request.AnalysisOptions.ResultDataSourceSid = resultDataSourceSid;
     
        request.AnalysisOptions.Perils = RegionalPerilSet.WorldAllPerils;
            
        request.AnalysisOptions.NewPortfolioTargetSid = newPortfolioTargetSid;
            
        request.AnalysisOptions.ReferencePortfolioTargetSid = referencePortfolioTargetSid;
            
        request.AnalysisOptions.WindowOfEvents = 3;
            
        request.AnalysisOptions.ExcludedContracts = new List<string>() { "test1", "test2" };
            
        request.AnalysisOptions.AdminBoundaryGroups = new List<AdminBoundaryGroup>(){ 
                                                            new AdminBoundaryGroup(){  
                                                                TargetName = "Test", 
                                                                AdminBoundarySid = 1,
                                                                PerilSetCodes = AIR.Services.Common.Data.MarginalImpactPerilSetCode.AllLicensedPerils
                                                            }
                                                        };
            
        SubmitMarginalImpactAnalysisResponse response = client.SubmitMarginalImpactAnalysis(request);
            
        if (response.Status.Code == StatusCode.Success)
        {
            Console.WriteLine("Marginal Impact analysis submitted with Activity Sid: " + response.ActivitySid);
        }
    }
}

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

MarginalImpactServiceClient Class
MarginalImpactServiceClient Members