series_fill_linear()

系列内の欠損値の線状補間を行います。

動的な数値配列が含まれる式を入力として受け取り、すべての missing_value_placeholder インスタンスについて線状補間を実行して、結果の配列を返します。 配列の先頭と末尾にmissing_value_placeholderが含まれている場合は、missing_value_placeholder以外の最も近い値に置き換えられます。 この機能は無効にできます。 配列全体がmissing_value_placeholderで構成されている場合、配列はconstant_valueで埋められます。指定しない場合は 0 です。

構文

series_fill_linear(シリーズ, [ missing_value_placeholder [,fill_edges [,constant_value ]]])

構文規則について詳しく知る。

パラメーター

名前	型	必須	説明
シリーズ	dynamic	✔️	数値の配列。
missing_value_placeholder	スカラー (scalar)		欠損値のプレースホルダーを指定します。 既定値は double(null です)。 値には、実際の要素型に変換される任意の型を指定できます。 double(null)、 long(null) と int(null) は同じ意味を持ちます。
fill_edges	bool		配列の先頭と末尾 のmissing_value_placeholder を最も近い値に置き換える必要があるかどうかを示します。 既定では true です。 に false設定すると、配列の先頭と末尾の missing_value_placeholder が保持されます。
constant_value	スカラー (scalar)		null 値で完全に構成される配列にのみ関連します。 このパラメーターは、系列を塗りつぶす定数値を指定します。 既定値は 0 です。 このパラメーターを null) にdouble(設定すると、null 値が保持されます。

戻り値

指定したパラメーターを使用した 系列の系列 線形補間。 系列に 要素または long 要素のみがint含まれている場合、線形補間では、正確な値ではなく、丸められた補間値が返されます。

Note

• make-series 演算子を使用して系列を作成する場合は、後のようなseries_fill_linear()補間関数を使用する既定値として null を指定します。 説明を参照してください。
• missing_value_placeholderが double(null) の場合、または省略すると、結果に null 値が含まれる可能性があります。 こうした null 値を補間するには、別の補間関数を使用してください。 入力配列で null 値をサポートするのは、series_outliers() のみです。
• 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]