Building Economic Loss

Description

This analysis calculates the building loss based on building appraisal value, mean damage, and an inflation multiplier. A user must supply the inflation rate (as a percentage) between building appraisal year and year of interest (current, date of hazard, etc.) and optional Occupancy multiplier. The analysis can be used for with building mean damage results for either Structural, Drift-Sensitive Nonstructural, Acceleration-Sensitive Nonstructural or Contents Damage component.

The output of this analysis is a CSV file with structural losses based on damage.

Contributors

• Science: Ported from Ergo/MAEviz implementation

• Implementation: Michal Ondrejcek, Gowtham Naraharisetty, Chris Navarro and NCSA IN-CORE Dev Team

Input parameters

key name	type	name	description
result_name *	str	Result name	Name of the result dataset.
inflation_factor	float	Inflation factor	A factor to adjust the appraisal values of buildings. Default is 0.0.

Input datasets

key name	type	name	description
buildings *	ergo:buildingInventoryVer4 ergo:buildingInventoryVer5 ergo:buildingInventoryVer6 ergo:buildingInventoryVer7	Building dataset	A building inventory dataset.
building_mean_dmg *	ergo:meanDamage ergo:buildingDamage	Building mean damage	A CSV file with building mean damage results for either Structural, Drift-Sensitive Nonstructural, Acceleration-Sensitive Nonstructural or Contents Damage component.
occupancy_multiplier	incore:buildingOccupancyMultiplier	Occupancy multiplier	Building occupancy damage multipliers. These multipliers account for the value associated with different types of components (structural, acceleration-sensitive nonstructural, drift-sensitive nonstructural, contents).

Output datasets

key name	type	name	description
result *	ergo:buildingEconomicLoss	Results	A CSV file with building economy losses.

(* required)

Execution

code snippet:

    # Create building economic loss
    bldg_econ_dmg = BuildingEconLoss(client)

    # Load input dataset
    bldg_econ_dmg.load_remote_input_dataset("buildings", bldg_dataset_id)
    bldg_econ_dmg.load_remote_input_dataset("building_mean_dmg", bldg_dmg_id)
    bldg_econ_dmg.load_remote_input_dataset("occupancy_multiplier", bldg_occupancy_mult_id)

    # Specify the result name
    result_name = "seaside_bldg_econ_loss"

    # Set analysis parameters
    bldg_econ_dmg.set_parameter("result_name", result_name)
    bldg_econ_dmg.set_parameter("inflation_factor", 2.5)

    # Run building economic loss analysis
    bldg_econ_dmg.run_analysis()

full analysis: building_loss.ipynb