obspy.io.sac.core._read_sac_xy

_read_sac_xy(filename, headonly=False, debug_headers=False, round_sampling_interval=True, **kwargs)[source]

Reads an alphanumeric SAC file and returns an ObsPy Stream object.

Warning

This function should NOT be called directly, it registers via the ObsPy read() function, call this instead.

Parameters:

  • filename (str, Path, open file, or file-like object) – Alphanumeric SAC file to be read.

  • headonly (bool) – If set to True, read only the head. This is most useful for scanning available data in huge (temporary) data sets.

  • debug_headers (bool) – Extracts also the SAC headers 'nzyear', 'nzjday', 'nzhour', 'nzmin', 'nzsec', 'nzmsec', 'delta', 'scale', 'npts', 'knetwk', 'kstnm', 'kcmpnm' which are usually directly mapped to the Stream object if set to True. Those values are not synchronized with the Stream object itself and won’t be used during writing of a SAC file! Defaults to False.

  • round_sampling_interval (bool) – Whether to round sampling interval to microseconds before calculating sampling rate to avoid floating point accuracy issues with some SAC files (see #3408)

Return type:

Stream

Returns:

A ObsPy Stream object.

Example

>>> from obspy import read
>>> st = read("/path/to/testxy.sac")