sacfile_decimateコマンド マニュアル

(The documentation of sacfile_decimate command)
Last Update: 2022/7/26

◆機能・用途(Purpose)

SAC時系列データのサンプル間隔を間引く。
Resample the samples of a SAC time series data.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/sac_data/src/sacfile_decimate.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 resampled 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 resampling. 		入力SACデータにおけるサンプリング間隔の整数倍となる正の実数。
A positive real number that is an integer multiple of the sampling interval of the input SAC data. 		省略不可
Cannot be omitted


◆動作(Behaviour)

第1引数で指定したSACファイルを読み込み、 サンプリング間隔がパラメータnew_dtで指定した値になるように間引いた上で 第2引数で指定したSACファイルに出力する。 先頭時刻は変えず、フィルタリングや補間も行わずに 単純な間引きのみを行う。
Read the SAC file specified by the 1st argument, resample the data to a sampling interval specified by parameter new_dt, and output the result into the SAC file specified by the 2nd argument. The beginning time of the data is kept unchanged, and the data samples are simply reduced without filtering nor interpolation.

◆使用例(Example)

sacfile_decimate NU.NKY.U.sac NU.NKY.U.10Hz.sac --new_dt=0.1


◆使用上の注意(Note)

このコマンドではアンチエイリアスフィルターは使用せずに 単純なサンプルの間引きのみを行う。 必要であればこのコマンドの前にフィルタリングを行うこと。
An anti-alias filter is not applied by this command; data samples are simply reduced. If necessary, apply the filter separately before executing this command.