Creates an output profile.

An output profile is configuration that identifies the loss tables, EP metrics, and statistics output to an analysis result.

An output profile must be specified in every request that initiates a modeling job. This output profile specifies the granularity (resolution) of the results the and the financial perspectives used to calculate modeled losses.

Request Object

The output profile is defined by an array of metricRequest objects that identify the metrics returned. For each object, the request must specify a metricType, granularity, and perspective.

{
  "name": "Admin2-GU-Metrics",
  "excludeDefaultMetrics": true,
  "metricRequests": [
    {
      "metricType": "EP",
      "perspective": "GU",
      "granularity": ["Country", "Admin1", "Admin2", "lossType"]
    },
    {
      "metricType": "STATS",
      "perspective": "GU",
      "granularity": ["Country", "Admin1", "Admin2", "lossType"]
    },
    {
      "metricType": "LOSS_TABLES",
      "perspective": "GU",
      "granularity": ["Country", "Admin1", "Admin2", "lossType"]
    }
  ]
}

The API enforces certain parameter inter-dependencies between the values specified for the metricType, granularity, and perspective parameters. For example, not all metric types are supported at all output levels (granularities).

Metric Types

Depending on the analysis type (DLM or HD), perspectives, and output level. The following metric types are supported in different configurations:

The DAMAGE, HAZARD, and UNCERTAINTY export types are supported for DLM Non-EP analyses only.

Perspectives

A financial perspective identifies the financial structures have been considered in the calculation of the loss statistics. To learn more, see Financial Perspectives.

Note: Select financial perspectives for EP output in order to be able to select financial perspectives on the results pages. If you select financial perspectives only for Stats and/or Loss Tables, the financial perspectives will not be selectable on the results pages.

The RG (Reinsurance Gross) financial perspective must be specified in an output profile to generate treaty-level output. If RG is not specified in the output profile, the analysis result uses the regular (portfolio-level) EP engine rather than the catastrophe treaty EP engine and does not generate the reinsurance gross perspective.

Granularities

The granularity array specifies the resolution of the metrics (STATS, EP, or LOSS_TABLES) returned by the analysis, i.e. level at which the output metrics are computed. Each granularity array specifies a collection of granularities that define an output level.

The Risk Modeler application defines resolution levels specified in an output profile by output level. In Legacy API, these output levels are defined as collections of granularity values.

Output levels are identified differently in the Legacy API than they are in the Risk Modeler application. The Risk Modeler application provides each output level with a label that masks the fact that each output level is in fact a collection of granularities.

Thus, to define the Admin 2 by Cedant by LOB output level as defined in the Risk Modeler application, the API request must specify the following granularity object:

{
  "granulariy": {
    "Country": "String",
    "Admin1": "String",
    "Admin2": "String",
    "Cedant": "String",
    "LOB": "String"
  }
}

Note that a Country value must be specified in every Admin1 Admin2 or PostalCode granularity request and an Admin1 value must be specified in an Admin2 granularity request object.

In most other instances, the label that identifies a granularity in the Risk Modeler application accurately identifies the constituent values that must be specified. For example, the Cresta by LOB by Cedant granularity is defined by an object that consists of Cresta, LOB, and Cedant.

The table identifies the granularity values that must be specified in a body of a request to define each of Granularity options displayed in the Risk Modeler application:

Knowledge Base

• HD Best Practices for Output Profiles