時系列データ ファイル形式

時系列データ ファイル形式が開発されたのは、さまざまなソースから自在に大量の時系列データを取り込んで、InfoWorks にデータを読み込むことができるようにするためです。

注:

この形式は進行中のプロジェクトであり、今後変更される可能性があります。そのため、この形式を使用する場合は、事前にAutodeskに問い合わせることが重要です。

お問い合わせの上、次のことを行ってください。

次のセクションでは、時系列データ ファイルの形式について説明します。

  1. TSD ファイル
  2. DAT ファイル

形式の説明は、このヘルプ ファイル発行時点での正しい情報です。

TSD ファイル

TSD ファイルには、ヘッダ セクションとそれに続くデータ セクションがあります。セミコロンで始まる行はコメント行であり、ファイル リーダでは無視されます。次に例を示します。 

[TSD_VERSION=3.0]
[SYSTEM_TYPE=Radcom logger]
FO120716,FO12 STATION FLOW,Flow,m3/h,USED,0,500 
FO120717,FO12 BOREHOLE FLOW,Flow,m3/h,USED,0,500

ヘッダ セクション

ヘッダには、その他のパラメータとその値が含まれます。

各行にはパラメータ(列挙型パラメータ タイプのセットの 1 つ)があり、その後に = と値(以下参照)が続きます。各パラメータと値のペアは、一対の角括弧で囲みます。1 行に表示できるパラメータと値のペアは 1 つだけです。

データ セクション

TSD ファイルの中で最も重要なセクションです。

このセクションは、システムで使用される計測点または位置を含む、多数のカンマ区切り行で構成されます。カンマ区切りのフィールドには、読み取りのタイプや単位など、その他の重要な情報も含まれています。

カンマで区切られた各行の最初のフィールドは、一意のキーです。このキーは、行上の他のフィールドの情報を DAT ファイル内の値(実際の読み取り値)に関連付けるために使用します。

各フィールドに含まれる値は、それぞれ次のとおりです。

フィールド 説明 形式 例

キー

行上の他のデータを DAT ファイル内の値に関連付けるために使用される固有の識別子

文字[0-9]と[A-Z]を含む 8 文字の文字列

次の点に注目してください。

  • 主要な比較で大文字と小文字が区別されません
  • 先頭と末尾のスペースが無視されます 
FO120716

位置

値の場所

カンマと二重引用符を除く、英数字の任意の組み合わせの文字列

次の点に注目してください。

  • すべての文字列比較で大文字と小文字が区別されません
  • 先頭と末尾のスペースが無視されます 
FO12 STATION FLOW

データ タイプ

計測のタイプ

set データ型での列挙型の 1 つ(下記の「データ型と単位」を参照) 

Flow

単位

計測の単位

set 単位の列挙型の 1 つ(下記の「データ型と単位」を参照) 

m3/h

ステータス

予約済みフィールド: 値を USED に設定

列挙型 

USED

最小有効値

それぞれの値の許容される下限と上限です。これらのオプション フィールドを使用して、DAT ファイルに表示される不適当な値にフィルタを適用したりフラグを立てたりすることができます。たとえば、機器が故障した場合に発生する可能性があります。これらの値がどのように処理されるかは、TSD ファイルを読み取るシステムの具体的な実装によって異なります

Number

  • これらのフィールドは、使用しない場合は空白のままにします
  • 浮動小数点または整数
  • 署名済みまたは未署名
  • 指数を使用しない(例: 1.0234e-01) 
0

最大有効値 

500

データ型と単位

時系列データ ファイルで許容される単位は次のとおりです。

データ タイプ 許容される単位

FLOW

'l/d'、'l/hr'、'l/min'、'l/s'、'Litres per sec''Ml/d'、'Million litres per day'

'm3/h'、'm3/hr'、'm3/hour'、'cum/hr'、'm3/s'、'cfs'

PRESSURE

'm'、'mHd'、'metre'、'Metres''cm'、'mm'、'mmH2O'

'bar'、'psi'、'ft'、'KPa'

DEPTH

'm'

'cm'

'mm'

CONCENTRATION

'mg/l'、'microg/l'

'ppb'、'ppm'

PUMP_RUNNING

なし

(DAT ファイル内のゼロ以外の値は ON として読み込まれます)

PC_VOLUME

'% full'

(DAT ファイル内の値はパーセンテージとして読み込まれます)

OPENING

'% open'

(DAT ファイル内の値は開度として読み込まれます)

DAT ファイル

DAT ファイルは、多数のタイム スタンプ付きセクションを含む日付スタンプ付きファイルのセットです。各セクションには、key-value-flag レコードのセットが含まれます。次に例を示します。 

_00:00
FO120716,238.0952, 1
FO120717,102.3199, 1
_00:21
FO120716,236.0195, 1
FO120717,102.3199, 2
FO120718,3.2451, 1
FO120719,2.2073, 1
_00:33
FO120716,236.3858, 1
FO120717,102.0757, 2
FO120718,3.2599, 1
FO120719,2.2073, 1

DAT ファイルには、そのファイルに含まれるデータの日付を表す特定の命名規則があります。形式は次のとおりです。

YYYY-MM-DD.dat

説明:

YYYY は 4 桁の年

MM は 2 桁の月(01 から 12)

DD は 2 桁の日(01 から 31)

先頭にゼロを付ける必要があります。日付コンポーネントはマイナスで区切る必要があります。

例:

2001-01-20.dat

1998-12-31.dat

セクションと Key-Value-Flag レコード

各セクションには、タイム スタンプと、現時点で記録されている一連の値が含まれています。タイム スタンプ付きのセクションは、時系列の昇順で表示されます。各値は、key-value-flag レコードとして表示されます。このキーは、値を TSD ファイルに格納されているデータに関連付けるために使用します。

[行] 形式 サンプル

タイムスタンプ

_hh:mm

説明:

hh は 2 桁の時間(00 から 23)です。

mm は 2 桁の分(00 から 59)です。

次の点に注目してください。

  • 先頭にゼロを付ける必要があります
  • コロンで時間コンポーネントを区切る必要があります
  • 時間の前にアンダースコアを付ける必要があります 
_00:00

_00:21

Key-Value-Flag レコード

key,value,flag

説明:

key は、TSD ファイルに表示されるキーです

value は値です(上記の注 3 を参照)

flag は、データの信頼性または品質を示すために使用できるオプションの整数フィールドです。フラグ情報の表示の詳細については、「ライブ データ フラグ」のトピックを参照してください。 

FO120716,238.0952, 1
FO120717,102.3199, 1
親トピック: 時系列データ ファイルについて

関連情報