sac_timeseq2sequenceコマンド マニュアル

(The documentation of sac_timeseq2sequence command)
Last Update: 2024/1/4

◆機能・用途(Purpose)

等間隔サンプリングのSAC時系列データファイルを ymaeda_opentools独自の時系列データファイル形式 に変換する。 オプションでデータの一部切り出し、時間軸の移動や伸縮、振幅の規格化もできる。
Convert an evenly sampled SAC time series data file to a special file format of ymaeda_opentools for time series data. Optionally, partial data can be extracted, the time axis can be moved, extended or compressed, and the amplitudes can be normalized.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/sac_data/src/sac_timeseq2sequence.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 time series data file name.
第2引数
2nd argument 		出力する時系列データファイル名。 拡張子は ymaeda_opentools独自の時系列データファイル形式 のいずれかにしなければならない。
The output time series data file name. The extension must be one of the special file formats of ymaeda_opentools for time series data.


●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
tmin_input 変換時に切り出す時間窓の先頭時刻(s)。
The start time (s) of the time window to extract in the conversion. 		SAC時系列データの定義域内の時刻に対応する実数。
A real number corresponding to a time in the definition range of the SAC time series data. 		SAC時系列データの先頭時刻。
The beginning time of the SAC time series data.
tmax_input 変換時に切り出す時間窓の末尾時刻(s)。
The end time (s) of the time window to extract in the conversion. 		SAC時系列データの定義域内の時刻に対応する実数。 tmin_inputよりも大きくなければならない。
A real number corresponding to a time in the definition range of the SAC time series data greater than the value of parameter tmin_input. 		SAC時系列データの末尾時刻。
The end time of the SAC time series data.
tmin_output 出力する時系列データにおける、tmin_inputに対応する時刻(s)。 変換時に時刻をずらしたり伸縮することを想定したパラメータであり、 入力SAC時系列データにおいて tmin_inputからtmin_outputまでであった時間軸を tmin_outputからtmax_outputまでに変換する。
Time (s) in the output time series data corresponding to tmin_input. This parameter is assumed to be used to shift, extend or compress the time axis during the conversion; the time window of the input SAC time series data (from tmin_input to tmax_input) is converted as from tmin_output to tmax_output. 		実数。
A real number. 		tmin_input
tmax_output 出力する時系列データにおける、tmax_inputに対応する時刻(s)。 パラメータtmin_outputの説明参照。
Time (s) in the output time series data corresponding to tmax_input; see the description of parameter tmin_output. 		tmin_outputよりも大きな実数。
A real number greater than tmin_output. 		tmax_output
tinc_output 出力する時系列データにおけるサンプリング間隔(s)。
The sampling interval (s) of the output time series data. 		正の実数。
A positive real number. 		入力時系列データとサンプル数が等しくなるサンプリング間隔。
The sampling interval that does not change the number of samples.
amp_min_output 出力時系列データにおける振幅の最小値。 振幅範囲がamp_min_outputからamp_max_outputまでになるように 規格化して出力する。
The minimum amplitude of the output time series data; the original data is normalized as from amp_min_output to amp_max_output. 		実数。
A real number. 		入力時系列データにおける振幅の最小値(規格化無し)。
The minimum amplitude of the input time series data (no normalization).
amp_max_output 出力時系列データにおける振幅の最大値。 振幅範囲がamp_min_outputからamp_max_outputまでになるように 規格化して出力する。
The maximum amplitude of the output time series data; the original data is normalized as from amp_min_output to amp_max_output. 		amp_min_outputよりも大きな実数。
A real number greater than amp_min_output. 		入力時系列データにおける振幅の最大値(規格化無し)。
The maximum amplitude of the input time series data (no normalization).


◆動作(Behaviour)

第1引数で指定したSAC時系列データファイルを読み込んで 第2引数で指定したファイルに出力する。
Read the SAC time series data file specified by the 1st argument and output to the file specified by the 2nd argument.

◆使用例(Example)

●例1(Example 1)

sac_timeseq2sequence sample1.sac sample1.seq2
この例ではファイルsample1.sacに格納されているSAC時系列データを 単純にseq2形式に変換してファイルsample1.seq2に出力する。
This example simply converts the SAC time series data in a file sacmple1.sac to the seq2 format and outputs the result into a file sample1.seq2.

●例2(Example 2)

sac_timeseq2sequence sample2.sac sample2.seq2 --tmin_input=100.0 --tmax_input=200.0 --tmin_output=0.0 --tmax_output=1.0 --tinc_output=0.05 --amp_min_output=-1.0 --amp_max_output=1.0
 この例ではsample2.sacに格納されているSAC時系列データから [100 s, 200 s]の時間窓を切り出し、 [0 s, 1 s]になるように時間軸を移動・圧縮した上で0.05 s刻みでリサンプルし、 振幅範囲が[-1, 1]になるように規格化して seq2形式でファイルsample2.seq2に出力する。
This example extracts the data in a [100 s, 200 s] window from a SAC time series data in a file sample2.sac, moves and compresses the time axis into [0 s, 1 s], resamples the data at 0.05 s intervals, normalizes the amplitudes to [-1, 1], and output the results in the seq2 format into a file sample2.seq2.

◆補足(Additional notes)

パラメータtinc_outputを指定した場合、時系列データのサンプリング間隔の変更には 関数sequence_change_sampling_interval が用いられる。
When parameter tinc_output is specified, the time series data is resampled using function sequence_change_sampling_interval.