The documentation of “sac/macro.h”

sac/macro.h マニュアル

(The documentation of sac/macro.h)

Last Update: 2021/12/9

sac/macro.hでは sacヘッダファイルパッケージで主に用いるマクロが定義されている。各マクロの定義を以下に示す。
Macros mainly used in sac header file package are defined in sac/macro.h. Definitions of individual macros are shown below.

◆共通事項 (Notes common to all macros)

C言語組み込みヘッダファイル内に同名のマクロが存在する場合であっても ymaeda_opentoolsのマクロ定義が優先される。そのために#undefしてから#defineするようにしている。
The definitions of macros in ymaeda_opentools are used with a higher priority than macros with the same name in built-in header files of the C language. To realize this, each macro is defined after canceling existing definitions by #undef.
特定のプログラムにおいてmacro.hの設定と異なるマクロの値を使用したい場合、 inc.hのインクルードよりも前に
    #define USER_DEFINED_マクロ名
    #define マクロ名値
と書く。例えば特定のプログラムにおいてマクロZERO_THRESHOLDの値を1.0e-06にしたい場合、
    #define USER_DEFINED_ZERO_THRESHOLD
    #define ZERO_THRESHOLD 1.0e-06
    #include <inc.h>
のように書けば良い。
To use the value of a macro different from that in macro.h in a certain program, write as
    #define USER_DEFINED_macro name
    #define macro name value
before including inc.h. For example, to use 1.0e-06 for a macro ZERO_THRESHOLD in a certain program, write as
    #define USER_DEFINED_ZERO_THRESHOLD
    #define ZERO_THRESHOLD 1.0e-06
    #include <inc.h>
at the head of the program.

マクロ名(Macro name):
SACHEADER_UNDEFINED_FLOAT

値(Value):
-12345.0

Seismic Analysis Code (SAC)の時系列データファイルにおいて未定義であることを表すfloat型ヘッダの値。
The value for float-type headers to indicate that the header value is undefined in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_UNDEFINED_INT

値(Value):
-12345

Seismic Analysis Code (SAC)の時系列データファイルにおいて未定義であることを表すint型ヘッダの値。
The value for int-type headers to indicate that the header value is undefined in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_UNDEFINED_ENUM

値(Value):
-12345

Seismic Analysis Code (SAC)の時系列データファイルにおいて未定義であることを表すenum型ヘッダの値。
The value for enum-type headers to indicate that the header value is undefined in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_UNDEFINED_STR8

値(Value):
"-12345 [SPC][SPC] "

Seismic Analysis Code (SAC)の時系列データファイルにおいて未定義であることを表す文字列(8文字)ヘッダの値。ここで[SPC]は半角空白を表す。
The value for string (8-characters) headers to indicate that the header value is undefined in a time series data file of Seismic Analysis Code (SAC). Here, [SPC] indicates a space.

マクロ名(Macro name):
SACHEADER_UNDEFINED_STR16

値(Value):
"-12345 [SPC][SPC][SPC][SPC][SPC][SPC][SPC][SPC][SPC][SPC] "

Seismic Analysis Code (SAC)の時系列データファイルにおいて未定義であることを表す文字列(16文字)ヘッダの値。ここで[SPC]は半角空白を表す。
The value for string (16-characters) headers to indicate that the header value is undefined in a time series data file of Seismic Analysis Code (SAC). Here, [SPC] indicates a space.

マクロ名(Macro name):
SACHEADER_FLOAT_NUMBER

値(Value):
70

Seismic Analysis Code (SAC)の時系列データファイルにおける float型ヘッダの個数。
The number of float-type headers in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_INT_NUMBER

値(Value):
15

Seismic Analysis Code (SAC)の時系列データファイルにおける int型ヘッダの個数。
The number of int-type headers in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_ENUM_NUMBER

値(Value):
20

Seismic Analysis Code (SAC)の時系列データファイルにおける enum型ヘッダの個数。
The number of enum-type headers in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_LOGIC_NUMBER

値(Value):
5

Seismic Analysis Code (SAC)の時系列データファイルにおける論理型ヘッダの個数。
The number of logical type headers in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_STR8_NUMBER1

値(Value):
1

Seismic Analysis Code (SAC)の時系列データファイルにおいて 16文字ヘッダよりも前に登場する8文字ヘッダの個数。
The number of 8-character string headers that appear before 16-character ones in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_STR16_NUMBER

値(Value):
1

Seismic Analysis Code (SAC)の時系列データファイルにおける 16文字ヘッダの個数。
The number of 16-character string headers in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_STR8_NUMBER2

値(Value):
21

Seismic Analysis Code (SAC)の時系列データファイルにおいて 16文字ヘッダよりも後に登場する8文字ヘッダの個数。
The number of 8-character string headers that appear after 16-character ones in a time series data file of Seismic Analysis Code (SAC).

マクロ名(Macro name):
SACHEADER_STR8_LENGTH

値(Value):
9

Seismic Analysis Code (SAC)の時系列データファイルから 8文字ヘッダを読み込むためのchar型配列の長さ(末尾の\0を含む)。
The length of a char-type array to which a 8-character string header is read from a time series data file of Seismic Analysis Code (SAC); \0 at the end is included in the count.

マクロ名(Macro name):
SACHEADER_STR16_LENGTH

値(Value):
17

Seismic Analysis Code (SAC)の時系列データファイルから 16文字ヘッダを読み込むためのchar型配列の長さ(末尾の\0を含む)。
The length of a char-type array to which a 16-character string header is read from a time series data file of Seismic Analysis Code (SAC); \0 at the end is included in the count.

マクロ名(Macro name):
SACHEADER_VERSION

値(Value):
6

Seismic Analysis Code (SAC)の時系列データファイルにおいて想定するヘッダのバージョン。
The version of headers assumed for time series data files of Seismic Analysis Code (SAC).