obspy.io.sac.core._read_sac

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

Reads an 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) – 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.

  • fsize (bool) – Check if file size is consistent with theoretical size from header. Defaults to True.

  • 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/test.sac")