6. Release Notes

6.1. Version 3

Version 3.5 (Current)

Release date: June 2024

Major updates:

  • Ability to include different events in multi-model and multi-fidelity simulations

Version 3.4

Release date: March 2024

Major updates:

  • Ability to select from Physics based ground motions generated by M9 project

  • Update the Pelicun3 Damage and Loss engine to v3.3:

    • Changes affecting backwards compatibility

      • Remove “bldg” from repair consequence output filenames: The increasing scope of PBE now covers simulations for transportation and water networks. Hence, labeling repair consequence outputs as if they were limited to buildings no longer seems appropriate. The bldg label was dropped from the following files: DV_bldg_repair_sample,DV_bldg_repair_stats,DV_bldg_repair_grp, DV_bldg_repair_grp_stats, DV_bldg_repair_agg, DV_bldg_repair_agg_stats.

      • Decision variable types in the repair consequence outputs are named using CamelCase: Earlier they used all capitals. This change was made to be consistent with other parts of the codebase. For example, we use “Cost” instead of “COST”. This might affect post-processing scripts.

      • “ea” units were replaced with “unitless” where appropriate for clarity: There should be no practical difference between the calculations due to this change. Interstory drift ratio demand types are one example.

      • Weighted component block assignment is no longer supported: We recommend using more versatile approach of defining the same component type multiple times to achieve the same effect.

      • Damage functions are no longer supported: Damage functions were used to assign quantity of damage as a function of demand. Contrast this with fragility curves that assign probability of limit state exceedance as a function of demand. We recommend using the new multilinear CDF type fragility functions to develop theoretically equivalent, but more efficient models.

    • Deprecation warnings

      • Remove Bldg from repair settings label in DL configuration file: Following the changes above, we dropped Bldg from BldgRepair when defining settings for repair consequence simulation in a configuration file. The previous version (i.e., BldgRepair) will keep working until the next major release, but we encourage everyone to adopt the new approach and simply use the Repair keyword in the input files.

    • New features

      • Location-specific damage processes: This new feature is useful when you want damage to a component type to induce damage in another component type at the same location only. For example, damaged water pipes on a specific story can trigger damage in floor covering only on that specific story. Location-matching is performed automatically without you having to define component pairs for every location using the following syntax: ‘1_CMP.A-LOC’, {‘DS1’: ‘CMP.B_DS1’} , where DS1 of CMP.A at each location triggers DS1 of CMP.B at the same location.

      • Multilinear CDF random variable: allows using a multilinear approximation of any CDF in the tool.

      • Allow multiple definitions of the same component type at the same location and direction in the asset model. (If needed, we can later add a feature to propagate these as separate instances to model, e.g., components used by various tenants.)

      • Update JSON outputs to follow new standard SimCenter output format

      • Include unit information in every CSV and JSON output file.

      • Several minor efficiency improvements that lead to faster runtimes - major improvments in that area are coming in the next minor release

      • Several error and warning messages added to provide more meaningful information when something goes wrong in a simulation.

      • A lot of minor bugs fixed and robustness of the Pelicun engine ensured by bringing back continuous integration.

Version 3.3

Release date: Jan 2024

Major updates:

  • Allow multiple definitions of the same component type at the same location and direction in the asset model. (If needed, we can later add a feature to propagate these as separate instances to model, e.g., components used by various tenants.)

  • Update JSON outputs to follow new standard SimCenter output format

  • Include unit information in every CSV and JSON output file.

  • Several minor efficiency improvements that lead to faster runtimes - major improvments in that area are coming in the next minor release

  • Several error and warning messages added to provide more meaningful information when something goes wrong in a simulation.

  • A lot of minor bugs fixed and robustness of the Pelicun engine ensured by bringing back continuous integration.

Version 3.2

Release date: Sept 2023

Major updates:

  • Post-disaster Performance and Recovery Simulation

    • Extended the PBE simulation workflow with a Performance (PRF) step. Applications in this step use the Damage and Loss (DL) results in models that estimate the post-disaster performance and recovery of an asset

    • Integrated the ARUP REDi Seismic Downtime Model using the open-source PyREDI package as the first tool in the PBE App to support functional recovery calculations.

    • Example 3 is added to illustrate this new functionality.

  • All features of EE-UQ up to v3.4, including:

    • Multi Fidelity Monte Carlo (MFMC) method for modeling building response

Version 3.1

Release date: May 2023

Major updates:

  • Damage and Loss Database (DBDL)

    • A collection of parameters and metadata for damage and loss models for performance based engineering. The DBDL is available and updated regularly in the DB_DamageAndLoss GitHub Repository.

    • The initial release of the database includes the damage and repair consequence models from the following publications:
      • FEMA P-58 Second Edition

      • Hazus Earthquake Model for Buildings

      • Hazus Earthquake Model for Transportation Assets

    • This and future releases of the PBE tool have the latest version of DBDL at the time of their release bundled with them.

    • Included in documentation

  • Environmental Impacts as per FEMA P-58 included in DBDL and available in the new release.

  • New Outputs tab allows users to select the outputs they need (across asset, demand, damage, and loss information) and if they prefer them in CSV or JSON format.

  • Support automatic combination of built-in and user-defined databases for damage and loss models.

  • Support running calculations for only a subset of available consequence types.

  • All features of EE-UQ up to v3.3, including:

    • Multi-model uncertainty propagation options that allow multiple candidates for structural models and simulation settings.

    • Program Output Window provides detailed information about calculations and helps find errors.

Version 3.0

Release date: September 2022

Major updates:

  • Built on v4.0 of SimCenter’s backend application framework. Major updates in the backend:

    • Redesigned and generalized UQ architecture

    • Generalized workflow managers support non-building assets

    • Surrogate modeling capabilities for characterizing events and earthquake response

  • Redesigned user interface for Performance Assessment with Pelicun 3:

    • Takes advantage of the new databases developed for Pelicun 3 to allow users to use custom components, demands, damage processes, and consequence functions.

    • Decouples and generalizes demand, damage, and loss calculations.

    • Enables performance assessment under any type of natural hazard event

    • Supports modeling cascading damages

    • Supports custom mapping between damage states and consequence functions

    • Supports global consequences with uncertainty (e.g., uncertain replacement cost)

    • Substantial improvement in computational efficiency for large performance models

    • Two redesigned examples demonstrate capabilities

  • All features of EE-UQ up to v3.2.0, including:

    • Advanced options for PEER NGA Event selection

    • Site-specific seismic disaggregation

    • Steel and concrete building model generators

    • MDOF-LU approximate shear column model generator

Warning

Major releases break compatibility. Input files used for PBE 2.x will need to be converted to work with the PBE 3.x versions.

6.2. Version 2

Version 2.0.0

Release date: October 2019

Major updates:

  • Update DL interface:

    • General settings are organized around Damage, Response, and Loss Models

    • Components tab got a completely new look that facilitates the definition of component groups for each fragility group.

    • Dependencies moved to a new, fourth tab that will eventually house all advanced functionality

  • Support for loading and saving performance model (i.e., component definitions) using standard csv files.

  • Support for loading external EDP files using standard csv files. This enables the user to run a loss assessment without running the response estimation inside PBE.

  • Added damage and loss data from FEMA P58 second edition to the database.

  • Migrated to a new, more readable and flexible damage and loss model description in saved json files - not compatible with earlier versions.

  • All updates in EE-UQ up to v2.0, including:

    • Record selection from PEER NGA ground motion database

    • Nonlinear soil models in site response

    • Additional stochastic ground motion model

Warning

Major releases break compatibility. Input files used for PBE 1.x will need to be converted to work with the PBE 2.x versions.

6.3. Version 1

Version 1.2

Release date: June 2019

Major updates:

  • Updates to user interface for Damage and Loss assessment

  • All updates in EE-UQ up to v1.2, including:

    • 2D motions for site response

    • Improvements in connections to DesignSafe

    • Preferences window provides convenient access to settings

Version 1.1

Release date: April 2019

Major updates:

  • Damage and loss estimation using the Hazus Earthquake Model

  • All updates in EE-UQ up to v1.1, including:

    • Idealized Multiple Degrees of Freedom model for structural analysis

    • Stochastic Ground Motions

    • Site Response Analysis

    • User-defined EDPs in structural analyses

Version 1.0

Release date: October 2018

Initial release with FEMA P-58 damage and loss assessment functionality.

All features of EE-UQ v1.0 are available for structural response estimation.

Users are welcome to contact us on the github discussion page for new feature requests.