SKHASH 0.1.0

Python package for earthquake focal mechanism inversions

SKHASH

Python package for earthquake focal mechanism inversions.

Author: Robert Skoumal, U.S. Geological Survey | [e-mail]

This project contains Python code to compute focal mechanism solutions using first-motion polarities (traditional, consensus, and/or imputed) and S/P ratios (traditional and/or consensus).

How to Use

1. Install the latest release in your virtual environment:

# If you don't want to create beachball plots:
pip install -U SKHASH

# If you do want to create beachball plots:
pip install -U SKHASH[plots]

Python 3.8+ versions are supported.

2. Run SKHASH with your desired control file:

SKHASH 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.
2. Unzip the folder.
3. Navigate to the examples folder you just downloaded, e.g.: cd examples
4. Run SKHASH with the example of your choice, e.g.: SKHASH hash1/control_file.txt

Manual

Refer to the manual 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., Shearer, P.M. (2024). SKHASH: A Python package for computing earthquake focal mechanisms. Seismological Research Letters, 95(4), 2519-2526. https://doi.org/10.1785/0220230329

Significant portions of this algorithm are based on HASH:

• Hardebeck, J.L., & Shearer, P.M. (2002). A new method for determining first-motion focal mechanisms. Bulletin of the Seismological Society of America, 92(6), 2264-2276. https://doi.org/10.1785/0120010200

• Hardebeck, J.L., & Shearer, P.M. (2003). Using S/P amplitude ratios to constrain the focal mechanisms of small earthquakes. Bulletin of the Seismological Society of America, 93(6), 2434-2444. https://doi.org/10.1785/0120020236

License and Disclaimer

License: This project is in the public domain.

Disclaimer: This software is preliminary or provisional and is subject to revision.