obspy.io.sac.util.obspy_to_sac_header

obspy_to_sac_header(stats, keep_sac_header=True)[source]

Merge a primary with a secondary header, reconciling some differences.

Parameters:

  • stats (dict or Stats) – Filled ObsPy Stats header

  • keep_sac_header (bool) –

    If keep_sac_header is True, old stats.sac header values are kept, and a minimal set of values are updated from the stats dictionary according to these guidelines:

    • npts, delta always come from stats

    • If a valid old reftime is found, the new b and e will be made and properly referenced to it. All other old SAC headers are simply carried along.

    • If the old SAC reftime is invalid and relative time headers are set, a SacHeaderError exception will be raised.

    • If the old SAC reftime is invalid, no relative time headers are set, and “b” is set, “e” is updated from stats and other old SAC headers are carried along.

    • If the old SAC reftime is invalid, no relative time headers are set, and “b” is not set, the reftime will be set from stats.starttime (with micro/milliseconds precision adjustments) and “b” and “e” are set accordingly.

    • If ‘kstnm’, ‘knetwk’, ‘kcmpnm’, or ‘khole’ are not set or differ from Stats values ‘station’, ‘network’, ‘channel’, or ‘location’, they are taken from the Stats values.

    If keep_sac_header is False, a new SAC header is constructed from only information found in the Stats dictionary, with some other default values introduced. It will be an iztype 9 (“ib”) file, with small reference time adjustments for micro/milliseconds precision issues. SAC headers nvhdr, level, lovrok, and iftype are always produced.

Rtype merged:

dict

Returns:

SAC header