EzGM 1.7.0.1

Toolbox for ground motion record selection and processing

EzGM

Toolbox for ground motion record selection and processing.

---

Getting Started

The package has three different modules:

1. EzGM.selection deals with the record selection. It can be used to perform unconditional or conditional spectrum based selection in which intensity measure can be chosen as Sa(T*) or AvgSa(T*). The tool makes use of OpenQuake hazard library and thus any available ground motion prediction equation available can directly be used (see Example 1).
   It can also be used to perform the selection based on Turkish Building Earthquake Code (TBEC-2018), ASCE 7-16, and Eurocode 8 Part 1 (see Example 2).
   Currently, the records can be selected from the two publicly available databases: NGA_W2 and ESM_2018. The original flat-files for these databases were modified by discarding the records which are not possible to download.
   The database files which include features to perform record selection are stored as .mat files in path/to/EzGM/Meta_Data. Upon installation, during the use of this module for the first time, the default Meta_Data folder will be downloaded from: https://drive.google.com/file/d/15cfA8rVB6uLG7T85HOrar7u0AaCOUdxt/view?usp=sharing. If users desire to use/add another database such as ESM_2018.mat, they must stick to the same format in publicly available databases.
   Upon performing ground motion record selection/scaling if users desire to get formatted records, for the given metadata, they should place the available records from metadata file into the Records.zip with the name of database, e.g. ESM_2018.zip for database ESM_2018.
   In case of publicly available databases, users can also download the records directly by using the associated methods since the records are not generally available beforehand. To use ESM_2018 database, users must have access token (path/to/current/directory/token.txt) from https://esm-db.eu. The token can be retrieved directly using EzGM as well if the user credentials are provided. In order to use NGA_W2 database, users must have account obtained from https://ngawest2.berkeley.edu.
2. EzGM.utility can be used to post-process results of probabilistic seismic hazard analysis (PSHA) from OpenQuake.Engine. Its methods can be used to read and visualize seismic hazard curves and seismic disaggregation results. The module can be particularly useful while performing conditional spectrum (CS) based record selection for multiple-stripe analysis (MSA) (see Example 3).
3. EzGM.signal can be used to process ground motion records. It contains methods for filtering, baseline correction, and intensity measure calculations (see Example 4).

At the moment, no documentation is available for EzGM; hence, users are recommended to see the jupyter notebook examples to get familiar with EzGM. These can be accessed and run through binder which is an online service to deploy interactive computational environments for online repositories. Likewise, the notebooks which are ready to use through google colaboratory can be accessed. For EzGM examples, see:

Installation

• EzGM downloads google-chrome or firefox webdriver while executing ngaw2_download method. Therefore, user-specified browser ('chrome' or 'firefox') must be readily available.
• EzGM requires:
  openquake.engine>=3.14.0; selenium>=4.2.0; numba>=0.55.1; beautifulsoup4>=4.11.1; tqdm>=4.64.0;
• The package management system pip can be used to install EzGM (python >3.7).

  pip install EzGM
  

• Nonetheless, in order to avoid any potential issues, the following is recommended for installation:
  1. First, create a clean python envrionment with python version greater than 3.7. Then, upgrade pip:

  pip install --upgrade pip
  

  2. Clone openquake.engine from https://github.com/gem/oq-engine, and open the terminal inside the clone directory. Activate the environment you want to install the package. Then, install the package requirements based on your system via:

  pip install -r requirements-py38-win64.txt
  

  3. Install OpenQuake:

  pip install -e .
  

  4. Clone EzGM, and open the terminal inside the clone directory. Activate the environment you want to install the package. Finally, install the package via the same command shown in the previous step.
• Finally the package can be imported as:

import EzGM

---

Acknowledgements

Special thanks to Besim Yukselen for his help in the development of ngaw2_download method, and Gerard J. O'Reilly for sharing his knowledge in the field with me. The EzGM.selection.conditional_spectrum method is greatly inspired by Prof. Jack W. Baker whom I thank for sharing his work with the research community.

---

References

The references associated with each method are provided as the docstring. If you are going to use the code presented herein for any official study, please refer to:
Volkan Ozsarac, Ricardo Monteiro & Gian Michele Calvi (2023) Probabilistic seismic assessment of reinforced concrete bridges using simulated records, Structure and Infrastructure Engineering, 19:4, 554-574, DOI: 10.1080/15732479.2021.1956551

---

Potential Improvements

• Computation of the exact CS
• Addition of 3 component selection
• Addition of spectral matching methods
• Addition of generalized conditional intensity measure approach (GCIM)
• Addition of alternative code-based ground motion selection procedures