“A Pandas-Centric ObsPy Expansion Pack”

ObsPlus is python package that adds functionality to the excellent seismology package ObsPy.

Key Features and Examples

The following sections highlight the key features of ObsPlus and provide examples of their usage.

1. Unifying Interfaces

ObsPlus lets you access each kind of seismic data (events, waveforms, and stations) in the same way regardless of the source, enabling cleaner, more flexible code. This is made possible by:

• WaveBank for working with local archives of waveforms.

• EventBank for working with local archives of events.

• Added obspy methods for treating Stream, Catalog and Inventory instances the same as remote clients.

• Fetcher for dataset-aware retrieval by composing waveform, events, and station clients.

2. Alternative Data Structures

ObsPlus provides several conversion functions to transform normal ObsPy data structures into DataFrames. These can be more convenient/efficient to work with, but come with their own trade-offs.

• Summarize event data as pandas DataFrames.

• Summarize station data as pandas DataFrames.

3. Utilities

Some utilities that you don’t have to rewrite yourself. Some of these will be moved to ObsPy if their usefulness to a wider audience is established.

• Catalog tools to bring a little more sanity to an already chaotic world.

• DataFrameExtractor to develop your own dataframe converters.

• Catalog to json to, well, convert catalogs to json.

• Miscellaneous utilities for a grab-bag of goodies.

4. Datasets

Often seismology codes benefit from a complete set of station, event, and waveform data for testing and demonstration. ObsPlus provides a few interesting (at least to the authors) datasets. Moreover, In only a few minutes, you can make your own research datasets pip installable using the dataset template.

• A tour of obsplus datasets, used for testing and documentation.

To search pypi for ObsPlus datasets registered by other users you navigate to PyPI and type opsdata in the search bar.