Building functionality#

Description

The building functionality analysis calculates building functionality probabilities considering two situations: buildings are in at least a damage state 2 or greater or buildings are not damaged but electric power is not available to the building. Whether buildings can receive electrical power is assumed to depend on the interdependency between buildings and substations, and between buildings and poles in close proximity.

If both the nearest pole to the building and the substation where buildings belong to its service area are functional, buildings are considered to be able to receive electric power.

The outputs of this analysis are 1) a CSV file with probabilities of functionality samples for direct comparison with MC failure probability outputs and 2) a CSV file with probabilities of functionality.

Input parameters

key name

type

name

description

result_name *

str

Result name

Name of the result dataset.

Input datasets

key name

type

name

description

building_damage_mcs_samples *

incore:buildingDamageMcSamples

Building dataset

Buildings damage dataset.

substations_damage_mcs_samples *

incore:substationsDamageMcSamples

Substation dataset

Substations damage dataset.

poles_damage_mcs_samples *

incore:polesDamageMcSamples

Pole dataset

Electric poles dataset.

interdependency_dictionary *

incore:buildingInterdependencyDict

Interdependency dataset

A dataset of interdependency between buildings and substations and poles.

Output datasets

key name

type

name

description

functionality_samples *

incore:funcSample

Results

A dataset containing results of functionality samples
(format: CSV).

functionality_probability *

incore:funcProbability

Results

A dataset containing results of functionality probability
(format: CSV).

(* required)

Execution

code snippet:

    # Create building functionality instance
    bldg_dmg = BuildingFunctionality(client)

    # Load input dataset
    bldg_func.load_remote_input_dataset("building_damage_mcs_samples", building_dmg_mcs_id)
    bldg_func.load_remote_input_dataset("substations_damage_mcs_samples", substation_dmg_mcs_id)
    bldg_func.load_remote_input_dataset("poles_damage_mcs_samples", poles_dmg_mcs_id)
    bldg_func.load_remote_input_dataset("interdependency_dictionary", interdependency_id)

    # Specify the result name
    result_name = "funcionality_result"

    # Set analysis parameters
    bldg_func.set_parameter("result_name", result_name)
    bldg_func.set_parameter("num_samples", 3)
    bldg_func.set_parameter("num_cpu", 10)

    # Run building functionality analysis
    bldg_func.run_analysis()

full analysis: building_func.ipynb