SGSIM is a Python package for simulating target earthquake ground motions using a site-compatible stochastic model [1]. It derives model parameters that implicitly account for the earthquake and site characteristics of the target ground motion. Using these parameters, the package simulates ground motions for the specific earthquake scenario, accounting for their aleatoric variability. It also provides tools for visualizing the simulation results.
To ensure compatibility with the user guide, it's recommended to use the latest release available on GitHub or PyPI or Zenodo.
- Site-based Stochastic Modeling: Configure and fit the stochastic model to ground motion data with customizable parameters.
- Simulation: Simulate ground motion time series, Fourier and response spectra, and other properties rapidly. The results can be saved in csv files.
- Visualization: Plot ground motion data, Fourier and response spectra, and other properties to verify and validate simulations.
To install SGSIM from source:
git clone https://github.com/Sajad-Hussaini/sgsim.git
cd sgsim
pip install .or install via pip (will be added), run:
pip install sgsimFor a step-by-step walkthrough on using SGSIM, refer to the Quick Start with SGSIM. The User Guide will be updated for more instructions.
SGSIM is released under the GNU AGPL 3.0. See the License for the full text.
If you have any questions or need assistance, feel free to contact me at hussaini.smsajad@gmail.com, with "SGSIM" in the subject line.
S.M. Sajad Hussaini: hussaini.smsajad@gmail.com
If you find this package useful, contributions to help maintain and improve it are always appreciated. You can donate via PayPal
Please cite the following references for any formal study:
[1] BROADBAND STOCHASTIC SIMULATION OF EARTHQUAKE GROUND MOTIONS WITH MULTIPLE STRONG PHASES WITH AN APPLICATION TO THE 2023 KAHRAMANMARAS, TURKEY (TÜRKIYE), EARTHQUAKE
*DOI: https://doi.org/10.1177/87552930251331981 (journal of Earthquake Spectra)
[2] SGSIM Package
DOI: https://doi.org/10.5281/zenodo.14565922