sequencefile_fftコマンド マニュアル

(The documentation of sequencefile_fft command)
Last Update: 2023/6/27

◆機能・用途(Purpose)

時系列データをファイルから読み込んでフーリエ変換を行う。
Read a time series data from a file and perform a Fourier transformation.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/sequence/src/sequencefile_fft.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 		読み込む時系列データのファイル名。 拡張子は ymaeda_opentools独自の時系列データファイル形式 のいずれかでなければならない。
The name of the file for the input time series data. The extension must be one of the special file formats of ymaeda_opentools for time series data.
第2引数
2nd argument 		出力するフーリエスペクトルのファイル名。 拡張子は ymaeda_opentools独自のスペクトルファイル形式 のいずれかでなければならない。
The name of the file for the output Fourier spectrum. The extension must be one of the special file formats of ymaeda_opentools for Fourier spectrum.


●1つの「-」から始まる引数 (Arguments beginning with a single “-”)

1つの「-」から始まる引数は自由な順番で指定できる。 「-」から始まらない引数の間に挿入しても良い。 相反する指定がなされた場合には後の指定が優先される。
Arguments beginning with a single “-” 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.
引数
Argument 		動作
Behaviour
-o 下記「--overwrite=yes」と同じ。
Same as “--overwrite=yes” below.
-e 下記「--erase_old_file=yes」と同じ。
Same as “--erase_old_file=yes” below.


●「--パラメータ名=パラメータ値」の形式の引数 (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
overwrite 変換後のファイル(出力ファイル)と同名のファイルが既に存在する場合に 確認無しで上書きするか否か。
Whether to overwrite an existing file without warning or not if a file with the name same as the converted (output) file already exists.
  • yes
    確認無しで上書きする。
    Overwrite without warning.

  • no
    上書きしても良いかユーザに確認する。
    Consult the user whether to proceed (overwrite) or not.

 no
erase_old_file 変換前のファイル(入力ファイル)を削除するか否か。
Whether to remove the input file used for the conversion or not.
  • yes
    削除する。
    Remove.

  • no
    削除しない。
    Do not remove.

 no
size フーリエ変換に実際に用いる時系列データの時刻サンプル数。 第1引数で指定したファイルの時系列データをそのまま用いるのではなく、 末尾にダミーの0を追加して 時刻サンプル数をこのパラメータで与えた値にしてから フーリエ変換を行う。
The number of time samples of time series data that is actually used for the Fourier transformation. Dummy zeroes are added at the end of the input time series data to make the number of time samples equal to the value given by this parameter before Fourier transformation. 		第1引数で指定したファイルの時系列データの時刻サンプル数\(N\)以上かつ 2の巾乗となる正の整数。
A positive integer that is a power of 2 and greater than or equal to the number of time samples (\(N\)) of the time series data in the file specified by the 1st argument. 		\(N\)以上の最小の2の巾乗。
The minimum power of 2 greater than or equal to \(N\).


◆動作(Behaviour)

第1引数で指定した時系列データファイルを読み込み、 フーリエ変換を行い、 結果を第2引数で指定したファイルに出力する。
Read the time series data file specified by the 1st argument, perform the Fourier transformation, and output the result into the file specified by the 2nd argument.

◆使用例(Example)

sequencefile_fft waveform.seq1 spectrum.imseq1