Skip to content
barsch edited this page Dec 21, 2012 · 50 revisions

Build Status PEP8 Status

## ObsPy: A Python Toolbox
for seismology/seismological observatories

ObsPy is an open-source project dedicated to provide a Python framework for processing seismological data. It provides parsers for common file formats, clients to access data centers and seismological signal processing routines which allow the manipulation of seismological time series (see Beyreuther et al. 2010, Megies et al. 2011).

The goal of the ObsPy project is to facilitate rapid application development for seismology.

Getting Started

The ObsPy Gallery and its related ObsPy Tutorial are maybe the best point to get a first impression of what ObsPy is all about. The tutorial is a collection of short example programs with explanations and program output. For help getting started with Python, have a look at this collection of links to Tutorials.

Installation

ObsPy is currently running and tested on Linux (32 and 64 bit), Windows XP/Vista/7/8 (32 bit and/or 64 bit) and Mac OS X (32 and 64 bit Intel and untested support for 32 and 64 bit PPC).

These notes describe installing ObsPy on the following platforms:

Stay Informed

If you are using ObsPy we strongly recommend for you to join the [obspy-users] mailing list. This list will be the place where new additions, important changes and bug fixes will be announced. The list can also be used to contact other ObsPy users for open discussions.

There also is a feed for commits. To get emails concerning issues make a GitHub login, 'watch' our repository and set up email notifications for your GitHub account.

Note: Documentation for current master snapshot can be found here

General packages:

  • obspy.core - ObsPy core package, glues the single obspy packages together
  • obspy.imaging - Imaging spectograms, beachballs and waveforms
  • obspy.realtime - Extends the ObsPy core classes with real time functionalities (''experimental'')
  • obspy.signal - Filters, triggers, instrument correction, rotation, array analysis, beamforming
  • obspy.taup - Calculates and visualizes travel times
  • obspy.xseed - Converter for Dataless SEED, XML-SEED and SEED RESP files

Waveform import/export plug-ins:

Database or Web service access clients:

Use Cases / Applications Using ObsPy

References

  1. Moritz Beyreuther, Robert Barsch, Lion Krischer, Tobias Megies, Yannik Behr and Joachim Wassermann (2010), ObsPy: A Python Toolbox for Seismology, SRL, 81(3), 530-533.
  2. Tobias Megies, Moritz Beyreuther, Robert Barsch, Lion Krischer, Joachim Wassermann (2011), ObsPy – What can it do for data centers and observatories? Annals Of Geophysics, 54(1), 47-58, doi:10.4401/ag-4838.

Developer Corner