Metadata-Version: 2.4
Name: sgsim
Version: 1.2.0
Summary: Python Package for Simulation and Analysis of Ground Motions
Author-email: Sajad Hussaini <hussaini.smsajad@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Sajad-Hussaini/sgsim
Project-URL: Repository, https://github.com/Sajad-Hussaini/sgsim
Project-URL: Issues, https://github.com/Sajad-Hussaini/sgsim/issues
Keywords: sgsim,stochastic ground motion simulation,ground motion analysis,earthquake engineering
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: matplotlib
Requires-Dist: numba
Requires-Dist: sphinx
Requires-Dist: sphinx_rtd_theme
Requires-Dist: myst-parser
Requires-Dist: nbsphinx
Dynamic: license-file

# SGSIM: Python Package for Simulation and Analysis of Ground Motions

[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![PyPI](https://img.shields.io/pypi/v/sgsim.svg)](https://pypi.org/project/sgsim)
[![Documentation Status](https://readthedocs.org/projects/sgsim/badge/?version=latest)](https://sgsim.readthedocs.io/en/latest/?badge=latest)

**SGSIM** is a Python package that provides two main capabilities:  
> 1. **Simulation** of earthquake ground motions using a site-compatible stochastic method [[1]](#references).  
> 2. **Processing and analysis** of ground motions, including filtering, trimming, and calculating various intensity measures (e.g., PGA, SA, FAS, etc.).


## Table of Contents
- [Features and Installation](#features-and-installation)
- [User Guide](#user-guide)
- [License](#license)
- [Contact](#contact)
- [References](#references)

## Features and Installation

See the [Documentation](https://sgsim.readthedocs.io/en/latest/?badge=latest).

## User Guide

The full documentation, including examples and the complete API reference, is available at [sgsim.readthedocs.io](https://sgsim.readthedocs.io/en/latest/?badge=latest).


## License

SGSIM is released under the [MIT License](https://opensource.org/licenses/MIT).  
See the [LICENSE](LICENSE) file for the full text.

## Contact
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](mailto:hussaini.smsajad@gmail.com)

> Please include "SGSIM" in the subject line for a quicker response.

### Support the Project

If you find this package useful, contributions to help maintain and improve it, are always appreciated.

[![PayPal](https://img.shields.io/badge/PayPal-Donate-blue.svg)](https://www.paypal.com/paypalme/sajadhussaini)

## 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 KAHRAMANMARAS, TURKEY (TÜRKIYE), EARTHQUAKE*  
*DOI: https://doi.org/10.1177/87552930251331981*  
(Journal of Earthquake Spectra)

**[2] SGSIM Package**  
*SGSIM: Python Package for Simulation and Analysis of Ground Motions*  
*DOI: https://doi.org/10.5281/zenodo.14565922*
