series_fill_linear()
Interpola linearmente valores em falta numa série.
Utiliza uma expressão que contém uma matriz numérica dinâmica como entrada, faz a interpolação linear para todas as instâncias de missing_value_placeholder e devolve a matriz resultante. Se o início e o fim da matriz contiverem missing_value_placeholder, será substituído pelo valor mais próximo que não missing_value_placeholder. Esta funcionalidade pode ser desativada. Se toda a matriz consistir na missing_value_placeholder, a matriz será preenchida com constant_value ou 0 se não for especificada.
Syntax
series_fill_linear(
série,
[ missing_value_placeholder [,
fill_edges [,
constant_value ]]])
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Tipo | Necessário | Descrição |
---|---|---|---|
série | dynamic |
✔️ | Uma matriz de valores numéricos. |
missing_value_placeholder | escalar | Especifica um marcador de posição para valores em falta. O valor predefinido é double( nulo) . O valor pode ser de qualquer tipo que será convertido em tipos de elementos reais. double (nulo), long (nulo) e int (nulo) têm o mesmo significado. |
|
fill_edges | bool |
Indica se missing_value_placeholder no início e no fim da matriz devem ser substituídos pelo valor mais próximo. true por predefinição. Se estiver definido como false , missing_value_placeholder no início e no fim da matriz serão preservados. |
|
constant_value | escalar | Relevante apenas para matrizes que consistem inteiramente em valores nulos . Este parâmetro especifica um valor constante para preencher a série. O valor predefinido é 0. Definir este parâmetro como double( nulo) preserva os valores nulos . |
Devoluções
Uma série de interpolação linear de séries com os parâmetros especificados. Se a série contiver apenas int
elementos ou long
elementos, a interpolação linear devolve valores interpolados arredondados em vez de valores exatos.
Nota
- Se criar séries com o operador make-series, especifiquenulo como o valor predefinido para utilizar funções de interpolação, como
series_fill_linear()
posteriormente. Veja a explicação. - Se missing_value_placeholder for
double
(nulo) ou omitido, um resultado poderá conter valores nulos . Para preencher estes valores nulos , utilize outras funções de interpolação. Apenas series_outliers() suporta valores nulos em matrizes de entrada. series_fill_linear()
preserva o tipo original dos elementos de matriz.
Exemplo
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)
Saída
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] | [nulo,111,73,36,41,32,24,16,61,33,nulo,nulo] | [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] |
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários