Patch fix for tenant unit function requirements

Function tolerances for exterior and interior systems were invested in the tenant_function_requirements.csv static table. The "exterior" and "interior" columns were updated to be listed as tolerances for the level of damage / impacted space rather than tolerances for non-damage / non-impacted space. The static table, example inputs, and schema were all updated to reflect this change.

Patch release to fix fire sprinkler bug

Fixes a small bug in the preprocessing function that was not correctly filtering fire sprinkler drops by what types of damage
actually affected fire system operations and therefore overcounting damage to the fire sprinklers as affecting fire suppression operation in the story access check.

Patch Update to Elevator Filter

Fixes bug in elevator filter in preprocessing function. Logic to create elevator function filter was incorrectly filtering for subsystem. This led to elevators not being correctly accounted for in the function assessment.

Patch Updates

Several patch updates to resolve minor/moderate bugs

• update fn_quantify_hvac_subsystem_recovery_day to properly filter to the subsystem components when calculating recovery day
• Fix the default door access width from 0.9ft to 9ft and rebuild example inputs
• Fix the door side index was being incorrectly indexed in fn_building_safety.m
• Flip orientation of building_model.edge_legth was getting incorrectly loaded from the json file for 1 story buildings (build_model.m)
• Fix component table build in build_model.m which was loading comp_ds_table.unit as a cell instead of a string, causing problems with the filters downstream (this update may have a significant impact on some model results)
• Added a new example input building to help test single story buildings
• Updated model building and preprocessor to ensure strcmp inputs are strings to help with Matlab version compatibility

Simplify Inputs and Create Input Builder Script

• Updated inputs schema
• Added additional repair_time_options inputs for impeding factors (beta and truncation bounds)
• Added additional repair_time_options inputs for repair schedule (worker constraints)
• migrated default median impeding factor assumptions to a static table
• decoupled impeding time simulation from repair schedule into its own package
• Removed fnc_filters from inputs and create a preprocessing script to calculate these variables
• Created a new build script to help define inputs from a simplified set of datafiles

Cook, Liel, Haselton, and Koliou (2022) Earthquake Spectra Release

Release Notes

This release updates the functional recovery assessment method to align with the method documented in Cook, Liel, Haselton, and Koliou, 2022. "A Framework for Operationalizing the Assessment of Post Earthquake Functional Recovery of Buildings". Earthquake Spectra.

Repair Schedule Updates

• Simulate variability in temporary repair times; follows truncated lognormal distribution with a lognormal uncertainty defined by the user (but default to 0.6). Distribution truncated at +/- two standard deviations.
• Updated impedance times based on feedback from ATC 138 committee.
• Temporary repair times do not begin until after the completion of inspection.
• Updated the way surge factors are applied to impedance times.
• Add in optional mitigation factors for impeding times.
• Changed contractor mobilization to uniform distribution.
• Changed other impeding times to use a truncated lognormal distribution, truncated at +/- two standard deviations.
• Update the repair schedule prioritization method to account for when building functionality is resolved by temporary repairs.

Damage State Attribute Updates

• Update elevator logic such that cab damage affects function.
• Updated the second damage state of stairs to affect access.
• Updated the motor control center to be part of the elevator system.
• Updated the temporary repair times based on feedback from the ATC 138 committee.
• Updated the falling hazard flags and affected areas based on feedback from the ATC 138 committee.
• Added fire sprinkler drops as a subsystem.
• Identified tenant contents fragilities that pose falling hazards and/or affect interior function.
• Add local stabilization logic; flag components that require local stabilization and have local stabilization repair occur before clean up items.
• Migrated parallel operation and service level flags from damage state to component level attribute.
• Flag components that affect the roof weatherproofing and implement new branches of the fault tree; roof tiles are temporarily repairable.
• Flag components that create hazardous conditions and implement new branches of the fault tree.
• Updated the attribute naming scheme.

Other Updates

• Uses N+1 redundancy for HVAC equipment that operates in parallel.
• Severe damage to stairs also affects the access of the story below where the damage occurs.
• Update subsystem attributes.
• Check the impact on both the HVAC and elevator system when the motor control system fails.
• Removed handling of global failure cases within functionality and repair time logic (i.e., method only models recovery using simulated component damage assuming the building will be repaired); demo and replace cases can be handled as a post process to the outputs.

Original Release

This is the official original release of the PBEE-recovery Matlab code base as documented in Chapter 4 of Cook (2021). Some additional logic for calculating impedance factors is provided in this release and will be fully documented in future manuscripts.

Cook, D, “Advancing Performance-Based Earthquake Engineering for Modern Resilience Objectives. A Dissertation for the Degree of Doctor of Philosophy.” University of Colorado Boulder, 2021.