Skip to content
This repository

Build Status PEP8 Status Coverage Status PyPI Version Downloads

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.


[January 9 2014] Release of ObsPy 0.9.0

ObsPy 0.9.0 offers (amongst many other things) two major new features: support for the FDSN webservices and the FDSN StationXML format.

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.


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:

If you intend on performing parallel processing with Python and Obspy, please read the following.

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. Includes support for event data and QuakeML.
  • 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.station - Support for FDSN StationXML (experimental)
  • 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


  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

Something went wrong with that request. Please try again.