SGSIM: Simulation and Analysis of Ground Motions
SGSIM is a Python package that provides two main capabilities:
- Simulation of earthquake ground motions using a site-compatible stochastic method [1].
- Processing and analysis of ground motions, including filtering, trimming, and calculating various intensity measures (e.g., PGA, SA, FAS, etc.).
Table of Contents
Online Web App (Live Demo)
🌐 Try the GUI online: A live demo of the SGSIM graphical user interface is hosted for quick ground motion analysis and feature exploration without needing any local installation:
🚀 Launch SGSIM Web App Demo
Online Demo vs. Local Installation:
The web app above is hosted on a free cloud server with very limited memory. For regular research workflows, large dataset processing, and high-performance analysis and processing, you should install SGSIM locally on your computer.
Installation
Core stable version (recommended): Install the latest stable version from PyPI:
pip install sgsim
GUI stable version:
If you want to use the graphical user interface locally, install with gui:
pip install sgsim[gui]
After installing, simply run sgsim in your terminal to launch the interface.
Development version:
To use the latest development version, install directly from the GitHub repository:
pip install git+https://github.com/Sajad-Hussaini/sgsim.git
Documentation & License
📖 Explore the Full Documentation, Tutorials, and API Reference available at sgsim.readthedocs.io.
SGSIM is distributed under the GNU General Public License v3 (GPLv3). See the LICENSE file for the full text.
You are free to use, modify, and distribute this software for academic and research purposes. Any commercial use or distribution of modified versions requires the entire project to be open-sourced under the same GPLv3 license. For proprietary commercial exemptions, please refer to the Contact section.
Contact & Support
For any questions, assistance, suggestions, or requests to implement additional Intensity Measures (IMs), please feel free to contact:
S. M. Sajad Hussaini
📧 hussaini.smsajad@gmail.com
Please include "SGSIM" in the subject line for a quicker response.
References
Please cite the following references for any formal study:
[1] Primary Reference
Broadband Stochastic Simulation of Earthquake Ground Motions with Multiple Strong Phases with an Application to the 2023 Kahramanmaraş, Turkey (Türkiye), Earthquake
DOI: https://doi.org/10.1177/87552930251331981
(Journal of Earthquake Spectra)
[2] SGSIM Package
Simulation and Analysis of Ground Motions
DOI: https://doi.org/10.5281/zenodo.14565922
1 maintainer
Release files for sgsim 1.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sgsim-1.6.0.tar.gz | 61.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sgsim-1.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 131.6 kB
Release files / sgsim-1.6.0.tar.gz
| Download URL | sgsim-1.6.0.tar.gz |
|---|---|
| Size | 61.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
72e5961a8f55e5f00ea9169343cdb1f8608f8d31369e1d526fb35c97d351a2be
|
|
BLAKE2b-256 checksum How to use checksums |
095f6d0931c4886f727ce86c8409c1768a22cfe8a9ceff33e7de8718efffe150
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 6, 2026.
Transparency logRelease files / sgsim-1.6.0-py3-none-any.whl
| Download URL | sgsim-1.6.0-py3-none-any.whl |
|---|---|
| Size | 70.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
452f611ac24b5e566f5331bc7b15b7d2c86000cadf6ef9a717fd94ff469bbb5e
|
|
BLAKE2b-256 checksum How to use checksums |
ffaf2df5da4454a4a2d433ca7d6306685ca611f670a48a9e302dd605d9e2fe94
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 6, 2026.
Transparency log
