sacfile_best_correlationコマンド マニュアル

(The documentation of sacfile_best_correlation command)
Last Update: 2022/8/9

◆機能・用途(Purpose)

2つのSAC時系列データの相互相関関数の値を最大にするラグタイムを計算する。
Compute the lag time at which the cross correlation function (CCF) between two SAC time series data takes the maximum value.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/sac_data/src/sacfile_best_correlation.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 		相互相関関数の計算に用いる 1つ目のSAC時系列データのファイル名。
The file name of the 1st SAC time series data used for the computation of the CCF.
第2引数
2nd argument 		相互相関関数の計算に用いる 2つ目のSAC時系列データのファイル名。
The file name of the 2nd SAC time series data used for the computation of the CCF.


●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引数で指定したファイルから読み込んだ時系列データを\(f(t)\)、 第2引数で指定したファイルから読み込んだ時系列データを\(g(t)\)とし、 相互相関関数\(C_1(f,g;\tau)\) ( sequence/correlation.hのマニュアル参照) を計算する。 \(C_1\)を最大にする\(\tau\)とそのときの\(C_1\)の値を タブ区切りで標準出力に書き出す。 ラグタイム\(\tau\)の定義に当たっては絶対日時は参照せず、 2つのSACデータの基準時刻が等しいものとして計算を行う。
Compute the CCF \(C_1(f,g;\tau)\) (see the documentation of sequence/correlation.h), where \(f(t)\) and \(g(t)\) are the time series data read from files specified by the 1st and 2nd arguments, respectively. Output the values of \(\tau\) and \(C_1\), corresponding to the maximum value of \(C_1\), to the standard output; \(\tau\) and \(C_1\) are separated by a tab. In the definition of the lag time \(\tau\), absolute dates and times are not used; instead, the reference times of the two SAC data are assumed to be equal.

◆使用例(Example)

sacfile_best_correlation data1.sac data2.sac