sacfile_3valuesコマンドマニュアル

(The documentation of sacfile_3values command)

Last Update: 2022/4/27

◆機能・用途(Purpose)

SAC時系列データファイルを読み込んで正の値を$+1.0$に、0に非常に近い値を$0.0$に、負の値を$-1.0$に置き換える(3値化)。
Read a SAC time series data file and replace positive and negative values with $+1.0$ and $-1.0$, respectively, while values proximal to $0.0$ are replaced by $0.0$ (normalization to 3 values).

sacfile_1bitコマンドでは$0.0$も$+1.0$に置き換えられるので、 $0.0$を多く含むデータでは結果が正の側に偏ったものになってしまう。それに対し、このプログラムでは$0.0$は$0.0$として残すのでこのようなアンバランスが起きにくい。
In sacfile_1bit command, $0.0$ is replaced by $+1.0$, resulting in an unbalanced data to positive side if the original data consists of many samples of $0.0$. In contrast, this program preserves $0.0$ to suppress the unbalance.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/sac_data/src/sacfile_3values.c

◆使用方法(Usage)

コマンドライン引数でパラメータを指定する。パラメータの一覧を下表に示す。
Specify parameters by command-line arguments. The table below shows a list of parameters.

●「-」から始まらない引数 (Arguments not beginning with “-”)

引数 Argument	与える値 Quantity to be given
第1引数 1st argument	入力SACデータファイル名。 The input SAC data file name.
第2引数 2nd argument	出力するSACファイル名(3値化した時系列データの出力先)。第1引数と同じ名前を指定した場合は上書きされる。 Name of the output SAC file into which the 3-value time series data will be written. If the same name as the 1st argument is specified, the input file will be overwritten.

●1つの「-」から始まる引数 (Arguments beginning with a single “-”)

このコマンドでは1つの「-」から始まる引数は存在しない。
This command does not have arguments beginning with a single “-”.

●「--パラメータ名=パラメータ値」の形式の引数 (Arguments of a form “--Parameter name=Parameter Value”)

このコマンドでは「--パラメータ名=パラメータ値」の形式の引数存在しない。
This command does not have arguments of a form “--Parameter name=Parameter Value”.

◆動作(Behaviour)

第1引数で指定したSAC時系列データファイルを読み込んで以下の置き換えを行い、第2引数で指定したファイルにSAC形式で出力する。
Read the SAC time series data specified by the 1st argument, perform the replacements below, and output the results as SAC format to the file specified by the 2nd argument.

入力SACデータにおいて全てのデータサンプルの値が厳密に$0.0$の場合、出力ファイルにおいても全てのサンプルの値が$0.0$になる。
If all data samples of the input SAC data are exactly $0.0$, all samples in the output data are also $0.0$.
上記以外の場合、絶対値最大値の ZERO_THRESHOLD 倍よりも$0.0$に近いデータサンプルは$0.0$に置き換えられ、その他のサンプルは符号に応じて$+1.0$または$-1.0$に置き換えられる。
In other cases, data samples that are closer to $0.0$ than ZERO_THRESHOLD times the absolute maximum are replaced by $0.0$, and the other samples are replaced by $+1.0$ or $-1.0$ depending on the sign of the data.

◆使用例(Example)

sacfile_3values original.sac 3values.sac

sacfile_3valuesコマンド マニュアル