Metadata-Version: 2.4
Name: gmprocess
Version: 2.6.0
Summary: USGS Automated Ground Motion Processing Software
Author-email: Eric Thompson <emthompsone@usgs.gov>, Mike Hearne <mhearne@usgs.gov>, Brad Aagaard <baagaard@usgs.gov>, Bruce Worden <cbworden@contractor.usgs.gov>, John Rekoske <jrekoske@ucsd.edu>, Heather Hunsinger <hhunsinger@usgs.gov>, Gabe Ferragut <gferragut@usgs.gov>
License: License
        =======
        
        Unless otherwise noted, This project is in the public domain in the United States
        because it contains materials that originally came from the United States Geological Survey, 
        an agency of the United States Department of Interior. 
        For more information, see the official USGS copyright policy at 
        https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits
        
        Additionally, we waive copyright and related rights in the work worldwide through the 
        CC0 1.0 Universal public domain dedication.
        
        
        CC0 1.0 Universal Summary
        -------------------------
        
        This is a human-readable summary of the [Legal Code (read the full text)][1].
        
        
        ### No Copyright
        
        The person who associated a work with this deed has dedicated the work 
        to the public domain by waiving all of his or her rights to the work worldwide 
        under copyright law, including all related and neighboring rights, 
        to the extent allowed by law.
        
        You can copy, modify, distribute and perform the work, even for commercial purposes,
        all without asking permission.
        
        
        ### Other Information
        
        In no way are the patent or trademark rights of any person affected by CC0, 
        nor are the rights that other persons may have in the work or in how the work is used, 
        such as publicity or privacy rights.
        
        Unless expressly stated otherwise, the person who associated a work with this deed
        makes no warranties about the work, and disclaims liability for all uses of the work,
        to the fullest extent permitted by applicable law. 
        When using or citing the work, you should not imply endorsement by the author or the affirmer.
        
        
        
        [1]: https://creativecommons.org/publicdomain/zero/1.0/legalcode
        
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: beautifulsoup4>=4.11.0
Requires-Dist: boto3
Requires-Dist: configobj>=5.0.6
Requires-Dist: esi-core>=1.2.1
Requires-Dist: esi-utils-colors>1.0
Requires-Dist: esi-utils-io>1.0
Requires-Dist: esi-utils-rupture<=1.0.4,>1.0
Requires-Dist: folium>=0.12
Requires-Dist: gmpacket>=0.1.6
Requires-Dist: h3
Requires-Dist: h5py>=3.11
Requires-Dist: lxml>=4.6.1
Requires-Dist: matplotlib>=3.1.0
Requires-Dist: numba>=0.58
Requires-Dist: numpy>=1.26
Requires-Dist: obspy>=1.5.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: openquake.engine>=3.18
Requires-Dist: pandas>=1.3.0
Requires-Dist: Pint>0.24.3
Requires-Dist: ps2ff>=1.5.2
Requires-Dist: pyarrow
Requires-Dist: pyasdf>=0.7
Requires-Dist: pydantic[email]>=2.0
Requires-Dist: rdflib>=6.3.2
Requires-Dist: requests>=2.29
Requires-Dist: ruamel.yaml>=0.17.16
Requires-Dist: schema>=0.7
Requires-Dist: scipy>=1.7
Requires-Dist: setuptools-scm>=6.3.2
Requires-Dist: statsmodels>=0.12.2
Requires-Dist: tqdm>4.67
Requires-Dist: usgs-strec>=2.3.11
Requires-Dist: xlrd>=2.0
Provides-Extra: dev
Requires-Dist: build>=0.7.0; extra == "dev"
Requires-Dist: black>=21; extra == "dev"
Requires-Dist: esi-releases>=0.1; extra == "dev"
Requires-Dist: flake8>=3.9; extra == "dev"
Requires-Dist: ipython>=7.26; extra == "dev"
Requires-Dist: pylint>=2.17; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest>=6.2; extra == "test"
Requires-Dist: pytest-cov>=2.12; extra == "test"
Requires-Dist: pytest-console-scripts>=1.4; extra == "test"
Requires-Dist: vcrpy>=4.1; extra == "test"
Provides-Extra: doc
Requires-Dist: altair>=4.2.2; extra == "doc"
Requires-Dist: furo>=2023.3.27; extra == "doc"
Requires-Dist: myst-nb>=0.17.2; extra == "doc"
Requires-Dist: myst-parser>=0.18.1; extra == "doc"
Requires-Dist: nbsphinx>=0.9.1; extra == "doc"
Requires-Dist: recommonmark>=0.7.1; extra == "doc"
Requires-Dist: sphinx>5.0.0; extra == "doc"
Requires-Dist: sphinx-autoapi<3.0.0; extra == "doc"
Requires-Dist: sphinx-copybutton>=0.5.2; extra == "doc"
Requires-Dist: sphinx-inline-tabs>=2023.4.21; extra == "doc"
Requires-Dist: sphinxcontrib-programoutput>=0.17; extra == "doc"
Provides-Extra: build
Requires-Dist: build; extra == "build"
Requires-Dist: twine; extra == "build"
Requires-Dist: check-wheel-contents; extra == "build"
Dynamic: license-file

# Introduction
This is a project designed to provide a number of functions related to parsing and processing earthquake ground motion data, building on top of the [ObsPy](https://github.com/obspy/obspy/wiki) library.
Most of the extensions that we provide are to handle strong motion data and related issues.


# Documentation
- Please note, we are in the process of improving the documentation and that there are some incomplete sections.
- The full documentation can be viewed locally by running the `docs/makedocs.sh` script.
- The documentation is also available [here](https://ghsc.code-pages.usgs.gov/esi/groundmotion-processing/).
- The MATLAB functions included in the `tools/matlab` directory include a short [tutorial](tools/matlab/readme.md)

# Getting Help
The developers can be reached at [gmprocess@usgs.gov](mailto:gmprocess@usgs.gov).

If you would like to post an issue to ask a question, request a new feature, or report a bug, you can do so at the [github mirror](https://github.com/DOI-USGS/ghsc-esi-groundmotion-processing) of this repository. 

If you would like to contribute merge requests to this repository, please let us know and we can add you as a collaborator. 
This will require that you create an account at code.usgs.gov, which is a more involved process than creating a personal account at github.com and posting to the issues on the github mirror.

# Suggested Citation
If you wish to cite this software please cite:

- Thompson, E.M., M. Hearne, B.T. Aagaard, J.M. Rekoske, C.B. Worden, M.P. Moschetti, H.E. Hunsinger, G.C. Ferragut, G.A. Parker, J.A. Smith, K.K. Smith, and A.R. Kottke (2024). USGS Automated Ground Motion Processing Software Version 2, U.S. Geological Survey software release, doi: [10.5066/P13HMKFJ](https://doi.org/10.5066/P13HMKFJ).

- Thompson, E.M., M. Hearne, B.T. Aagaard, J.M. Rekoske, C.B. Worden, M.P. Moschetti, H.E. Hunsinger, G.C. Ferragut, G.A. Parker, J.A. Smith, Smith, K.K., and A.R. Kottke (2025). Automated, Near Real‐Time Ground‐Motion Processing at the US Geological Survey. _Seismological Research Letters_, 96(1), pp.538-553, doi: [10.1785/0220240021](https://doi.org/10.1785/0220240021).

# Journal Articles
The list below is a subset of articles that made use of this software in their study. If you would like to have an article added to this list, please open an issue or email the developers.

- Ahdi, S.K., B.T. Aagaard, M.P. Moschetti, G.A. Parker, O.S. Boyd, and W.J. Stephenson (2024). Empirical ground-motion basin response in the California Great Valley, Reno, Nevada, and Portland, Oregon. _Earthquake Spectra_, 40(2): 1099-1131, doi: [10.1177/87552930241237250](https://doi.org/10.1177/87552930241237250).

- Boyd OS, D. Churchwell, M.P. Moschetti, et al. (2024). Sediment thickness map of United States Atlantic and Gulf Coastal Plain Strata, and their influence on earthquake ground motions. _Earthquake Spectra_, 40(1): 89-112, doi: [10.1177/87552930231204880](https://doi.org/10.1177/87552930231204880).

- Chatterjee, A., D.T. Trugman, G. Hirth, J. Lee, and V.C. Tsai (2024). High‐frequency ground motions of earthquakes correlate with fault network complexity. _Geophysical Research Letters_, 51(12), doi: [10.1029/2024GL109418](https://doi.org/10.1029/2024GL109418).

- Hirakawa, E., G.A. Parker, A. Baltay, and T. Hanks (2023). Rupture directivity of the 25 October 2022 Mw 5.1 Alum Rock earthquake. _The Seismic Record_, 3(2): 144-155, doi: [10.1785/0320230013](https://doi.org/10.1785/0320230013).

- Ji, C., A. Cabas, A. Kottke, M. Pilz, J. Macedo, and C. Liu (2023). A DesignSafe earthquake ground motion database for California and surrounding regions. _Earthquake Spectra_, 39(1): 702–721, doi: [10.1177/87552930221141108](https://doi.org/10.1177/87552930221141108).

- Li, M., E.M. Rathje, J.P. Stewart, M.E. Ramos-Sepulveda, and Y.M. Hashash (2025). Regional adjustment to the NGA-East GMM for Texas, Oklahoma, and Kansas. _Earthquake Spectra_, doi: [10.1177/87552930251313817](https://doi.org/10.1177/87552930251313817).

- Mohammed, S., R. Shams, C.C. Nweke, T.E. Buckreis, M.D. Kohler, Y. Bozorgnia, and J.P. Stewart (2024). Usability of Community Seismic Network recordings for ground-motion modeling. _Earthquake Spectra_, 40(4): 2598-2622, doi: [10.1177/87552930241267749](https://doi.org/10.1177/87552930241267749).

- Moschetti M.P., E.M. Thompson, J.M. Rekoske, M. Hearne, P. Powers, D. McNamara, and C. Tape (2019). Ground‐Motion Amplification in Cook Inlet Region, Alaska, from Intermediate‐Depth Earthquakes, Including the 2018  7.1 Anchorage Earthquake. _Seismological Research Letters_, 91(1): 142–152, doi: [10.1785/0220190179](https://doi.org/10.1785/0220190179).

- Moschetti, M.P., B.T. Aagaard, S.K. Ahdi, J. Altekruse, O.S. Boyd, A.D. Frankel, J. Herrick, M.D. Petersen, P.M. Powers, S. Rezaeian, and A.M. Shumway (2024). The 2023 US national seismic hazard model: Ground-motion characterization for the conterminous United States. _Earthquake Spectra_, 40(2): 1158-1190, doi: [10.1177/87552930231223995](https://doi.org/10.1177/87552930231223995).

- Parker, G.A., and A.S. Baltay (2022). Empirical Map‐Based Nonergodic Models of Site Response in the Greater Los Angeles Area. _Bulletin of the Seismological Society of America_, 112(3): 1607–1629, doi: [10.1785/0120210175](https://doi.org/10.1785/0120210175)

- Rekoske J.M., E.M. Thompson, M.P. Moschetti, M. Hearne, B.T. Aagaard, and G.A. Parker (2020). The 2019 Ridgecrest, California, Earthquake Sequence Ground Motions: Processed Records and Derived Intensity Metrics. _Seismological Research Letters_, 91(4): 2010–2023, doi: [10.1785/0220190292](https://doi.org/10.1785/0220190292)

# Disclaimer

Any use of trade, firm, or product names is for descriptive purposes only and does not imply endorsement by the U.S. Government.
