A Python package for automatic earthquake detection and location using waveform migration and stacking.
Project description
QuakeMigrate is a Python package for automatic earthquake detection and location using waveform migration and stacking.
Key Features
QuakeMigrate uses a waveform migration and stacking algorithm to search for coherent seismic phase arrivals across a network of instruments. It produces—from raw data—catalogues of earthquakes with locations, origin times, phase arrival picks, and local magnitude estimates, as well as rigorous estimates of the associated uncertainties.
The package has been built with a modular architecture, providing the potential for extension and adaptation at numerous entry points. This includes, but is not limited to:
- the calculation or import of traveltime grids
- the choice of algorithm used to identify phase arrivals (for example by kurtosis, cross-covariance analysis between multiple components, machine learning techniques and more)
- the stacking function used to combine onset functions
- the algorithm used to perform phase picking
Documentation
Documentation for QuakeMigrate is hosted here.
Installation
Detailed installation instructions can be found here.
If you're comfortable with virtual environments and just want to get started, QuakeMigrate is available via the Python Package Index, and can be installed via pip:
pip install quakemigrate
Usage
We are working on tutorials covering how each individual aspect of the package works, as well as example use cases where we provide substantive reasoning for the parameter choices used. These examples include applications to cryoseismicity and volcano seismology.
This is a work in progress - see our documentation for full details.
Examples you can run in your browser
To quickly get a taste for how the software works, try out the two icequake examples hosted on Binder:
- Icequakes at the Rutford Ice Stream, Antarctica
- Icequakes at the Skeiðarárjökull outlet glacier, Iceland
And for a more comprehensive demonstration of the options available, see the template scripts.
Citation
If you use this package in your work, please cite the following conference presentation:
Winder, T., Bacon, C.A., Smith, J.D., Hudson, T., Greenfield, T. and White, R.S., 2020. QuakeMigrate: a Modular, Open-Source Python Package for Automatic Earthquake Detection and Location. In AGU Fall Meeting 2020. AGU.
as well as the relevant version of the source code on Zenodo.
We hope to have a publication coming out soon:
Winder, T., Bacon, C.A., Smith, J.D., Hudson, T.S., Drew, J., and White, R.S. QuakeMigrate: a Python Package for Automatic Earthquake Detection and Location Using Waveform Migration and Stacking. (to be submitted to Seismica).
Contributing to QuakeMigrate
Contributions to QuakeMigrate are welcomed. Whether you have identified a bug or would like to request a new feature, your first stop should be to reach out, either directly or—preferably—via the GitHub Issues panel, to discuss the proposed changes. Once we have had a chance to scope out the proposed changes you can proceed with making your contribution following the instructions in our contributions guidelines.
Bug reports, suggestions for new features and enhancements, and even links to projects that have made use of QuakeMigrate are most welcome.
Contact
You can contact us directly at: quakemigrate.developers@gmail.com
Any additional comments/questions can be directed to:
- Tom Winder - tom.winder@esc.cam.ac.uk
- Conor Bacon - conor.bacon@cantab.net
License
This package is written and maintained by the QuakeMigrate developers, Copyright QuakeMigrate developers 2020–2023. It is distributed under the GPLv3 License. Please see the LICENSE file for a complete description of the rights and freedoms that this provides the user.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file quakemigrate-1.1.2.tar.gz
.
File metadata
- Download URL: quakemigrate-1.1.2.tar.gz
- Upload date:
- Size: 144.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0286ef4f9c901541272a629bae82162b00ee459bbb85f08496a5f76a06426e6a |
|
MD5 | a3b74452d96f7a3cc5d9d1ee08a51999 |
|
BLAKE2b-256 | c7400a520d3accb35b54e19fc07db220d3358777341318e54e80088d364e7f5e |
File details
Details for the file quakemigrate-1.1.2-cp312-cp312-win_amd64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp312-cp312-win_amd64.whl
- Upload date:
- Size: 173.5 kB
- Tags: CPython 3.12, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b1e4b9a40675d60ed3674daf52c604e94f9e91f33640ccb57bd40aa2bf7d1d62 |
|
MD5 | 7bc3e3d4ecc7568975d24ad09ff06b29 |
|
BLAKE2b-256 | 5c439d8c1f31444341f4bf79e9af873c08476931a98afeecd624c747db3d1640 |
File details
Details for the file quakemigrate-1.1.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 242.1 kB
- Tags: CPython 3.12, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 044bb6d5c461c54093d7f765ab9fdd4242e47c641fd5b20a5c169d1e758eb51a |
|
MD5 | b0e3e9a019af3be505948b1421a511a2 |
|
BLAKE2b-256 | 5fa1e7dbbf86c9d860eab1ac49ca813dfbe4ef341079db0f7aa749c1bf354d0c |
File details
Details for the file quakemigrate-1.1.2-cp312-cp312-macosx_14_0_arm64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp312-cp312-macosx_14_0_arm64.whl
- Upload date:
- Size: 415.7 kB
- Tags: CPython 3.12, macOS 14.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7ed35170aee800c6dda38df8fed5631fa95380b2e032ec159fa1ba8e2e1259b2 |
|
MD5 | f872b8ac1370e0e08659dfc1a7096b2e |
|
BLAKE2b-256 | 5f2b275f9949b1edc4703de8fc042d03c663332f930b2afafa1102f8712d2be7 |
File details
Details for the file quakemigrate-1.1.2-cp311-cp311-win_amd64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp311-cp311-win_amd64.whl
- Upload date:
- Size: 173.5 kB
- Tags: CPython 3.11, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 469ff0c127829d89eb78a793df578fca50d6fb36a2cc2613e24cd8d6ee8bcc4f |
|
MD5 | 66812a0441df711104cde657d613d466 |
|
BLAKE2b-256 | 4cffd0912bce263d6d41c7b74cec5215ef863f6d58a585cb617f63a2a8dfa206 |
File details
Details for the file quakemigrate-1.1.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 242.1 kB
- Tags: CPython 3.11, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d0d6122ca8efadaedf21a7fda98d81757195137fb4ec2e495becc6d08e3c8df7 |
|
MD5 | 452dc5096f639b536bcf6d58a10d2cc9 |
|
BLAKE2b-256 | 51eb144f43727d51e21ca77972b0329ca9613940c5253933aef280e869072d0b |
File details
Details for the file quakemigrate-1.1.2-cp311-cp311-macosx_14_0_arm64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp311-cp311-macosx_14_0_arm64.whl
- Upload date:
- Size: 415.7 kB
- Tags: CPython 3.11, macOS 14.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cd5aea568df1621e34a10fcb9119681b4bc38ebc602aa5ff14996c8b300eac98 |
|
MD5 | 510a31b4ec4edefea59554e724351d1a |
|
BLAKE2b-256 | fcebd7b7a2b68a2cf2a7c2ed96337a74c9dae8ab791e92a693c8710345ad9340 |
File details
Details for the file quakemigrate-1.1.2-cp310-cp310-win_amd64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp310-cp310-win_amd64.whl
- Upload date:
- Size: 173.5 kB
- Tags: CPython 3.10, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3ac6981a4ce5aa206e89a25bbddc5d056bab5e8e260d56062f39586d8e15780b |
|
MD5 | a740fc53527eca42a6cd33f9d837c1b9 |
|
BLAKE2b-256 | f00ecccfd650561a90222152fbeda627658bdfeac70f4236bde9e7c1478c9d3b |
File details
Details for the file quakemigrate-1.1.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 242.1 kB
- Tags: CPython 3.10, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7fef3251edaac20ad064994ef6676571bad0e92afb4b2df3e213bbabf5c1ce67 |
|
MD5 | d701550d4e03ed95adc37c7992ba1885 |
|
BLAKE2b-256 | 34b6d3accf060279e4f81d03995a6e59d92136f5d06451596eddb696885226a6 |
File details
Details for the file quakemigrate-1.1.2-cp310-cp310-macosx_14_0_arm64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp310-cp310-macosx_14_0_arm64.whl
- Upload date:
- Size: 415.7 kB
- Tags: CPython 3.10, macOS 14.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 00925017d3e0080dea8f26ca7968f36c2d3fe28c242e61835d36960029ed8523 |
|
MD5 | 0eb3712bc21b501e0ad26f0815518438 |
|
BLAKE2b-256 | a275688eb6edd2b5f8c3ffca83495583fb2c7db86d64a4ff8b45ed6f51b1fd01 |
File details
Details for the file quakemigrate-1.1.2-cp39-cp39-win_amd64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp39-cp39-win_amd64.whl
- Upload date:
- Size: 173.5 kB
- Tags: CPython 3.9, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c550c4d1e053efa4787e5a02914739ad8b77e836b3a900f1ee6a740b4808d263 |
|
MD5 | fb1201e83c655c905de923c6dbc4eb7f |
|
BLAKE2b-256 | 0dafb5eb69b02914bb96c6545d8b57c56c985de6531a431075641085466445e3 |
File details
Details for the file quakemigrate-1.1.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 242.1 kB
- Tags: CPython 3.9, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a74691369eaf4f86b079657b600fec0b623e27e7a498c254ead1eba53968ee42 |
|
MD5 | edbe9b02034d1c5a0988fcd6196d92c9 |
|
BLAKE2b-256 | ad22f26d5c6c9c70e7142f6e004068a6a9eb079fde85de881b098a7e9b6e579e |
File details
Details for the file quakemigrate-1.1.2-cp39-cp39-macosx_14_0_arm64.whl
.
File metadata
- Download URL: quakemigrate-1.1.2-cp39-cp39-macosx_14_0_arm64.whl
- Upload date:
- Size: 415.7 kB
- Tags: CPython 3.9, macOS 14.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7fc5f09970443ce519484e3216bd70be7bd088191c8018cb1909c8a5b8a6a4f7 |
|
MD5 | 78771943d2006edc3eac4f2297074778 |
|
BLAKE2b-256 | aece03f4f3def83b10eabd1cdbba1d62b5c3534bc6f0c7843af9580c0ee1336f |