Delen via

series_fill_linear()

  • Artikel

Van toepassing op: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel-

Lineair interpoleert ontbrekende waarden in een reeks.

Neemt een expressie met dynamische numerieke matrix als invoer, voert lineaire interpolatie uit voor alle exemplaren van missing_value_placeholder en retourneert de resulterende matrix. Als het begin en einde van de matrix missing_value_placeholder bevatten, wordt deze vervangen door de dichtstbijzijnde andere waarde dan missing_value_placeholder. Deze functie kan worden uitgeschakeld. Als de hele matrix bestaat uit de missing_value_placeholder, wordt de matrix gevuld met constant_value of 0 als deze niet is opgegeven.

Syntaxis

series_fill_linear( reeks, [ missing_value_placeholder [,fill_edges [,constant_value ]]])

Meer informatie over syntaxisconventies.

Parameters

Naam Type Vereist Beschrijving
reeks dynamic ✔️ Een matrix met numerieke waarden.
missing_value_placeholder scalar Hiermee geeft u een tijdelijke aanduiding voor ontbrekende waarden op. De standaardwaarde is double(null-). De waarde kan van elk type zijn dat kan worden geconverteerd naar werkelijke elementtypen. double(null-), long(null-) en int(null-) hebben dezelfde betekenis.
fill_edges bool Geeft aan of missing_value_placeholder aan het begin en einde van de matrix moet worden vervangen door de dichtstbijzijnde waarde. true standaard. Als deze optie is ingesteld op false, blijft missing_value_placeholder aan het begin en einde van de matrix behouden.
constant_value scalar Alleen relevant voor matrices die volledig bestaan uit null--waarden. Met deze parameter wordt een constante waarde opgegeven waarmee de reeks moet worden gevuld. De standaardwaarde is 0. Als u deze parameter instelt op double(null-) blijven de null- waarden behouden.

Retourneert

Een lineaire interpolatie van reeks met behulp van de opgegeven parameters. Als reeks alleen int of long elementen bevat, retourneert de lineaire interpolatie afgeronde geïnterpoleerde waarden in plaats van exacte waarden.

Notitie

  • Als u reeks maakt met behulp van de operator make-series, geeft u null- op als de standaardwaarde om interpolatiefuncties zoals series_fill_linear() later te gebruiken. Zie uitleg.
  • Als missing_value_placeholder is double(null-) of wordt weggelaten, kan een resultaat null--waarden bevatten. Als u deze null- waarden wilt vullen, gebruikt u andere interpolatiefuncties. Alleen series_outliers() ondersteunt null--waarden in invoermatrices.
  • series_fill_linear() behoudt het oorspronkelijke type matrixelementen.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de functie series_fill_linear() gebruikt om ontbrekende waarden (null's) in de matrices op te vullen met behulp van lineaire interpolatie. Hiermee worden waarden ingevuld met behulp van de oorspronkelijke arr zonder extra argumenten, het gebruik van randwaarden en het uitsluiten van randwaarden.

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)

uitvoer

arr without_args with_edges wo_edges with_const
[null,111.0,null,36.0,41.0,null,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,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,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]

Verwante inhoud