Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
img Added flowchart image for documentation Apr 5, 2018
redpy Fixed formatting issue in verbose catalog Aug 6, 2018
LICENSE.txt Added GNU GPLv3 license May 26, 2016
README.md Moved bokeh to conda-forge so it installs proper version (v0.12.14+) Mar 8, 2018
annotation.csv Added ability to add vertical span annotations (e.g., to mark importa… Jun 2, 2018
backfill.py Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018
catfill.py Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018
clearJunk.py Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018
compareCatalog.py Added amplitude column Jun 29, 2018
createReport.py Fixed help message string problem Jun 18, 2018
extendTable.py Added function to add additional stations to an existing table Apr 5, 2018
forcePlot.py Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018
initialize.py Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018
lapine.cfg Broadened server to accept any known FDSN client instead of just IRIS Nov 28, 2016
mshcat.csv Changed catalog to 2004-09-15 to 2004-09-24 Nov 23, 2015
plotJunk.py Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018
redpy.yml Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018
removeFamily.py Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018
removeFamilyGUI.py Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018
settings.cfg Loading from SAC and miniSEED now looks for files in subdirectories Mar 22, 2018
spec-file.txt Major updates to plotting, new dependencies, several new helper scrip… Mar 8, 2018

README.md

REDPy Logo

Overview

REDPy (Repeating Earthquake Detector in Python) is a tool for automated detection and analysis of repeating earthquakes in continuous data. It works without any previous assumptions of what repeating seismicity looks like (that is, does not require a template event). Repeating earthquakes are clustered into "families" based on cross-correlation across multiple stations. All data, including waveforms, are stored in an HDF5 table using PyTables.

Installation

REDPy runs on Python 2.7 and Python 3.5, with the following major package dependencies:
numpy | scipy | matplotlib | obspy | pytables | pandas | bokeh | cartopy

These dependencies can be easily installed via Anaconda on the command line. I highly recommend using a virtual environment so that your REDPy environment does not conflict with any other Python packages you may be using. This can be done with the following commands:

>> conda create -n redpy python=3.5
>> source activate redpy
>> conda install -c obspy obspy
>> conda install -c conda-forge bokeh cartopy shapely=1.5.17
>> conda install pytables pandas

You may either use python=3.5 or python=2.7, but other versions are not supported. Whenever you intend to run REDPy, be sure to source activate redpy and then source deactivate when you are done.

Usage

Once dependencies are installed and REDPy is downloaded, REDPy can be run out of the box with the following commands to test if the code is working on your computer. If it completes without error, it will produce files in a folder named default after several minutes.

>> python initialize.py
>> python catfill.py -v mshcat.csv
>> python backfill.py -v -s 2004-09-15 -e 2004-09-24

Check out the Wiki for more detailed usage!

Reference

If you would like to reference REDPy in your paper, please cite the following abstract until I finish writing the Electronic Seismologist paper for it:

Hotovec-Ellis, A.J., and Jeffries, C., 2016. Near Real-time Detection, Clustering, and Analysis of Repeating Earthquakes: Application to Mount St. Helens and Redoubt Volcanoes – Invited, presented at Seismological Society of America Annual Meeting, Reno, Nevada, 20 Apr.