Definition of “imseq2” format

imseq2形式ファイル仕様

(Definition of “imseq2” format)

Last Update: 2021/6/28

拡張子(Extension)
imseq2

拡張子の意味 (Meaning of the extension)
「im」は虚数(正確には複素数)、「seq」はsequence(系列)を表し、「2」は時系列データのseq2に対応させている。
“im” means an imaginary number (more precisely, a complex number), “seq” represents a sequence, and “2” is used to be consistent with seq2 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)
ヘッダ(データサンプル数、周波数の最小値、周波数刻み)と各サンプルの周波数およびデータの値を書いたテキストファイルである。スペクトルのプロットが容易で、周波数と値の対応関係も分かりやすいのが長所である。反面、ファイルサイズは大きくなる。
A text file composed of headers (the number of data samples, the minimum value of frequencies, and frequency interval) followed by the frequency and data value of each sample. Data written in this format can easily be plotted as a spectrum, and it is easy to relate the frequency and value of each sample. A shortage is that the file size is large.

仕様詳細(Detail)

第1行 : 「size=データサンプル数」の文字列。
Line 1 : A string “size=the number of data samples”.
第2行 : 「t0=周波数の最小値」の文字列。
Line 2 : A string “t0=the minimum value of frequencies”.
第3行 : 「dt=周波数刻み」の文字列。
Line 3 : A string “dt=the frequency interval”.
第4行 : 空行。
Line 4 : An empty line.
第5行以降 : 各サンプルの周波数と値(周波数順)。第1列に周波数、第2列に実部、第3列に虚部の値が書かれている。
Lines 5 and later : The frequency and value of each sample (in the frequency order). The frequency is written in the 1st column, and real and imaginary parts are in the 2nd and 3rd columns, respectively.
各行における列の区切り文字としてはタブを使用する。
Tabs are used to separate the columns in each line.

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

周波数 Frequency	実部 Real part	虚部 Imaginary part
1.1	12.3	3.21
1.2	4.56	-65.4
1.3	-78.9	-9.87
1.4	0.12	21.0
1.5	34.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

1.1[TAB]12.3[TAB]3.21
1.2[TAB]4.56[TAB]-65.4
1.3[TAB]-78.9[TAB]-9.87
1.4[TAB]0.12[TAB]21.0
1.5[TAB]34.5[TAB]-5.43

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

imseq2形式 ファイル仕様

imseq2形式ファイル仕様