Tutorial

Note

A one-hour introduction to ObsPy is available at YouTube.

This tutorial does not attempt to be comprehensive and cover every single feature. Instead, it introduces many of ObsPy’s most noteworthy features, and will give you a good idea of the library’s flavor and style.

A PDF version of the Tutorial is available here. A Chinese translation of the tutorial (as of 2020-04-12) is available here.

There are also IPython notebooks available online with an introduction to Python (with solutions/output), an introduction to ObsPy split up in multiple chapters (again, versions with/without solutions available) and a brief primer on data center access and visualization with ObsPy. There are also nice Jupyter notebooks with an introduction to matplotlib.

Introduction to ObsPy

• Python Introduction for Seismologists
• UTCDateTime
  • Initialization
  • Attribute Access
  • Handling time differences
  • Exercises
• Reading Seismograms
  • Accessing Meta Data
  • Accessing Waveform Data
  • Data Preview
• Waveform Plotting Tutorial
  • Basic Plotting
  • Customized Plots
  • Saving Plot to File
  • Plotting multiple Channels
  • Creating a One-Day Plot
  • Plotting a Record Section
  • Plot & Color Options
  • Custom Plotting using Matplotlib
• Retrieving Data from Data Centers
  • The FDSN Web Services
  • IRIS Web Services
  • Earthworm Wave Server
  • NERIES Web Services
  • NEIC
  • SeedLink
  • Syngine Service
• Filtering Seismograms
• Downsampling Seismograms
• Merging Seismograms
• Beamforming - FK Analysis
• Seismogram Envelopes
• Plotting Spectrograms
• Trigger/Picker Tutorial
  • Reading Waveform Data
  • Available Methods
  • Trigger Examples
  • Network Coincidence Trigger Example
  • Advanced Network Coincidence Trigger Example with Similarity Detection
  • Picker Examples
  • Advanced Example
• Poles and Zeros, Frequency Response
• Seismometer Correction/Simulation
  • Calculating response from filter stages using evalresp..
  • Using a PAZ dictionary
• Clone an Existing Dataless SEED File
• Export Seismograms to MATLAB
• Export Seismograms to ASCII
  • Built-in Formats
  • Custom Format
• Anything to MiniSEED
• Beachball Plot
• Cartopy Plots
  • Cartopy Plot with Custom Projection Setup
  • Cartopy Plot of a Local Area with Beachballs
  • Cartopy Plot of the Globe with Beachballs
  • Cartopy Plot of the Globe with Beachball using read_events
• Interfacing R from Python
• Coordinate Conversions
• Hierarchical Clustering
• Visualizing Probabilistic Power Spectral Densities
• Array Response Function
• Continuous Wavelet Transform
  • Using ObsPy
  • Using MLPY
• Time Frequency Misfit
  • Plot the Time Frequency Representation
  • Plot the Time Frequency Misfits
  • Plot the Time Frequency Goodness-Of-Fit
  • Multi Component Data
  • Local normalization
• Visualize Data Availability of Local Waveform Archive
• Travel Time and Ray Path Plotting
  • Travel Time Plot
  • Cartesian Ray Paths
  • Spherical Ray Paths
  • Ray Paths for Multiple Distances
• Cross-Correlation Pick Correction
• Cross-Correlation Detector
  • Detection based on one component
  • Multi-station detection of swarm earthquakes with multiple templates
• Handling custom defined tags in QuakeML and the ObsPy Catalog/Event framework
• Handling custom defined tags in StationXML with the Obspy Inventory
• Creating a StationXML file from Scratch
• Connecting to a SeedLink Server
  • The create_client function
  • Advanced usage: subclassing the client

Advanced Exercise

In the advanced exercise we show how ObsPy can be used to develop an automated processing workflow. We start out with very simple tasks and then automate the routine step by step. For all exercises solutions are provided.

• Advanced Exercise