ObsPy Data API

Waveform Data

Summary

Seismograms of various formats (e.g. SAC, MiniSEED, GSE2, SEISAN, Q, etc.) can be imported into a Stream object using the read() function.

Streams are list-like objects which contain multiple Trace objects, i.e. gap-less continuous time series and related header/meta information.

Each Trace object has the attribute data pointing to a NumPy ndarray of the actual time series and the attribute stats which contains all meta information in a dict-like Stats object. Both attributes starttime and endtime of the Stats object are UTCDateTime objects.

A multitude of helper methods are attached to Stream and Trace objects for handling and modifying the waveform data.

Stream and Trace Class Structure

Hierarchy: Stream → Trace (multiple)

Trace - DATA:

• data → NumPy array
• stats:
  • network, station, location, channel — Determine physical location and instrument
  • starttime, sampling_rate, delta, endtime, npts — Interrelated

Trace - METHODS:

• taper() — Tapers the data.
• filter() — Filters the data.
• resample() — Resamples the data in the frequency domain.
• integrate() — Integrates the data with respect to time.
• remove_response() — Deconvolves the instrument response.