SubmitEventExposureConcentrationAnalysis Method

Submits a new Touchstone® Event Geospatial Analysis job.

The Geospatial Analysis API enables you to perform a deterministic risk analysis on your Exposure View data to find out where your risks concentrate due to one or more specified perils, such as earthquakes, floods, and tropical cyclones. An Event Geospatial Analysis uses one or more historical event simulations or stochastic Realistic Disaster Scenarios (RDS) as accumulators in the Event analysis. This type of Geospatial Analysis accepts a list of one or more AIR Events for which you specify the corresponding Touchstone®-generated Event Sequential Identifiers (SIDs). Apply these Event parameters to your Exposure View to analyze the effect on the total risk count and the total replacement value of your insured properties.

Syntax

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

Public Function SubmitEventExposureConcentrationAnalysis( _
   ByVal request As SubmitEventExposureConcentrationAnalysisRequest _
) As SubmitEventExposureConcentrationAnalysisResponse

Dim instance As ExposureConcentrationAnalysisServiceClient
Dim request As SubmitEventExposureConcentrationAnalysisRequest
Dim value As SubmitEventExposureConcentrationAnalysisResponse
 
value = instance.SubmitEventExposureConcentrationAnalysis(request)

public SubmitEventExposureConcentrationAnalysisResponse SubmitEventExposureConcentrationAnalysis( 
   SubmitEventExposureConcentrationAnalysisRequest request
)

Parameters

request: Contains a SubmitEventExposureConcentrationAnalysisRequest that identifies the Options associated with the Event Geospatial Analysis job that you want to run, along with the associated Business Unit SID and SQL Instance SID.
The Options property contains a EventAnalysisOptions object that enables you to specify a list of the Event SIDs of one or more AIR Events that you want to use as accumulators in the Event Geospatial Analysis job that you are requesting.

Return Value

A SubmitEventExposureConcentrationAnalysisResponse containing the Activity SID that uniquely identifies the asynchronous web service call that you made to submit the specified Event Geospatial 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 Event Geospatial Analysis, see the GetEventExposureConcentrationAnalysisResults() method.

The results of an Event Geospatial Analysis are stored in an EventResult object.

Example

The following example shows how to submit a Touchstone Event Geospatial Analysis job using the SubmitEventExposureConcentrationAnalysis() method:

using System;
using System.Collections.Generic;
using AIR.Services.Common.Data;
using AIR.Services.ExposureConcentrationAnalysis.Api;
using AIR.Services.ExposureConcentrationAnalysis.Data;
using AIR.Services.ExposureConcentrationAnalysis.ZoneManagement.Api;
using AIR.Services.LossAnalysis.Data;
using AIR.Services.AnalysisCommon.Data;
            
class SnippetSubmitEventExposureConcentrationAnalysisRequest
{
    private static void SubmitEventExposureConcentrationAnalysis(int businessUnitSid, int sqlInstanceSid, int projectSid, int exposureViewSid,
                                                                List<int> eventSids, int resultDSSid, string currency, int currencyExchangeRateSid, 
                                                                string analysisName, string analysisDesc)
    {
        ExposureConcentrationAnalysisServiceClient ecaClient = new ExposureConcentrationAnalysisServiceClient();
        SubmitEventExposureConcentrationAnalysisRequest ecaEventRequest = new SubmitEventExposureConcentrationAnalysisRequest();
        ecaEventRequest.BusinessUnitSid = businessUnitSid;
        ecaEventRequest.SqlInstanceSid = sqlInstanceSid;
       
        EventAnalysisOptions eventOptions = new EventAnalysisOptions();
            
        eventOptions.ProjectSid = projectSid;
        eventOptions.ExposureTarget = new AIR.Services.AnalysisCommon.Data.ExposureTarget
        {
            Sid = exposureViewSid,
            Type = AIR.Services.AnalysisCommon.Data.ExposureTargetType.ExposureView
        };
            
        eventOptions.ExposedLimits = ExposedLimits.None;
            
        eventOptions.AIREventSids = eventSids;
        eventOptions.ApplyDisaggregation = false;
            
        eventOptions.ResultsSaveBy = ResultsSaveBy.SaveReplacementValues | ResultsSaveBy.SaveNumberofLocations | ResultsSaveBy.SaveNumberofRisks
                                    | ResultsSaveBy.SaveContract | ResultsSaveBy.SaveLayer | ResultsSaveBy.SaveLocation;
            
        eventOptions.ReinsuranceProgramSid = 0;
        eventOptions.FacultativeReinsuranceOptions = FacultativeReinsuranceOptions.DoNotApply;
            
        eventOptions.Name = analysisName;
        eventOptions.Description = analysisDesc;
        eventOptions.ResultDataSourceSid = resultDSSid;
            
        eventOptions.Currency = currency;
        eventOptions.CurrencyExchangeRateSid = currencyExchangeRateSid;
            
        ecaEventRequest.Options = eventOptions;
            
        SubmitEventExposureConcentrationAnalysisResponse ecaEventResponse = ecaClient.SubmitEventExposureConcentrationAnalysis(ecaEventRequest);
        if (ecaEventResponse.Status.Code == StatusCode.Success)
        {
            Console.WriteLine("Event Geospatial Analysis submitted with Activity SID: " + ecaEventResponse.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

ExposureConcentrationAnalysisServiceClient Class
ExposureConcentrationAnalysisServiceClient Members