Home

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.

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

Acknowledging

Please support the project by acknowledging the use of it. This helps us keep it alive. If you use ObsPy (directly or as a dependency of another package) for work resulting in an academic publication, we would be grateful if one of the following papers is cited:

M. Beyreuther, R. Barsch, L. Krischer, T. Megies, Y. Behr and J. Wassermann (2010)
ObsPy: A Python Toolbox for Seismology
SRL, 81(3), 530-533
DOI: 10.1785/gssrl.81.3.530
T. Megies, M. Beyreuther, R. Barsch, L. Krischer, J. Wassermann (2011)
ObsPy – What can it do for data centers and observatories?
Annals Of Geophysics, 54(1), 47-58
DOI: 10.4401/ag-4838
L. Krischer, T. Megies, R. Barsch, M. Beyreuther, T. Lecocq, C. Caudron, J. Wassermann (2015)
ObsPy: a bridge for seismology into the scientific Python ecosystem
Computational Science & Discovery, 8(1), 014003
DOI: 10.1088/1749-4699/8/1/014003

Alternatively you can also directly cite the used ObsPy version:
DOIs for released ObsPy versions (e.g. for ObsPy 0.10.2: 10.5281/zenodo.17641)

News

[May 15 2015] Release of ObsPy 0.10.2

ObsPy 0.10.2 is a maintenance release and it contains a number of bug fixes and minor feature improvements so we advise all users to upgrade through one of the usual channels.

Release Including Full Changelog

[March 20 2015] Release of ObsPy 0.10.1

ObsPy 0.10.1 is once again our biggest release yet with over 2200 single commits from 25 individual contributors! We strongly encourage all users to update to the new version as it will effectively end support for the 0.9.x line. Major new features are Python 3 support, a new TauP implementation, Anaconda packages, ...

[May 4 2014] Release of ObsPy 0.9.2

ObsPy 0.9.2 is a maintenance release and contains the collective bug fixes and minor feature improvements of around 150 commits so we advise all users to upgrade.

Release including full changelog

[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.

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.

ObsPy runs on Python 2.6, 2.7, 3.3, and 3.4.

Detailed information on installing the latest stable version of ObsPy on various operating systems:

via Anaconda, a scientific Python distribution (all systems) (works without root access)
Debian/Ubuntu via the package manager
Fedora/CentOS via the package manager
Mac OS X via Homebrew or MacPorts
Windows from a pre-build package (PyPI) or from source
FreeBSD via the package manager
via PyPi or from source, applicable to Linux and OSX
for a reproducible installation mostly aimed at servers and clusters, have a look at the Salt formula for ObsPy

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

Notes on Parallel Processing with Python and ObsPy

Stay Informed

If you are using ObsPy we strongly recommend you join the [obspy-announcements] and the [obspy-users] mailing lists. The [obspy-announcements] list will be the place where new additions, important changes and bug fixes will be announced and thus will be very low volume. The [obspy-users] list is used to contact other ObsPy users for questions and open discussions.

[obspy-announcements]

[obspy-users]

Follow us on Twitter

For more frequent news and general information on Python in seismology/science, follow us on twitter: @obspy

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.