Skip to main content

A Python package for automatic earthquake detection and location using waveform migration and stacking.

Project description

DOI

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 badge
  • Icequakes at the Skeiðarárjökull outlet glacier, Iceland badge

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:

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

quakemigrate-1.1.2.tar.gz (144.6 kB view details)

Uploaded Source

Built Distributions

quakemigrate-1.1.2-cp312-cp312-win_amd64.whl (173.5 kB view details)

Uploaded CPython 3.12 Windows x86-64

quakemigrate-1.1.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (242.1 kB view details)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

quakemigrate-1.1.2-cp312-cp312-macosx_14_0_arm64.whl (415.7 kB view details)

Uploaded CPython 3.12 macOS 14.0+ ARM64

quakemigrate-1.1.2-cp311-cp311-win_amd64.whl (173.5 kB view details)

Uploaded CPython 3.11 Windows x86-64

quakemigrate-1.1.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (242.1 kB view details)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

quakemigrate-1.1.2-cp311-cp311-macosx_14_0_arm64.whl (415.7 kB view details)

Uploaded CPython 3.11 macOS 14.0+ ARM64

quakemigrate-1.1.2-cp310-cp310-win_amd64.whl (173.5 kB view details)

Uploaded CPython 3.10 Windows x86-64

quakemigrate-1.1.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (242.1 kB view details)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

quakemigrate-1.1.2-cp310-cp310-macosx_14_0_arm64.whl (415.7 kB view details)

Uploaded CPython 3.10 macOS 14.0+ ARM64

quakemigrate-1.1.2-cp39-cp39-win_amd64.whl (173.5 kB view details)

Uploaded CPython 3.9 Windows x86-64

quakemigrate-1.1.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (242.1 kB view details)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

quakemigrate-1.1.2-cp39-cp39-macosx_14_0_arm64.whl (415.7 kB view details)

Uploaded CPython 3.9 macOS 14.0+ ARM64

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

Hashes for quakemigrate-1.1.2.tar.gz
Algorithm Hash digest
SHA256 0286ef4f9c901541272a629bae82162b00ee459bbb85f08496a5f76a06426e6a
MD5 a3b74452d96f7a3cc5d9d1ee08a51999
BLAKE2b-256 c7400a520d3accb35b54e19fc07db220d3358777341318e54e80088d364e7f5e

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 b1e4b9a40675d60ed3674daf52c604e94f9e91f33640ccb57bd40aa2bf7d1d62
MD5 7bc3e3d4ecc7568975d24ad09ff06b29
BLAKE2b-256 5c439d8c1f31444341f4bf79e9af873c08476931a98afeecd624c747db3d1640

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 044bb6d5c461c54093d7f765ab9fdd4242e47c641fd5b20a5c169d1e758eb51a
MD5 b0e3e9a019af3be505948b1421a511a2
BLAKE2b-256 5fa1e7dbbf86c9d860eab1ac49ca813dfbe4ef341079db0f7aa749c1bf354d0c

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp312-cp312-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 7ed35170aee800c6dda38df8fed5631fa95380b2e032ec159fa1ba8e2e1259b2
MD5 f872b8ac1370e0e08659dfc1a7096b2e
BLAKE2b-256 5f2b275f9949b1edc4703de8fc042d03c663332f930b2afafa1102f8712d2be7

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 469ff0c127829d89eb78a793df578fca50d6fb36a2cc2613e24cd8d6ee8bcc4f
MD5 66812a0441df711104cde657d613d466
BLAKE2b-256 4cffd0912bce263d6d41c7b74cec5215ef863f6d58a585cb617f63a2a8dfa206

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 d0d6122ca8efadaedf21a7fda98d81757195137fb4ec2e495becc6d08e3c8df7
MD5 452dc5096f639b536bcf6d58a10d2cc9
BLAKE2b-256 51eb144f43727d51e21ca77972b0329ca9613940c5253933aef280e869072d0b

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp311-cp311-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 cd5aea568df1621e34a10fcb9119681b4bc38ebc602aa5ff14996c8b300eac98
MD5 510a31b4ec4edefea59554e724351d1a
BLAKE2b-256 fcebd7b7a2b68a2cf2a7c2ed96337a74c9dae8ab791e92a693c8710345ad9340

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 3ac6981a4ce5aa206e89a25bbddc5d056bab5e8e260d56062f39586d8e15780b
MD5 a740fc53527eca42a6cd33f9d837c1b9
BLAKE2b-256 f00ecccfd650561a90222152fbeda627658bdfeac70f4236bde9e7c1478c9d3b

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7fef3251edaac20ad064994ef6676571bad0e92afb4b2df3e213bbabf5c1ce67
MD5 d701550d4e03ed95adc37c7992ba1885
BLAKE2b-256 34b6d3accf060279e4f81d03995a6e59d92136f5d06451596eddb696885226a6

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp310-cp310-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 00925017d3e0080dea8f26ca7968f36c2d3fe28c242e61835d36960029ed8523
MD5 0eb3712bc21b501e0ad26f0815518438
BLAKE2b-256 a275688eb6edd2b5f8c3ffca83495583fb2c7db86d64a4ff8b45ed6f51b1fd01

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp39-cp39-win_amd64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 c550c4d1e053efa4787e5a02914739ad8b77e836b3a900f1ee6a740b4808d263
MD5 fb1201e83c655c905de923c6dbc4eb7f
BLAKE2b-256 0dafb5eb69b02914bb96c6545d8b57c56c985de6531a431075641085466445e3

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 a74691369eaf4f86b079657b600fec0b623e27e7a498c254ead1eba53968ee42
MD5 edbe9b02034d1c5a0988fcd6196d92c9
BLAKE2b-256 ad22f26d5c6c9c70e7142f6e004068a6a9eb079fde85de881b098a7e9b6e579e

See more details on using hashes here.

File details

Details for the file quakemigrate-1.1.2-cp39-cp39-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for quakemigrate-1.1.2-cp39-cp39-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 7fc5f09970443ce519484e3216bd70be7bd088191c8018cb1909c8a5b8a6a4f7
MD5 78771943d2006edc3eac4f2297074778
BLAKE2b-256 aece03f4f3def83b10eabd1cdbba1d62b5c3534bc6f0c7843af9580c0ee1336f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page