Definition of “aseq2” format

aseq2形式ファイル仕様

(Definition of “aseq2” format)

Last Update: 2021/6/28

拡張子(Extension)
aseq2

拡張子の意味 (Meaning of the extension)
「a」はabsolute time(絶対時刻)、「seq」はsequence(時系列)、「2」はデータを2列で記載するという意味。
“a” means an absolute time, “seq” represents a sequence (i.e., a time series), and “2” means that the data are written in 2 columns.

対象とするデータと構造体 (Supported data and structures)
時系列データ(struct sequence型)
A time series data given by struct sequence-type

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

特徴(Features)
seq2とほぼ同じだが先頭時刻を絶対日時で与える。なお ymaeda_opentoolsにおいて時系列データの絶対日時を扱えるようにしたのはごく最近であり、過去に作成したほとんどの関数が絶対日時非対応のため、それらの関数を用いると絶対日時の情報が失われる可能性が高い点に留意。
Almost same as seq2, except that the start time is given by an absolute date and time. Note that ymaeda_opentools supported absolute date and time in the treatment of time series data very recently, meaning that most functions created previously do not support the absolute date and time which could thus be lost by calling these functions.

仕様詳細(Detail)

第1行 : 「size=データサンプル数」の文字列。
Line 1 : A string “size=the number of data samples”.
第2行 : 「start=YYYY/MM/DD hh:mm:ss.sss」の文字列。ここでYYYYは年(4桁)、 MMは月(2桁)、 DDは日(2桁)、 hhは時(2桁)、 mmは分(2桁)、 ss.sssは秒(整数部2桁+小数点以下3桁)を表す。
Line 2 : A string “start=YYYY/MM/DD hh:mm:ss.sss”, where YYYY is the year (4-digits), MM is the month (2-digits), DD is the day (2-digits), hh is the hour (2-digits), mm is the minute (2-digits), and ss.sss is the second (2-digits for the integer part and 3-digits for the decimal part).
第3行 : 「dt=時間刻み」の文字列。
Line 3 : A string “dt=the sampling interval”.
第4行 : 空行。
Line 4 : An empty line.
第5行以降 : 各サンプルの時刻(第1列)と値(第2列)(時刻順)。時刻は先頭からの秒数で与える。
Lines 5 and later : The time and value of each sample (in the time order), written in the 1st and 2nd columns, respectively, where the time is given by seconds from the start of the data.
各行における列の区切り文字としてはタブを使用する。
Tabs are used to separate the columns in each line.

例(Example)
以下の時系列データを考える。
Let us consider the time series data below:

時刻 Time	値 Value
2020/01/01 12:34:56.1	12.3
2020/01/01 12:34:56.2	4.56
2020/01/01 12:34:56.3	-78.9
2020/01/01 12:34:56.4	0.12
2020/01/01 12:34:56.5	34.5

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

size=5
start=2020/01/01 12:34:56.100
dt=0.1

0.0[TAB]12.3
0.1[TAB]4.56
0.2[TAB]-78.9
0.3[TAB]0.12
0.4[TAB]34.5

aseq2形式 ファイル仕様

aseq2形式ファイル仕様