stack_cross_spectrum_multi_resultsコマンド マニュアル

(The documentation of stack_cross_spectrum_multi_results command)
Last Update: 2023/9/25

◆機能・用途(Purpose)

cross_spectrum_multiコマンド から出力された異なる期間のクロススペクトルをスタッキングする。
Stack the cross spectra of different time periods produced by cross_spectrum_multi command.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/structural_survey/src/ stack_cross_spectrum_multi_results.c


◆使用方法(Usage)

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

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

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

●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”)

「--パラメータ名=パラメータ値」の形式の引数は自由な順番で指定できる。 「-」から始まらない引数の間に挿入しても良い。 相反する指定がなされた場合には後の指定が優先される。 デフォルト値を持つパラメータは省略できる。
Arguments of a form “--Parameter name=Parameter Value” can be placed in an arbitrary order. They can even be inserted between arguments not beginning with “-”. In case of conflicting options being specified, the latter option has a higher priority. Parameters that have default values can be omitted.
パラメータ名
Parameter name 		意味
Meaning 		可能なパラメータ値
Allowed parameter values 		デフォルト値
Default value
inputdirs クロススペクトルが格納されているディレクトリパスのリスト。 個々のディレクトリは cross_spectrum_multiコマンド から出力されたもの、もしくはそれと完全に同一の 構成およびファイル書式でなければならない。
A list of directory paths in which the cross spectra are stored. Each directory must have been created by cross_spectrum_multi command or must have exactly the same structure and file formats as what would have been created by that command. 		ディレクトリパスをカンマ(,)で区切って並べた文字列。
A string composed of the directory paths separated by commas (,). 		省略不可
Cannot be omitted
extension 個々のクロススペクトルファイルの書式(拡張子)。
The extension for individual cross spectral files. 		ymaeda_opentoolsのスペクトルファイル形式のいずれかに対応する拡張子 (独自のファイル形式参照)。 全てのディレクトリで共通でなければならない。
One of the extensions for the spectral file formats of ymaeda_opentools; see special file formats. The extension must be same over all directories. 		bimseq
outputdir 出力ディレクトリ。
The output directory. 		ディレクトリパスを表す文字列。
A string that represents a directory path. 		省略不可
Cannot be omitted


◆動作(Behaviour)

パラメータinputdirsで指定した各ディレクトリからクロススペクトルを読み込み、 それらを同じ観測点・成分ペアについてスタッキングした結果を パラメータoutputdirで指定したディレクトリに出力する。 出力ディレクトリのファイル構成と書式は cross_spectrum_multiコマンド の出力と同じである。
Read the cross spectra from each directory specified by parameter inputdirs, stack them for the same station-component pairs, and output the results into the directory specified by parameter outputdir. The structure and file formats are identical to those from the cross_spectrum_multi command.

◆使用例(Example)

cross_spectrum_multi --inputfiles=structural_survey/data/%YYYY/%YY%MM%DD%hh/%STATION.%COMPONENT.sac --trace_list_file=structural_survey/etc/traces.dat --start=2019-01-01.00-00-00 --end=2019-12-31.23-59-59 --outputdir=structural_survey/result2019

cross_spectrum_multi --inputfiles=structural_survey/data/%YYYY/%YY%MM%DD%hh/%STATION.%COMPONENT.sac --trace_list_file=structural_survey/etc/traces.dat --start=2020-01-01.00-00-00 --end=2020-12-31.23-59-59 --outputdir=structural_survey/result2020

cross_spectrum_multi --inputfiles=structural_survey/data/%YYYY/%YY%MM%DD%hh/%STATION.%COMPONENT.sac --trace_list_file=structural_survey/etc/traces.dat --start=2021-01-01.00-00-00 --end=2021-12-31.23-59-59 --outputdir=structural_survey/result2021

cross_spectrum_multi --inputfiles=structural_survey/data/%YYYY/%YY%MM%DD%hh/%STATION.%COMPONENT.sac --trace_list_file=structural_survey/etc/traces.dat --start=2022-01-01.00-00-00 --end=2022-12-31.23-59-59 --outputdir=structural_survey/result2022

stack_cross_spectrum_multi_results --inputdirs=structural_survey/result2019,structural_survey/result2020,structural_survey/result2021,structural_survey/result2022 --outputdir=structural_survey/result_stack2019-2022

この例ではcross_spectrum_multiコマンドを使って 2019年、2020年、2021年、2022年の各1年分のデータからクロススペクトルを計算後、 それらの結果をstack_cross_spectrum_multi_resultsコマンドにより 4年分スタッキングする。
In this example, each annual cross spectra for 2019, 2020, 2021, and 2022 are first computed separately using the cross_spectrum_multi command, and then these cross spectra are stacked over the four years using the stack_cross_spectrum_multi_results command.