SubmitLossGroupingAnalysis Method

Submits a new Touchstone® Loss Group Analysis job.

A loss group analysis enables you to combine two or more existing sets of loss or loss group analysis results into one set of results. During the analysis, Touchstone generates new annual exceedance probability (EP), summary EP, and average annual loss (AAL) values as well as a parent event set.

The analysis results to combine must:

Exist on the same SQL Server instance
Correspond to the same number of simulated years
Correspond to the same model versions (if you combine loss results for the same model)
Correspond to current model versions

Touchstone determines whether to include storm surge and demand surge based on the configuration of the analysis results to combine.

Syntax

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

Public Function SubmitLossGroupingAnalysis( _
   ByVal request As SubmitLossGroupingAnalysisRequest _
) As SubmitLossGroupingAnalysisResponse

Dim instance As LossGroupingAnalysisServiceClient
Dim request As SubmitLossGroupingAnalysisRequest
Dim value As SubmitLossGroupingAnalysisResponse
 
value = instance.SubmitLossGroupingAnalysis(request)

public SubmitLossGroupingAnalysisResponse SubmitLossGroupingAnalysis( 
   SubmitLossGroupingAnalysisRequest request
)

Parameters

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

Return Value

A SubmitLossGroupingAnalysisResponse containing the Activity SID that uniquely identifies the asynchronous web service call that you made to submit the specified Loss Group 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 Loss Group Analysis, see GetLossGroupAnalyses().

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

LossGroupingAnalysisServiceClient Class
LossGroupingAnalysisServiceClient Members