Building Economic Loss

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