imseq1形式 ファイル仕様

(Definition of “imseq1” format)

Last Update: 2021/6/28



拡張子(Extension)
imseq1


拡張子の意味 (Meaning of the extension)
「im」は虚数(正確には複素数)、「seq」はsequence(系列)を表し、 「1」は時系列データのseq1に対応させている。
“im” means an imaginary number (more precisely, a complex number), “seq” represents a sequence, and “1” is used to be consistent with seq1 for time series data.


対象とするデータと構造体 (Supported data and structures)
スペクトル(struct imsequence型またはstruct imsequence2型)
A spectrum given by struct imsequence-type or struct imsequence2-type.


データの保存形式 (Format of each data)
有効数字6桁の浮動小数点指数形式(%.6e)
Floating-point numbers in exponential formats with 6 decimals (%.6e)


特徴(Features)
ヘッダ(データサンプル数、周波数の最小値、周波数刻み)と 各サンプルのデータの値のみを書いたテキストファイルである。 imseq2と比べて各サンプルの周波数を省いてある分だけファイルサイズが小さい。 反面、ファイルをそのままスペクトルとしてプロットできず、 値と周波数の対応付けにも手間がかかる。
A text file composed of headers (the number of data samples, the minimum value of frequencies, and frequency interval) followed by the data value of each sample. The file size is smaller than that of imseq2, as the frequency of each sample is omitted. As a result, the data can not directly be plotted as a spectrum, and relating the frequency and value of each sample is not straightforward.


仕様詳細(Detail)


(Example)
以下のスペクトルを考える。
Let us consider the spectrum below:

周波数
Frequency
実部
Real part
虚部
Imaginary part
1.112.33.21
1.24.56-65.4
1.3-78.9-9.87
1.40.1221.0
1.534.5-5.43

このスペクトルを表現するためのファイルの中身は以下のようになる。 ここではタブを分かりやすいように [TAB]で表す。
The file to represent this time series data is as below, where tabs are shown by [TAB].

size=5
t0=1.1
dt=0.1

12.3[TAB]3.21
4.56[TAB]-65.4
-78.9[TAB]-9.87
0.12[TAB]21.0
34.5[TAB]-5.43


補足(Additional remarks)
t0, dtはf0, dfの誤植ではない。 マニュアルでは分かりやすさのために「時系列データ」「スペクトル」と呼んでいるが、 厳密にはseq1形式は任意の1変数実関数、 imseq1形式は任意の1変数複素関数と捉えるべきである。 seq1とimseq1では実関数と複素関数の違いを除いて相違は無く、 そのため両者を出来る限り共通の扱いにしている。 例えば複素数値の時系列データにはimseq1形式を用いる。
t0 and dt are not typo of f0 and df. Although “time series data” and “spectrum” are used in the documentation for simplicity, more strictly seq1 format represents arbitrary real functions of 1 dimension, and imseq1 does arbitrary complex functions of 1 dimension. Only the difference between seq1 and imseq1 is the real and complex functions, so that they are treated in the same manner as long as possible. For example, imseq1 format is used for time series data of complex values.