The documentation of “sac/structure.h”

sac/structure.h マニュアル

(The documentation of sac/structure.h)

Last Update: 2021/12/9

sac/structure.hでは sacヘッダファイルパッケージで主に用いる構造体や共用体が定義されている。各構造体・共用体の定義を以下に示す。
Structures and unions mainly used in sac header file package are defined in sac/structure.h. Definitions of individual structures and unions are shown below.

◆目次(Table of contents)

struct sacheader_name型構造体 (a struct sacheader_name-type structure)
struct sacheader_number型構造体 (a struct sacheader_number-type structure)
union sacheader型共用体 (a struct sacheader-type union)
struct sac_timeseq型構造体 (a struct sac_timeseq-type structure)
struct sac_specRI型構造体 (a struct sac_specRI-type structure)

◆struct sacheader_name型構造体 (A struct sacheader_name-type structure)

SAC時系列データのヘッダを扱うための構造体である。多数のヘッダがあるので名前で扱う方が良い場合と番号で扱う方が良い場合があり、この構造体では名前で扱う。この構造体は以下のメンバから成る。
A structure to treat the headers of a SAC time series data. As there are many headers, they should be treated either by name or number, depending on situation. This structure treats the headers by name. This structure is composed of the following members.

型 Type	メンバ名 Name of member	メンバの意味 Meaning of member
double	h000_DELTA	SACヘッダDELTAの値。等間隔のデータにおける独立変数の間隔(サンプリング間隔)の設定値。 [省略不可] Value of SAC header DELTA. Increment between evenly spaced samples (nominal value). [required]
double	h001_DEPMIN	SACヘッダDEPMINの値。従属変数の最小値。 Value of SAC header DEPMIN. Minimum value of dependent variable.
double	h002_DEPMAX	SACヘッダDEPMAXの値。従属変数の最大値。 Value of SAC header DEPMAX. Maximum value of dependent variable.
double	h003_SCALE	SACヘッダSCALEの値。従属変数に掛けるスケールファクター。[現在は使用されていない] Value of SAC header SCALE. Multiplying scale factor for dependent variable. [not currently used]
double	h004_ODELTA	SACヘッダODELTAの値。実際のデータにおける独立変数の増分(サンプリング間隔)。設定値(恐らくDELTAのこと)と異なる場合用。 Value of SAC header ODELTA. Observed increment if different from nominal value.
double	h005_B	SACヘッダBの値。独立変数の開始値。[省略不可] Value of SAC header B. Beginning value of the independent variable. [required]
double	h006_E	SACヘッダEの値。独立変数の終了値。[省略不可] Value of SAC header E. Ending value of the independent variable. [required]
double	h007_O	SACヘッダOの値。イベント発生時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header O. Event origin time (seconds relative to reference time).
double	h008_A	SACヘッダAの値。初動走時(基準時刻に対する相対値、秒単位)。 Value of SAC header A. First arrival time (seconds relative to reference time).
double	h009_INTERNAL	SAC内部用ヘッダ(詳細不明)の値。 Value of SAC header internal to SAC and not normally of interest to the user.
double	h010_T0	SACヘッダT0の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T0. User defined time pick or marker (seconds relative to reference time).
double	h011_T1	SACヘッダT1の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T1. User defined time pick or marker (seconds relative to reference time).
double	h012_T2	SACヘッダT2の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T2. User defined time pick or marker (seconds relative to reference time).
double	h013_T3	SACヘッダT3の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T3. User defined time pick or marker (seconds relative to reference time).
double	h014_T4	SACヘッダT4の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T4. User defined time pick or marker (seconds relative to reference time).
double	h015_T5	SACヘッダT5の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T5. User defined time pick or marker (seconds relative to reference time).
double	h016_T6	SACヘッダT6の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T6. User defined time pick or marker (seconds relative to reference time).
double	h017_T7	SACヘッダT7の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T7. User defined time pick or marker (seconds relative to reference time).
double	h018_T8	SACヘッダT8の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T8. User defined time pick or marker (seconds relative to reference time).
double	h019_T9	SACヘッダT9の値。ユーザ定義のピックやマーカーの時刻(基準時刻に対する相対値、秒単位)。 Value of SAC header T9. User defined time pick or marker (seconds relative to reference time).
double	h020_F	SACヘッダFの値。イベント時刻のFiniまたは終わり(基準時刻に対する相対値、秒単位)。 Value of SAC header F. Fini or end of event time (seconds relative to reference time).
double	h021_RESP0	SACヘッダRESP0の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP0. Instrument response parameter. [not currently used]
double	h022_RESP1	SACヘッダRESP1の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP1. Instrument response parameter. [not currently used]
double	h023_RESP2	SACヘッダRESP2の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP2. Instrument response parameter. [not currently used]
double	h024_RESP3	SACヘッダRESP3の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP3. Instrument response parameter. [not currently used]
double	h025_RESP4	SACヘッダRESP4の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP4. Instrument response parameter. [not currently used]
double	h026_RESP5	SACヘッダRESP5の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP5. Instrument response parameter. [not currently used]
double	h027_RESP6	SACヘッダRESP6の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP6. Instrument response parameter. [not currently used]
double	h028_RESP7	SACヘッダRESP7の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP7. Instrument response parameter. [not currently used]
double	h029_RESP8	SACヘッダRESP8の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP8. Instrument response parameter. [not currently used]
double	h030_RESP9	SACヘッダRESP9の値。地震計の応答特性パラメータ。[現在は使用されていない] Value of SAC header RESP9. Instrument response parameter. [not currently used]
double	h031_STLA	SACヘッダSTLAの値。観測点の緯度(°単位、北緯なら正)。 Value of SAC header STLA. Station latitude (degrees, north positive).
double	h032_STLO	SACヘッダSTLOの値。観測点の経度(°単位、東経なら正)。 Value of SAC header STLO. Station longitude (degrees, east positive).
double	h033_STEL	SACヘッダSTELの値。観測点の標高(m)。[現在は使用されていない] Value of SAC header STEL. Station elevation (meters). [not currently used]
double	h034_STDP	SACヘッダSTDPの値。観測点の地表からの深さ(m)。[現在は使用されていない] Value of SAC header STDP. Station depth below surface (meters). [not currently used]
double	h035_EVLA	SACヘッダEVLAの値。イベントの震源の緯度(°単位、北緯なら正)。 Value of SAC header EVLA. Event latitude (degrees, north positive).
double	h036_EVLO	SACヘッダEVLOの値。イベントの震源の経度(°単位、東経なら正)。 Value of SAC header EVLO. Event longitude (degrees, east positive).
double	h037_EVEL	SACヘッダEVELの値。イベントの震源の標高(m)。[現在は使用されていない] Value of SAC header EVEL. Event elevation (meters). [not currently used]
double	h038_EVDP	SACヘッダEVDPの値。イベントの震源の地表下の深さ(m)。[現在は使用されていない] Value of SAC header EVDP. Event depth below surface (meters). [not currently used]
double	h039_MAG	SACヘッダMAGの値。イベントのマグニチュード。 Value of SAC header MAG. Event magnitude.
double	h040_USER0	SACヘッダUSER0の値。ユーザ定義変数の保存領域。 Value of SAC header USER0. User defined variable storage area.
double	h041_USER1	SACヘッダUSER1の値。ユーザ定義変数の保存領域。 Value of SAC header USER1. User defined variable storage area.
double	h042_USER2	SACヘッダUSER2の値。ユーザ定義変数の保存領域。 Value of SAC header USER2. User defined variable storage area.
double	h043_USER3	SACヘッダUSER3の値。ユーザ定義変数の保存領域。 Value of SAC header USER3. User defined variable storage area.
double	h044_USER4	SACヘッダUSER4の値。ユーザ定義変数の保存領域。 Value of SAC header USER4. User defined variable storage area.
double	h045_USER5	SACヘッダUSER5の値。ユーザ定義変数の保存領域。 Value of SAC header USER5. User defined variable storage area.
double	h046_USER6	SACヘッダUSER6の値。ユーザ定義変数の保存領域。 Value of SAC header USER6. User defined variable storage area.
double	h047_USER7	SACヘッダUSER7の値。ユーザ定義変数の保存領域。 Value of SAC header USER7. User defined variable storage area.
double	h048_USER8	SACヘッダUSER8の値。ユーザ定義変数の保存領域。 Value of SAC header USER8. User defined variable storage area.
double	h049_USER9	SACヘッダUSER9の値。ユーザ定義変数の保存領域。 Value of SAC header USER9. User defined variable storage area.
double	h050_DIST	SACヘッダDISTの値。震源・観測点距離(km)。 Value of SAC header DIST. Station to event distance (km).
double	h051_AZ	SACヘッダAZの値。震源から観測点への方位角(°)。 Value of SAC header AZ. Event to station azimuth (degrees).
double	h052_BAZ	SACヘッダBAZの値。観測点から震源への方位角(°)。 Value of SAC header BAZ. Station to event azimuth (degrees).
double	h053_GCARC	SACヘッダGCARCの値。観測点から震源への大円の弧長(°)。 Value of SAC header GCARC. Station to event great circle arc length (degrees).
double	h054_INTERNAL	SAC内部用ヘッダ(詳細不明)の値。 Value of SAC header internal to SAC and not normally of interest to the user.
double	h055_INTERNAL	SAC内部用ヘッダ(詳細不明)の値。 Value of SAC header internal to SAC and not normally of interest to the user.
double	h056_DEPMEN	SACヘッダDEPMENの値。従属変数の平均値。 Value of SAC header DEPMEN. Mean value of dependent variable.
double	h057_CMPAZ	SACヘッダCMPAZの値。成分の方位角(北から時計回り、°単位)。 Value of SAC header CMPAZ. Component azimuth (degrees clockwise from north).
double	h058_CMPINC	SACヘッダCMPINCの値。成分の入射角(鉛直からの角度、°単位)。 Value of SAC header CMPINC. Component incident angle (degrees from vertical).
double	h059_XMINIMUM	SACヘッダXMINIMUMの値。Xの最小値。(スペクトルファイル専用) Value of SAC header XMINIMUM. Minimum value of X. (Spectral files only)
double	h060_XMAXIMUM	SACヘッダXMAXIMUMの値。Xの最大値。(スペクトルファイル専用) Value of SAC header XMAXIMUM. Maximum value of X. (Spectral files only)
double	h061_YMINIMUM	SACヘッダYMINIMUMの値。Yの最小値。(スペクトルファイル専用) Value of SAC header YMINIMUM. Minimum value of Y. (Spectral files only)
double	h062_YMAXIMUM	SACヘッダYMAXIMUMの値。Yの最大値。(スペクトルファイル専用) Value of SAC header YMAXIMUM. Maximum value of Y. (Spectral files only)
double	h063_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
double	h064_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
double	h065_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
double	h066_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
double	h067_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
double	h068_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
double	h069_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
int	h070_NZYEAR	SACヘッダNZYEARの値。ファイルの基準時刻(t=0)のGMT年。 Value of SAC header NZYEAR. GMT year corresponding to reference (zero) time in file.
int	h071_NZJDAY	SACヘッダNZJDAYの値。ファイルの基準時刻(t=0)のGMT julian day。 Value of SAC header NZJDAY. GMT julian day.
int	h072_NZHOUR	SACヘッダNZHOURの値。ファイルの基準時刻(t=0)のGMT時刻。 Value of SAC header NZHOUR. GMT hour.
int	h073_NZMIN	SACヘッダNZMINの値。ファイルの基準時刻(t=0)のGMT分。 Value of SAC header NZMIN. GMT minute.
int	h074_NZSEC	SACヘッダNZSECの値。ファイルの基準時刻(t=0)のGMT秒。 Value of SAC header NZSEC. GMT second.
int	h075_NZMSEC	SACヘッダNZMSECの値。ファイルの基準時刻(t=0)のGMTミリ秒。 Value of SAC header NZMSEC. GMT millisecond.
int	h076_NVHDR	SACヘッダNVHDRの値。ヘッダバージョン番号。現在の値は6。古いバージョンのデータ(NVHDR<6)はSACへの読み込み時に自動的に更新される。[省略不可] Value of SAC header NVHDR. Header version number. Current value is the integer 6. Older version data (NVHDR < 6) are automatically updated when read into SAC. [required]
int	h077_NORID	SACヘッダNORIDの値。 Origin ID (CSS 3.0)。 Value of SAC header NORID. Origin ID (CSS 3.0).
int	h078_NEVID	SACヘッダNEVIDの値。イベントID(CSS 3.0)。 Value of SAC header NEVID. Event ID (CSS 3.0).
int	h079_NPTS	SACヘッダNPTSの値。 1成分あたりのデータサンプル数。[省略不可] Value of SAC header NPTS. Number of points per data component. [required]
int	h080_INTERNAL	SAC内部用ヘッダ(詳細不明)の値。 Value of SAC header internal to SAC and not normally of interest to the user.
int	h081_NWFID	SACヘッダNWFIDの値。波形ID(CSS 3.0)。 Value of SAC header NWFID. Waveform ID (CSS 3.0).
int	h082_NXSIZE	SACヘッダNXSIZEの値。スペクトルの長さ。(スペクトルファイルのみ) Value of SAC header NXSIZE. Spectral length. (spectral files only)
int	h083_NYSIZE	SACヘッダNYSIZEの値。スペクトルの幅。(スペクトルファイルのみ) Value of SAC header NYSIZE. Spectral width. (Spectral files only)
int	h084_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
enum sacheader_enumvalue	h085_IFTYPE	SACヘッダIFTYPEの値。ファイルタイプ。[省略不可] Value of SAC header IFTYPE. Type of file. [required]
enum sacheader_enumvalue	h086_IDEP	SACヘッダIDEPの値。従属変数のタイプ。 Value of SAC header IDEP. Type of dependent variable.
enum sacheader_enumvalue	h087_IZTYPE	SACヘッダIZTYPEの値。基準時刻の選び方。 Value of SAC header IZTYPE. Reference time equivalence.
enum sacheader_enumvalue	h088_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
enum sacheader_enumvalue	h089_IINST	SACヘッダIINSTの値。収録機器のタイプ。[現在は使用されていない] Value of SAC header IINST. Type of recording instrument. [not currently used]
enum sacheader_enumvalue	h090_ISTREG	SACヘッダISTREGの値。観測点の地理上の地域。[現在は使用されていない] Value of SAC header ISTREG. Station geographic region. [not currently used]
enum sacheader_enumvalue	h091_IEVREG	SACヘッダIEVREGの値。イベントの地理上の地域。[現在は使用されていない] Value of SAC header IEVREG. Event geographic region. [not currently used]
enum sacheader_enumvalue	h092_IEVTYP	SACヘッダIEVTYPの値。イベントのタイプ。 Value of SAC header IEVTY. Type of event.
enum sacheader_enumvalue	h093_IQUAL	SACヘッダIQUALの値。データの質。[現在は使用されていない] Value of SAC header IQUAL. Quality of data. [not currently used]
enum sacheader_enumvalue	h094_ISYNTH	SACヘッダISYNTHの値。人工データフラグ。[現在は使用されていない] Value of SAC header ISYNTH. Synthetic data flag. [not currently used]
enum sacheader_enumvalue	h095_IMAGTYP	SACヘッダIMAGTYPの値。マグニチュードの種類。 Value of SAC header IMAGTYP. Magnitude type.
enum sacheader_enumvalue	h096_IMAGSRC	SACヘッダIMAGSRCの値。マグニチュードの情報源。 Value of SAC header IMAGSRC. Source of magnitude information.
enum sacheader_enumvalue	h097_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
enum sacheader_enumvalue	h098_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
enum sacheader_enumvalue	h099_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
enum sacheader_enumvalue	h100_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
enum sacheader_enumvalue	h101_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
enum sacheader_enumvalue	h102_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
enum sacheader_enumvalue	h103_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
enum sacheader_enumvalue	h104_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
unsigned int : 1	h105_LEVEN	SACヘッダLEVENの値。データが等間隔ならTRUE(1)。そうでなければFALSE(0)。 Value of SAC header LEVEN. TRUE (1) if data is evenly spaced. [required]
unsigned int : 1	h106_LPSPOL	SACヘッダLPSPOLの値。観測点の各成分が左手系で正の極性を持つならTRUE(1)。そうでなければFALSE(0)。 Value of SAC header LPSPOL. TRUE (1) if station components have a positive polarity (left-hand rule).
unsigned int : 1	h107_LOVROK	SACヘッダLOVROKの値。ディスク上でこのファイルを上書きして良い場合はTRUE(1)。そうでなければFALSE(0)。 Value of SAC header LOVROK. TRUE (1) if it is okay to overwrite this file on disk.
unsigned int : 1	h108_LCALDA	SACヘッダLCALDAの値。 DIST,AZ, BAZ,GCARCが観測点とイベントの座標から計算可能ならTRUE(1)。そうでなければFALSE(0)。 Value of SAC header LCALDA. TRUE (1) if DIST, AZ, BAZ, and GCARC are to be calculated from station and event coordinates.
unsigned int : 1	h109_UNUSED	現在は使用されていないSACヘッダ。 Value of SAC header not currently being used.
char [9]	h110_KSTNM	SACヘッダKSTNMの値。観測点名。 Value of SAC header KSTNM. Station name.
char [17]	h112_KEVNM	SACヘッダKEVNMの値。イベント名。 Value of SAC header KEVNM. Event name.
char [9]	h116_KHOLE	SACヘッダKHOLEの値。核爆発における穴の同定。 Value of SAC header KHOLE. Hole identification if nuclear event.
char [9]	h118_KO	SACヘッダKOの値。イベント発生時刻の同定。 Value of SAC header KO. Event origin time identification.
char [9]	h120_KA	SACヘッダKAの値。初動走時の同定。 Value of SAC header KA. First arrival time identification.
char [9]	h122_KT0	SACヘッダKT0の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT0. A User defined time pick identification.
char [9]	h124_KT1	SACヘッダKT1の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT1. A User defined time pick identification.
char [9]	h126_KT2	SACヘッダKT2の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT2. A User defined time pick identification.
char [9]	h128_KT3	SACヘッダKT3の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT3. A User defined time pick identification.
char [9]	h130_KT4	SACヘッダKT4の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT4. A User defined time pick identification.
char [9]	h132_KT5	SACヘッダKT5の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT5. A User defined time pick identification.
char [9]	h134_KT6	SACヘッダKT6の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT6. A User defined time pick identification.
char [9]	h136_KT7	SACヘッダKT7の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT7. A User defined time pick identification.
char [9]	h138_KT8	SACヘッダKT8の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT8. A User defined time pick identification.
char [9]	h140_KT9	SACヘッダKT9の値。ユーザ定義のピック時刻の同定。 Value of SAC header KT9. A User defined time pick identification.
char [9]	h142_KF	SACヘッダKFの値。 Finiの同定。 Value of SAC header KF. Fini identification.
char [9]	h144_KUSER0	SACヘッダKUSER0の値。ユーザ定義変数の保存領域。 Value of SAC header KUSER0. User defined variable storage area.
char [9]	h146_KUSER1	SACヘッダKUSER1の値。ユーザ定義変数の保存領域。 Value of SAC header KUSER1. User defined variable storage area.
char [9]	h148_KUSER2	SACヘッダKUSER2の値。ユーザ定義変数の保存領域。 Value of SAC header KUSER2. User defined variable storage area.
char [9]	h150_KCMPNM	SACヘッダKCMPNMの値。成分名。 Value of SAC header KCMPNM. Channel name.
char [9]	h152_KNETWK	SACヘッダKNETWKの値。地震計ネットワーク名。 Value of SAC header KNETWK. Name of seismic network.
char [9]	h154_KDATRD	SACヘッダKDATRDの値。コンピュータにデータを読み込んだ日付。 Value of SAC header KDATRD. Date data was read onto computer.
char [9]	h156_KINST	SACヘッダKINSTの値。収録機器の総称／属名／一般名。 Value of SAC header KINST. Generic name of recording instrument.

◆struct sacheader_number型構造体 (A struct sacheader_number-type structure)

SAC時系列データのヘッダを扱うための構造体である。多数のヘッダがあるので名前で扱う方が良い場合と番号で扱う方が良い場合があり、この構造体では番号で扱う。この構造体は以下のメンバから成る。
A structure to treat the headers of a SAC time series data. As there are many headers, they should be treated either by name or number, depending on situation. This structure treats the headers by number. This structure is composed of the following members.

型 Type	メンバ名 Name of member	メンバの意味 Meaning of member
double	header_float [SACHEADER_FLOAT_NUMBER]	SACのfloat型ヘッダの値を番号順に並べた配列。 An array composed of SAC float-type headers ordered following the header IDs.
int	header_int [SACHEADER_INT_NUMBER]	SACのint型ヘッダの値を番号順に並べた配列。 An array composed of SAC int-type headers ordered following the header IDs.
enum sacheader_enumvalue	header_enum [SACHEADER_ENUM_NUMBER]	SACのenum型ヘッダの値を番号順に並べた配列。 An array composed of SAC enum-type headers ordered following the header IDs.
unsigned int	header_logic : SACHEADER_LOGIC_NUMBER	SACの論理型ヘッダのビットを並べたビットフィールド。注意 : どのようなビット順で配置されるかは処理系依存なので、 0(全ビットとも0)または31(全ビットとも1)のいずれかの値しか設定してはならない。というのもこの構造体は後述のunion sacheader型共用体を用いて struct sacheader_name型構造体とメモリを共有することを想定している。このメンバに0と31以外の値が設定されていると struct sacheader_name型構造体での対応する値が処理系依存になってしまう。 A bit-field composed by SAC logical-type headers expressed by a bit per a header value. NOTE: As the order of the bits depend on system, only 0 (which means that all bits are 0) or 31 (which means that all bits are 1) may be used as this member. This is because the memory of this structure is assumed to be shared with the memory of a struct sacheader_name-type structure through a union sacheader-type union described later. If a value other than 0 and 31 is used to this member, the corresponding value in the struct sacheader_name-type structure depends on the processor.
char	header_str8_1 [SACHEADER_STR8_NUMBER1] [SACHEADER_STR8_LENGTH]	SACの8文字ヘッダのうち、16文字ヘッダよりも前の番号のものを番号順に並べた配列。 An array composed of SAC 8-characters headers which have IDs less than those for 16-characters headers, ordered following the header IDs.
char	header_str16 [SACHEADER_STR16_NUMBER] [SACHEADER_STR16_LENGTH]	SACの16文字ヘッダの値を番号順に並べた配列。 An array composed of SAC 16-characters headers ordered following the header IDs.
char	header_str8_2 [SACHEADER_STR8_NUMBER2] [SACHEADER_STR8_LENGTH]	SACの8文字ヘッダのうち、16文字ヘッダよりも後の番号のものを番号順に並べた配列。 An array composed of SAC 8-characters headers which have IDs greater than those for 16-characters headers, ordered following the header IDs.

◆union sacheader型共用体 (A union sacheader-type union)

SAC時系列データのヘッダを扱うための共用体である。多数のヘッダがあるので名前で扱う方が良い場合と番号で扱う方が良い場合があり、 struct sacheader_name型構造体では名前で扱い、 struct sacheader_number型構造体では番号で扱った。それらをひとまとめにしたのがこの共用体であり、これを用いることで同じヘッダを名前でも番号でも扱うことが可能になる。この共用体は以下のメンバから成る。
A union to treat the headers of a SAC time series data. As there are many headers, they should be treated either by name or number, depending on situation. A struct sacheader_name-type structure treats the headers by name, and a struct sacheader_number-type structure treats the headers by number. This union is composed of these two structures, by which the same headers can be treated by both name and number. This union is composed of the following members.

型 Type	メンバ名 Name of member	メンバの意味 Meaning of member
struct sacheader_name	name	名前で表現したSACヘッダ。 The SAC headers expressed by names.
struct sacheader_number	number	番号で表現したSACヘッダ。 The SAC headers expressed by numbers.

この共用体を用いると同じヘッダを名前でも番号でも参照したり書き換えたりすることが可能になる。例えばヘッダのBの値を0.0にするという操作は名前を用いて行うのが分かりやすく、以下のコードで実行できる。
Using this union, referring and modifying the value of the same header can be done either by name or number. For example, consider to set the value of header B to 0.0. This operation is more comprehensive by using the name, and can be implemented by the sample code below.

union sacheader header;
header.name.h005_B=0.0;

一方、全ての実数値ヘッダの値を一括で0.0にするという操作は番号を用いて行うのがやりやすく、以下のコードで実行できる。
Next, consider to set the values of all the headers of real numbers to 0.0. This operation is more easily be done by the numbers, and can be implemented by the sample code below.

union sacheader header;
int i;
for(i=0;i<SACHEADER_FLOAT_NUMBER;i++){
header.number.header_float[i]=0.0;
}

複数のメンバで同じメモリを共有するという共用体の性質上、このコードを実行すると名前で表現したヘッダの方も自動的に書き換わる。すなわち
header.name.h000_DELTA=0.0;
header.name.h001_DEPMIN=0.0;
header.name.h002_DEPMAX=0.0;
…
header.name.h069_UNUSED=0.0;
としたのと同じである。
Owing to the nature of the union that the same memory is shared by the members, applying the code above results in changes of the name-based headers also. That is, the code above is equivalent to:
header.name.h000_DELTA=0.0;
header.name.h001_DEPMIN=0.0;
header.name.h002_DEPMAX=0.0;
…
header.name.h069_UNUSED=0.0;

◆struct sac_timeseq型構造体 (A struct sac_timeseq-type structure)

SAC時系列データを扱うための構造体である。以下のメンバから成る。
A structure to treat a SAC time series data. This structure is composed of the following members.

型 Type	メンバ名 Name of member	メンバの意味 Meaning of member
union sacheader	header	SACヘッダ。 The SAC headers.
struct sequence	data	時系列データ。 The time series data.

◆struct sac_specRI型構造体 (A struct sac_specRI-type structure)

実部と虚部を持つSAC複素数時系列データを扱うための構造体である。以下のメンバから成る。
A structure to treat a SAC time series data of complex values composed of real and imaginary parts. This structure is composed of the following members.

型 Type	メンバ名 Name of member	メンバの意味 Meaning of member
union sacheader	header	SACヘッダ。 The SAC headers.
struct imsequence	data	複素数の時系列データ。 The time series data of complex numbers.