pySATSI 0.2.0__tar.gz

pysatsi-0.2.0/.gitignore

@@ -0,0 +1,131 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+#profile_default/
+#ipython_config.py
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Mac DS_Store
+.DS_Store
+
+# VSCode workspace
+*.code-workspace
+.pylintrc

pysatsi-0.2.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,7 @@
+Code of Conduct
+===============
+
+All contributions to - and interactions surrounding - this project will abide by
+the [USGS Code of Scientific Conduct][1].
+
+[1]: https://www.usgs.gov/office-of-science-quality-and-integrity/scientific-integrity

pysatsi-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,16 @@
+Contributing
+============
+
+Contributions are welcome from the community. Questions can be asked on the
+[issues page][1]. Before creating a new issue, please take a moment to search
+and make sure a similar issue does not already exist. If one does exist, you
+can comment (most simply even with just a `:+1:`) to show your support for that
+issue.
+
+If you have direct contributions you would like considered for incorporation
+into the project you can [fork this repository][2] and
+[submit a pull request][3] for review.
+
+[1]: https://code.usgs.gov/esc/pySATSI/issues
+[2]: https://docs.gitlab.com/ee/user/project/repository/forking_workflow.html#create-a-fork
+[3]: https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html

pysatsi-0.2.0/DISCLAIMER.md

@@ -0,0 +1,11 @@
+Disclaimer
+==========
+
+This software is preliminary or provisional and is subject to revision. It is
+being provided to meet the need for timely best science. The software has not
+received final approval by the U.S. Geological Survey (USGS). No warranty,
+expressed or implied, is made by the USGS or the U.S. Government as to the
+functionality of the software and related material nor shall the fact of release
+constitute any such warranty. The software is provided on the condition that
+neither the USGS nor the U.S. Government shall be held liable for any damages
+resulting from the authorized or unauthorized use of the software.

pysatsi-0.2.0/LICENSE.md

@@ -0,0 +1,46 @@
+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

pysatsi-0.2.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: pySATSI
+Version: 0.2.0
+Summary: Python package for focal mechanism stress inversions
+Project-URL: Homepage, https://code.usgs.gov/esc/pySATSI
+Project-URL: Issues, https://code.usgs.gov/esc/pySATSI/-/issues
+Author-email: "Robert J. Skoumal" <rskoumal@usgs.gov>
+License-Expression: CC0-1.0
+License-File: LICENSE.md
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Requires-Dist: numpy<2.0
+Requires-Dist: pandas
+Requires-Dist: scikit-learn
+Requires-Dist: scipy
+Provides-Extra: plot
+Requires-Dist: matplotlib; extra == 'plot'
+Description-Content-Type: text/markdown
+
+# pySATSI
+
+Python package for focal mechanism stress inversions.
+
+Author: Robert Skoumal, U.S. Geological Survey | rskoumal@usgs.gov
+
+This project contains Python code to compute damped stress inversions using earthquake focal mechanism solutions.
+
+## How to Use
+#### 1. Install the latest release in your virtual environment:
+<pre>
+# If you <i><b>don't</b></i> want to create any plots:
+pip install -U pySATSI
+
+# If you <i><b>do</b></i> want to create plots:
+pip install -U pySATSI[plots]
+</pre>
+Python 3.8+ versions are supported.
+
+#### 2. Run pySATSI with your desired control file:
+```
+pySATSI path_to/control_file.txt
+```
+
+## More information
+### Running examples
+A variety of examples are provided in the repository. It's recommended you play around with these examples to learn about some of the features.
+1. Download the examples folder available [HERE](https://code.usgs.gov/esc/pySATSI/-/archive/main/pySATSI-main.zip?path=examples).
+2. Unzip the folder.
+3. Navigate to the examples folder you just downloaded, e.g.:
+`
+cd examples
+`
+4. Run pySATSI with the example of your choice, e.g.:
+`pySATSI 0D/control_file.txt`
+
+### Manual
+Refer to the [manual](https://code.usgs.gov/esc/pySATSI/-/blob/main/pySATSI_manual.pdf) or the [wiki](https://code.usgs.gov/esc/pySATSI/-/wikis/home) for additional information about running the code.
+
+## Citation
+Please cite our paper if you use anything in this project:
+
+- Skoumal, R.J., Hardebeck, J.L., Michael, A.J. (in review). pySATSI: A Python package for computing focal mechanism stress inversions. _Seismological Research Letters_.
+
+Significant portions of this algorithm are based on [SATSI](https://www.usgs.gov/node/279402):
+
+- Hardebeck, J.L., & Michael, A.J. (2006). Damped regional‐scale stress inversions: Methodology and examples for southern California and the Coalinga aftershock sequence. Journal of Geophysical Research: Solid Earth, 111(B11). https://doi.org/10.1029/2005JB004144
+
+## License and Disclaimer
+[License](https://code.usgs.gov/esc/pySATSI/-/blob/main/LICENSE.md): This project is in the public domain.
+
+[Disclaimer](https://code.usgs.gov/esc/pySATSI/-/blob/main/DISCLAIMER.md): This software is preliminary or provisional and is subject to revision.

pysatsi-0.2.0/README.md

@@ -0,0 +1,52 @@
+# pySATSI
+
+Python package for focal mechanism stress inversions.
+
+Author: Robert Skoumal, U.S. Geological Survey | rskoumal@usgs.gov
+
+This project contains Python code to compute damped stress inversions using earthquake focal mechanism solutions.
+
+## How to Use
+#### 1. Install the latest release in your virtual environment:
+<pre>
+# If you <i><b>don't</b></i> want to create any plots:
+pip install -U pySATSI
+
+# If you <i><b>do</b></i> want to create plots:
+pip install -U pySATSI[plots]
+</pre>
+Python 3.8+ versions are supported.
+
+#### 2. Run pySATSI with your desired control file:
+```
+pySATSI path_to/control_file.txt
+```
+
+## More information
+### Running examples
+A variety of examples are provided in the repository. It's recommended you play around with these examples to learn about some of the features.
+1. Download the examples folder available [HERE](https://code.usgs.gov/esc/pySATSI/-/archive/main/pySATSI-main.zip?path=examples).
+2. Unzip the folder.
+3. Navigate to the examples folder you just downloaded, e.g.:
+`
+cd examples
+`
+4. Run pySATSI with the example of your choice, e.g.:
+`pySATSI 0D/control_file.txt`
+
+### Manual
+Refer to the [manual](https://code.usgs.gov/esc/pySATSI/-/blob/main/pySATSI_manual.pdf) or the [wiki](https://code.usgs.gov/esc/pySATSI/-/wikis/home) for additional information about running the code.
+
+## Citation
+Please cite our paper if you use anything in this project:
+
+- Skoumal, R.J., Hardebeck, J.L., Michael, A.J. (in review). pySATSI: A Python package for computing focal mechanism stress inversions. _Seismological Research Letters_.
+
+Significant portions of this algorithm are based on [SATSI](https://www.usgs.gov/node/279402):
+
+- Hardebeck, J.L., & Michael, A.J. (2006). Damped regional‐scale stress inversions: Methodology and examples for southern California and the Coalinga aftershock sequence. Journal of Geophysical Research: Solid Earth, 111(B11). https://doi.org/10.1029/2005JB004144
+
+## License and Disclaimer
+[License](https://code.usgs.gov/esc/pySATSI/-/blob/main/LICENSE.md): This project is in the public domain.
+
+[Disclaimer](https://code.usgs.gov/esc/pySATSI/-/blob/main/DISCLAIMER.md): This software is preliminary or provisional and is subject to revision.

pysatsi-0.2.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pySATSI"
+version = "0.2.0"
+authors = [
+  { name="Robert J. Skoumal", email="rskoumal@usgs.gov" },
+]
+description = "Python package for focal mechanism stress inversions"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+	"numpy<2.0",
+	"pandas",
+	"scipy",
+	"scikit-learn",
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "CC0-1.0"
+license-files = ["LICENSE.md"]
+
+[project.optional-dependencies]
+plot=[
+	"matplotlib",
+]
+
+[tool.hatch.build]
+exclude = [
+	"examples",
+	"code.json",
+	"requirements.txt",
+	"*.pdf",
+	"*.so",
+]
+
+[project.scripts]
+pySATSI = "pySATSI.pySATSI:main"
+
+[project.urls]
+Homepage = "https://code.usgs.gov/esc/pySATSI"
+Issues = "https://code.usgs.gov/esc/pySATSI/-/issues"

pysatsi-0.2.0/src/pySATSI/__init__.py

@@ -0,0 +1 @@
+import os, sys; sys.path.append(os.path.dirname(os.path.realpath(__file__)))

pysatsi-0.2.0/src/pySATSI/functions/__init__.py

@@ -0,0 +1 @@
+import os, sys; sys.path.append(os.path.dirname(os.path.realpath(__file__)))