Mailing list

To stay informed about the activities of the ObsPy package, we invite you to register to our mailing list. Newly added features, important changes and bug fixes will be announced there.

ObsPy users mailing list

• Subscribe / Unsubscribe
• Post a message
• Browse the archive

Open Bugs (4)

#183, #241, #308, #320

Tasks & Enhancements (12)

#147, #169, #203, #214, #218, #232, #250, #253, #270, #273, #328, #362

Support Requests (2)

#365, #367

Use cases/Applications using ObsPy

• ObsPyck
• SeismicHandler
• SeisHub
• SeishubExplorer
• HtoVToolbox
• Antelope Python moment tensor code
• Running ObsPy in a PiCloud
• Using ObsPy with py2exe
• Whisper
• Wavesdownloader

Welcome to 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 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.

Installing ObsPy

ObsPy is  currently running and tested on Linux (32 and 64 bit), Windows XP/Vista/7 (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:

• Linux
• Mac
• Windows
•  FreeBSD

 Documentation

The functionality is provided through the following packages:

General packages:

•  obspy.core - ObsPy core package, glues the single obspy packages together
•  obspy.imaging - Imaging spectograms, beachballs and waveforms
•  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:

•  obspy.gse2 - GSE2 and GSE1 read and write support
•  obspy.mseed - MiniSEED read and write support
•  obspy.sac - SAC read and write support
•  obspy.seisan - SEISAN read support
•  obspy.seg2 - SEG2 read support (experimental)
•  obspy.segy - SEGY read and write support
•  obspy.sh - Q and ASC read and write support (file formats of  SeismicHandler)
•  obspy.wav - WAV (audio) read and write support

Database or Web service access clients:

•  obspy.arclink -  ArcLink/WebDC request client
•  obspy.earthworm -  Earthworm request client (experimental)
•  obspy.iris -  IRIS DMC Core Web services request client
•  obspy.neries -  NERIES Seismic Data Portal request client
•  obspy.seishub -  SeisHub database client

Additional Documentation

1. The source code of all modules is available via the "Browse Source" button in the menu bar of this page.
2.  (Frequently) Asked Questions
3. 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.
4. 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
5. The pdf of the AGU Fall Meeting 2011 poster presentation is available here.

Any bugs, problems/questions or feature requests may be posted anonymously via the "New Ticket" button in the menu bar of this page.

Mailing Lists

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.

Developer Corner

•  Style Guide
• Known Issues
• Performance Tips  Python,  NumPy and ctypes,  NumPy Book
• Testing & Debugging, Sphinx Documentation
•  Docs or delete!
• BrainStorming