次の方法で共有


タイム シリーズ モデル変数

手記

Time Series Insights サービスは、2024 年 7 月 7 日に廃止されます。 既存の環境をできるだけ早く別のソリューションに移行することを検討してください。 非推奨と移行の詳細については、ドキュメントを参照してください。

この記事では、イベントの数式と計算ルールを指定するタイム シリーズ モデル変数について説明します。

各変数には、数値、カテゴリ、集計の 3 種類のいずれかを指定できます。

  • 数値型 は、連続する数値で機能します。
  • カテゴリ の種類 、定義済みの不連続値のセットで動作します。
  • 集計 の種類は、1 種類の複数の変数 (すべての数値またはすべてのカテゴリ) を結合します。

次の表に、各変数の種類に関連するプロパティを示します。

タイム シリーズ モデル変数テーブル

数値変数

変数プロパティ 説明
変数フィルター フィルターは、計算対象と見なされる行の数を制限するオプションの条件付き句です。
変数の値 デバイスまたはセンサーからの計算に使用されるテレメトリ値、または時系列式を使用して変換されるテレメトリ値。 数値の種類の変数は、受信データのデータ型と一致させるために、Double または Long である必要があります。
変数補間 補間では、既存のデータを使用して信号を再構築する方法を指定します。 ステップ線形 補間オプションは、数値変数で使用できます。
変数の集計 数値変数の種類に対してサポートされている 集計関数を使用して計算を実行します。

変数は、次の JSON 例に準拠しています。

"Interpolated Speed": {
  "kind": "numeric",
  "value": {
    "tsx": "$event['Speed-Sensor'].Double"
  },
  "filter": null,
  "interpolation": {
    "kind": "step",
    "boundary": {
      "span": "P1D"
    }
  },
  "aggregation": {
    "tsx": "right($value)"
  }
}

カテゴリ変数

変数プロパティ 説明
変数フィルター フィルターは、計算対象と見なされる行の数を制限するオプションの条件付き句です。
変数の値 デバイスまたはセンサーからの計算に使用されるテレメトリ値。 カテゴリの種類の変数は、受信データのデータ型と一致させるために、Long または String である必要があります。
変数補間 補間では、既存のデータを使用して信号を再構築する方法を指定します。 ステップ 補間オプションは、カテゴリ変数に対して使用できます。
変数カテゴリ カテゴリは、デバイスまたはセンサーから取得される値とラベルとの間のマッピングを作成します。
変数の既定のカテゴリ 既定のカテゴリは、"categories" プロパティにマップされていないすべての値に対するものです。

変数は、次の JSON 例に準拠しています。

"Status": {
  "kind": "categorical",
  "value": {
     "tsx": "$event.Status.Long"
},
  "interpolation": {
    "kind": "step",
    "boundary": {
      "span" : "PT1M"
    }
  },
  "categories": [
    {
      "values": [0, 1, 2, 3],
      "label": "Good"
    },
    {
      "values": [4],
      "label": "Bad"
    }
  ],
  "defaultCategory": {
    "label": "Not Applicable"
  }
}

集計変数

変数プロパティ 説明
変数フィルター フィルターは、計算対象と見なされる行の数を制限するオプションの条件付き句です。
変数の集計 集計変数の種類でサポートされている 集計関数を使用して計算を実行します。

変数は、次の JSON 例に準拠しています。

"Speed Range": {
  "kind": "aggregate",
  "filter": null,
  "aggregation": {
    "tsx": "max($event.Speed.Double) - min($event.Speed.Double)"
  }
}

変数は時系列モデルの型定義に格納され、API を介してインラインで提供して、格納された定義をオーバーライドまたは補完できます。

次の手順