API Reference

Calculate climate change

post
https://{host}/platform/riskdata/v1/analyses//climate-change

Calculates climate change analysis as a post-analysis action using the specified analysis result as a reference analysis.

This operation supports analysis based on a variety of RCP (Representative Concentration Pathway) scenarios and SSP (Shared Socioeconomic Pathways) scenarios that project the impact of greenhouse gas emissions based on diverse climate policies.

During processing, the Climate Change Model recalculates average annual loss (AAL) and EP metrics for portfolio and treaty levels.

RCP scenarios

RMS Climate Change Models provide a probabilistic view of a range of representative concentration pathways (RCPs). They model the effect of climate change on hurricanes in the North Atlantic and on windstorms and floods in Europe. The Climate Change Models cover the same geographical scope as the RMS reference models for these regions.

This operation supports modeling based on four RCP scenarios.

rspScenarioDescription
2.6A pathway where radiative forcing peaks at approximately 3 W m-2 before 2100 and then declines to 2.6 W m-2.
4.5An intermediate stabilization pathway in which radiative forcing is stabilized at approximately 4.5 W m-2 and 6.0 W m-2 after 2100.
6.0An intermediate stabilization pathways in which radiative forcing is stabilized at approximately 4.5 W m-2 and 6.0 W m-2 after 2100.
8.5A high pathway for which radiative forcing reaches greater than 8.5 W m-2 by 2100 and continues to rise for some amount of time.

This operation supports RCP climate change analysis for reference analysis modeled using the following models:

ModelEngineSupported Versions
EUFL: Europe Inland FloodHD1.0 and later
EUWS: Europe WindstormDLMAny
EUWS: Europe WindstormHD1.0 and later
JPTY: Japan Typhoon and FloodHD2.0 and later
NAHU: North Atlantic HurricaneDLMAny
NAWF North America WildfireHD1.0 or 2.0
USFL: US Inland FloodHD1.1 and later

SSP scenarios

This operation supports four scenarios (1-2.6, 2-4.5, 3-7.0, 5-8.5 ) that combine SSP scenarios (SSP1, SSP2, SSP3, SS5) and RCP scenarios (2.6, 4.5, 7.0, 8.5). Each scenario represents a unique set of socioeconomic and emission trajectories. This operation supports four scenarios (1-2.6, 2-4.5, 3-7.0, 5-8.5 ) that combine SSP scenarios (SSP1, SSP2, SSP3, SS5) and RCP scenarios (2.6, 4.5, 7.0, 8.5). Each scenario represents a unique set of socioeconomic and emission trajectories.

sspScenarioSSP ScenarioRCP Equivalent
1-2.6SSP1:Sustainability ("Taking the Green Road")2.6
2-4.5SSP2: "Middle of the Road"4.5
3-7.0SSP3: Regional Rivalry ("A Rocky Road")7.0
5-8.5SSP5: Fossil-fueled Development ("Taking the Highway")8.5

This operation supports SSP climate change analysis for reference analysis based on the following models:

ModelEngineSupported Versions
NAWF: North America WildfireHD2.0

Climate change model support

All Climate Change Model analyses, except for the North Atlantic Hurricane Models, are performed as a post-processing step on existing model results.

The reference analysis must be modeled using the following versions:

ModelRegionmodelRegionCodeperilCodesoftwareVersionCode
Europe Inland Flood HD ModelsEuropeEUFLFLHDv2.1
Europe Windstorm ModelsEuropeEUWSWSRL25, RL24, RL23, RL22, RL21, RL18.1, RL18
Europe Windstorm HD ModelsEuropeEUWSWSHDv1.2
Japan Typhoon and Flood HD ModelJapanJPWSWSHDv2.1
North America Wildfire HD ModelsNorth AmericaNAWFWFHDv2.0
North Atlantic Hurricane ModelsNorth AtlanticNAHUWSRL25, RL24, RL23, RL22, RL21, RL18.1, RL18
US Inland Flood HD ModelUnited StatesUSFLFLHDv1.3

To learn more, see Climate Change Model Requirements and Features in Help Center.

🍊

Licensing

To calculate climate change analysis, you must license both the base models used in reference analysis and RMS Climate Change Models for all sub-regions in the original results.

Base models include Europe Inland Flood HD Models, Europe Windstorm Models, Japan Typhoon and Flood HD Model, North America Wildfire HD Model, North Atlantic Hurricane Models, US Inland Flood HD Model

🪰

Entitlements

RI-EXPOSUREIQ RI-RISKMODLER RI-UNDERWRITEIQ

Headers
uuid
required
Defaults to xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

ID of resource group. To learn more, see Resource Groups

Path Params
int64
required
≥ 1

ID of reference analysis.

Body Params
string
enum
Allowed:
string

Name of climate change analysis. Can be alphanumeric string.

string
enum
required

For North Atlantic Hurricane Models analyses only.

  • If Frequency and Intensity Only, model is conditioned based on frequency and intensity only.
  • If Combined All Parameters, model is conditioned based on frequency,intensity, storm size, and track location.
Allowed:
int32
enum
required

ID of event rate scheme conditioned for climate change. One of 190, 202, 84, 9.

  • 190: RMS 2019 Historical Event Rates
  • 202: RMS 2021 Historical Event Rates
  • 84: RMS 2015 Historical Event Rates
  • 9: RMS v2.0 Default Rates
Allowed:
double
enum

RCP scenario. One of 2.6, 4.5, 6.0, or 8.5.

  • 2.6: A pathway where radiative forcing peaks at approximately 3 W m-2 before 2100 and then declines to 2.6 W m-2.
  • 4.5: An intermediate stabilization pathway in which radiative forcing is stabilized at approximately 4.5 W m-2 and 6.0 W m-2 after 2100.
  • 6.0: An intermediate stabilization pathways in which radiative forcing is stabilized at approximately 4.5 W m-2 and 6.0 W m-2 after 2100.
  • 8.5: A high pathway for which radiative forcing reaches greater than 8.5 W m-2 by 2100 and continues to rise for some amount of time.
Allowed:
int32
required

One or more the snapshots included in an RCP scenario-based analysis. Values must be between 2020 and 2100 in five year increments. For example, 2020, 2025, 2030, 2035

boolean

Indicates whether the climate change analysis includes RCP scenarios. If no rcpScenario or timeHorizon values are specified, set to false.

Responses

CLIMATE_CHANGE job has been added to the job queue for processing.

Updated about 1 month ago

Language
Credentials
URL
Response 
 Choose an example:
*/*
application/json
Updated about 1 month ago