series_fill_linear()
適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
系列内の欠損値の線状補間を行います。
動的な数値配列が含まれる式を入力として受け取り、すべての missing_value_placeholder インスタンスについて線状補間を実行して、結果の配列を返します。 配列の先頭と末尾にmissing_value_placeholderが含まれている場合は、missing_value_placeholder以外の最も近い値に置き換えられます。 この機能は無効にできます。 配列全体がmissing_value_placeholderで構成されている場合、配列はconstant_valueで塗りつぶされ、指定されていない場合は 0 になります。
構文
series_fill_linear(series, [ missing_value_placeholder [,fill_edges [, constant_value ]] ])
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| 系列 | dynamic |
✔️ | 数値の配列。 |
| missing_value_placeholder | スカラー型 | 欠損値のプレースホルダーを指定します。 既定値は double(null) です。 値には、実際の要素型に変換される任意の型を指定できます。 double(null)、 long(null)、 int(null) は同じ意味を持ちます。 |
|
| fill_edges | bool |
配列の先頭と末尾の missing_value_placeholder を最も近い値に置き換える必要があるかどうかを示します。 既定では true です。 falseに設定すると、配列の先頭と末尾のmissing_value_placeholderが保持されます。 |
|
| constant_value | スカラー型 | null値で完全に構成される配列にのみ関連します。 このパラメーターは、系列を塗りつぶす定数値を指定します。 既定値は 0 です。 このパラメーターを double(null に設定すると)null値が保持されます。 |
返品
指定されたパラメーターを使用series の系列線形補間。 seriesにint要素またはlong要素のみが含まれている場合、線形補間は正確な値ではなく、丸められた補間値を返します。
Note
- make-series 演算子を使用してseries を作成する場合はnullを既定値として指定して、後で
series_fill_linear()などの補間関数を使用します。 「 計画」を参照してください。 - missing_value_placeholderが
double(null)、または省略されている場合、結果にnull値が含まれる可能性があります。 これらの null 値を埋めるには、他の補間関数を使用します。 series_outliers()のみが入力配列のnull値をサポートします。 series_fill_linear()は、配列要素の元の型を保持します。
例
let data = datatable(arr: dynamic)
[
dynamic([null, 111.0, null, 36.0, 41.0, null, null, 16.0, 61.0, 33.0, null, null]), // Array of double
dynamic([null, 111, null, 36, 41, null, null, 16, 61, 33, null, null]), // Similar array of int
dynamic([null, null, null, null]) // Array with missing values only
];
data
| project
arr,
without_args = series_fill_linear(arr),
with_edges = series_fill_linear(arr, double(null), true),
wo_edges = series_fill_linear(arr, double(null), false),
with_const = series_fill_linear(arr, double(null), true, 3.14159)
出力
arr |
without_args |
with_edges |
wo_edges |
with_const |
|---|---|---|---|---|
| [null,111.0,null,36.0,41.0,null,null,16.0,61.0,33.0,null,null] | [111.0,111.0,73.5,36.0,41.0,32.667,24.333,16.0,61.0,33.0,33.0,33.0] | [111.0,111.0,73.5,36.0,41.0,32.667,24.333,16.0,61.0,33.0,33.0,33.0] | [null,111.0,73.5,36.0,41.0,32.667,24.333,16.0,61.0,33.0,null,null] | [111.0,111.0,73.5,36.0,41.0,32.667,24.333,16.0,61.0,33.0,33.0,33.0] |
| [null,111,null,36,41,null,null,16,61,33,null,null] | [111,111,73,36,41,32,24,16,61,33,33,33] | [111,111,73,36,41,32,24,16,61,33,33,33] | [null,111,73,36,41,32,24,16,61,33,null,null] | [111,111,74,38, 41,32,24,16,61,33,33,33] |
| [null,null,null,null] | [0.0,0.0,0.0,0.0] | [0.0,0.0,0.0,0.0] | [0.0,0.0,0.0,0.0] | [3.14159,3.14159,3.14159,3.14159] |