時系列モデルの変数
注意
Time Series Insights (TSI) サービスは、2025 年 3 月以降はサポートされなくなります。 できるだけ早く既存の TSI 環境を代替ソリューションに移行することを検討してください。 サポートの終了と移行の詳細については、こちらのドキュメントを参照してください。
この記事では、イベントに関する式と計算ルールを指定する時系列モデルの変数について説明します。
各変数には、"数値"、"カテゴリ別"、および "集計" の 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 を使用してインラインで指定して、格納されている定義をオーバーライドしたり補完したりできます。