Combined wind, wave, surge building loss

Description

This analysis determines overall building loss from wind, flood and surge-wave damage

The output of this analysis is a CSV file with individual components of structural and content loss as well as total loss.

Input parameters

key name	type	name	description
result_name *	str	Result name	Name of the result dataset.

Input datasets

key name	type	name	description
buildings *	ergo:buildingInventoryVer4 ergo:buildingInventoryVer5 ergo:buildingInventoryVer6 ergo:buildingInventoryVer7	Building dataset	A building dataset.
wind_damage *	ergo:buildingDamageVer6	Building wind damage	A building wind damage dataset.
surge_wave_damage *	ergo:buildingDamageVer6	Building surge-wave damage	A building surge-wave damage dataset.
flood_damage *	ergo:buildingDamageVer6	Building flood damage	A building flood damage dataset.
structural_cost *	incore:structuralCostRatio	Building structural cost ratios	A dataset with building structural cost ratios for each archetype.
content_cost *	incore:contentCostRatio	Building content cost ratios	A dataset with building content cost ratios for each damage state.

Output datasets

key name	type	parent key	name	description
result *	incore:buildingLoss	buildings	Results	A dataset containing structural, content and total loss for each building (format: CSV).
(* required)

Execution

code snippet:

    # Create surge-wave building damage
    sw_bldg_dmg = BuildingDamage(client)

    # Run building damage analysis
    sw_bldg_dmg.run_analysis()    

    # Create wind building damage
    w_bldg_dmg = BuildingDamage(client)

    # Run building damage analysis
    w_bldg_dmg.run_analysis()    

    # Create flood building damage
    f_bldg_dmg = BuildingDamage(client)

    # Run building damage analysis
    f_bldg_dmg.run_analysis()    

    surge_wave_damage = sw_bldg_dmg.get_output_dataset("ds_result")
    wind_damage = w_bldg_dmg.get_output_dataset("ds_result")
    flood_damage = f_bldg_dmg.get_output_dataset("ds_result")

    # Combined building loss from each hazard
    combined_bldg_loss = CombinedWindWaveSurgeBuildingLoss(client)
    combined_bldg_loss.load_remote_input_dataset("buildings", bldg_dataset_id)
    combined_bldg_loss.set_input_dataset("surge_wave_damage", surge_wave_damage)
    combined_bldg_loss.set_input_dataset("wind_damage", wind_damage)
    combined_bldg_loss.set_input_dataset("flood_damage", flood_damage)
    combined_bldg_loss.load_remote_input_dataset("structural_cost", structural_cost_id)
    combined_bldg_loss.load_remote_input_dataset("content_cost", content_cost_id)
    combined_bldg_loss.set_parameter("result_name", "Galveston")
    combined_bldg_loss.run_analysis() 

full analysis: [combined_wind_wave_surge_building_loss.ipynb](https://github. com/IN-CORE/incore-docs/blob/main/notebooks/combined_wind_wave_surge_building_loss.ipynb)