sacfile_interpolateコマンド マニュアル

(The documentation of sacfile_interpolate command)
Last Update: 2024/7/25

◆機能・用途(Purpose)

SAC時系列データの補間を行う。
Interpolate a SAC time series data.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/sac_data/src/sacfile_interpolate.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データファイル名。
Name of the output SAC data file into which the interpolated time series data will be written.


●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
new_dt 補間後の新しいサンプリング間隔(s)。
The new sampling interval (s) after the interpolation. 		正の実数。
A positive real number. 		省略不可
Cannot be omitted
new_refDateTime 補間後のデータの基準日時。
The reference date and time of the interpolated data. 		年・月・日・時・分・秒をカンマ(,)で区切って並べた文字列。 秒は実数で与えることができる(但し、小数点以下3桁までとする)。 月・日・時・分・秒の整数部分は1桁の場合は頭に0を付けても付けなくても良い。
A string composed of the year, month, day, hour, minute, and second separated by commas (,). The second can be a real number with at maximum three digits in the decimal part. If the month, day, hour, minute, or the integer part of the second is one digit, it is arbitrary to append 0 or not at the head. 		省略時は基準日時を変更しない。
The reference date and time is not changed if this parameter is omitted.


◆動作(Behaviour)

第1引数で指定したSACファイルを読み込み、 サンプリング間隔がパラメータnew_dtで指定した値になるように、 かつ引数new_refDateTimeで指定した日時(またはそれにnew_dtの整数倍を加えた日時) がサンプル時刻になるように補間した上で 第2引数で指定したSACファイルに出力する。 補間方法は線形補間とし、 関数sequence_change_sampling_interval を用いる。
Read the SAC file specified by the 1st argument, interpolate the data to a sampling interval specified by parameter new_dt, and output the result into the SAC file specified by the 2nd argument. If the parameter new_refDateTime is specified, the output data are sampled at times that are the multiples of new_dt from the date and time specified by parameter new_refDateTime. The interpolation method is a linear interpolation; function sequence_change_sampling_interval is used.

◆使用例(Example)

sacfile_interpolate data_100Hz_sampling.sac data_200Hz_sampling.sac --new_dt=0.005 --new_refDateTime=2024,7,25,0,0,0.0