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.



◆使用例(Example)

sacfile_3values original.sac 3values.sac