TransformPart – Scoped, Global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 11 Minuten Lesedauer

    • Die TransformPart -API bietet Methoden zum Angeben von Details der durchzuführenden Transformation.

    Sie können diese Klasse in bereichsbezogenen und globalen Serverskripts aufrufen. Wenn Sie die Klasse „TransformPart“ verwenden, verwenden Sie den Namespace-Bezeichner sn_clotho.

    Für diese Klasse ist kein Konstruktor vorhanden. TransformPart-Objekte werden von vielen Transformator- und TransformPart -Methoden zurückgegeben.

    Die Methoden dieser Klasse definieren die vorzunehmenden Transformationen. Die eigentliche Transformation erfolgt, wenn die Methode execute() für das Transformer-Objekt aufgerufen wird.

    Die Reihenfolge, in der die TransformPart -Methoden aufgerufen werden, ist wichtig.
    • Sie müssen die metric() -Methode aufrufen, bevor Sie eine Transformationsmethode aufrufen.
    • Sie können die Methoden metric() oder groupBy() nicht nach dem Aufrufen einer Transformationsmethode verwenden.
    • Zwischentransformationen werden nicht in einem Ergebnis zurückgegeben, es sei denn, die Methode collect() wird für das gewünschte Zwischenergebnis aufgerufen.
      // where tp is a TransformPart object
// example 1
tp.avg().add(2);
var tr = tp.execute(); 
// tr contains avg+2, but not avg
 
// example 2
tp.avg().add(2);
tp.avg();
var tr = tp.execute(); 
// tr contains both avg and avg + 2

// example 3
tp.avg().collect().add(2);
var tr = tp.execute(); 
// tr contains both avg and avg + 2

    Diese Klasse ist Teil der MetricBase-Anwendung.

    TransformPart – add(Number constant)

    Fügen Sie dem Wert in jedem Zeitstempel die angegebene Zahl hinzu.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    constant Zahl Die Zahl, die dem Wert in jedem Zeitstempel hinzugefügt werden soll.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – avg()

    Fassen Sie die ausgewählten Metrikserien zu einer Serie zusammen, die den Durchschnittswert für jeden Zeitstempel enthält.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – bottom(Number count)

    Erstellen Sie einen Ergebnissatz, der für jeden Zeitstempel die angegebene Anzahl unterer Werte zurückgibt. Bei dieser Methode wird „count“ für die Anzahl der Serien abgerufen. Jeder Wert behält die Bezeichnung seiner Quellserie bei.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    count Zahl Die Anzahl der Serien, die zurückgegeben werden sollen. Die Serien sind mit 0 bis -1 bezeichnet.
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – ceil(Number ceiling)

    Ersetzen Sie den Wert in einem Zeitstempel, der größer als der angegebene Wert ist, durch den angegebenen Wert.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    ceiling Zahl Der maximal zulässige Wert für einen Zeitstempel.
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – collect()

    Markieren Sie diese Transformation für die Erfassung.

    Transformationen, die Teil einer Kette sind, jedoch nicht die letzte Transformation, werden standardmäßig nicht erfasst. Eine erfasste Transformation wird als Teil des Transformationsergebnisses zurückgegeben.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – count()

    Fassen Sie die ausgewählten Metrikserien zu einer Serie zusammen, die die Anzahl der Werte für jeden Zeitstempel enthält.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – div(Number constant)

    Teilen Sie den Wert in jedem Zeitstempel durch die angegebene Zahl.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    constant Zahl Die Zahl, durch die der Wert jedes Zeitstempels geteilt werden soll.
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – filter(Object aggregator, Object duration)

    Erstellen Sie eine Serie mit dem angegebenen Aggregator für die angegebene Zeit.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    aggregator Objekt Kann sein:
    • DURCHSCHNITT
    • CHI-QUADRAT
    • LETZTER
    • MAX
    • MEDIAN
    • MIN
    • STABW
    Definitionen dieser Optionen finden Sie unter MetricBase-Transformationen.
    Dauer Objekt Zeitraum für die Serie.
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    TransformPart TransformPart-Objekt, mit dem Sie Transformationseigenschaften angeben können.

    TransformPart – floor(Number floor)

    Ersetzen Sie den Wert in einem Zeitstempel, der kleiner als der angegebene Wert ist, durch den angegebenen Wert.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    floor Zahl Der Mindestwert für einen beliebigen Zeitstempel.
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – fractiles(Array fractions)

    Erstellen Sie Serien, die sich aus dem Wert zusammensetzen, unter dem der angegebene Prozentsatz der Werte liegt. Gibt eine Serie für jeden Bruch im angegebenen Array zurück.

    Der Wert in einem Zeitstempel in einer zurückgegebenen Serie ist der Wert, unter dem der angegebene Bruchteil der Beispiele für diesen Zeitstempel liegt. Wenn der Bruch beispielsweise 0,5 ist, ist der Wert im Zeitstempel der Wert, unter dem die Hälfte der Werte in der Eingabeserie liegt (Median).

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    fractions Zahlen-Array Die für die Eingabeserie zu verwendenden Brüche.
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können. Enthält eine Serie für jeden angegebenen Bruch. 
    // returns a single series containing the median for each time stamp, which
// means that half a time stamp's values are below the returned value 
fractiles([.5]) 
// returns four series, one series for each of the 25%, 50%, 75%, and 100% quartiles 
fractiles([.25, .5, .75, 1])
// returns the median, 95% percentile, the max value
fractiles([.50, .95, 1])

    TransformPart – getResult()

    Geben Sie den Teil des Ergebnisses zurück, der für diese Transformation relevant ist.

    Die Methode collect() muss vor der Methode execute() aufgerufen werden, und die Methode execute() muss vor dem Aufrufen der Methode getResult() aufgerufen werden.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    TransformResult Enthält die Transformationsergebnisse, die diesem Teil der Transformation zugeordnet sind. 
    var t = new sn_clotho.Transformer(drones);
t.metric("mb_demo_mt_altitude");
var avgTform = t.avg();
t.execute();
var avgTformResult = avgTform.getResult();

    TransformPart – groupBy(String field)

    Geben Sie ein Feld an, nach dem Daten gruppiert werden sollen. Um mehrere Felder anzugeben, führen Sie aufeinanderfolgende Aufrufe einzeln aus.

    Hinweis:
    Die Methode groupBy() kann nicht aufgerufen werden, nachdem eine Transformation ausgeführt wurde.
    Tabelle : 23. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Name eines Felds in der Tabelle, nach dem die Transformationsergebnisse gruppiert werden sollen.
    Tabelle : 24. Rückgaben
    Typ Beschreibung
    TransformPart Ein TransformPart -Objekt, das zum Angeben von Transformationsmerkmalen verwendet werden kann.

    Das folgende Beispiel zeigt, wie Sie die Metriken für den Höhendurchschnitt nach Flotten- und Modellfeldern gruppieren.

    transformer.groupBy("fleet,model").metric("mb_demo_mt_altitude").avg().label('%g:fleet: - %g:model:');

var transformPart = transformer.groupBy("fleet,model")

transformPart.metric("mb_demo_mt_altitude").avg().label('%g:fleet: - %g:model:');

    TransformPart – interpolate(Object count)

    Erstellen Sie einen Datenwert für ein NaN-Datenelement, indem Sie aus benachbarten Datenwerten interpolieren.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    count Objekt Gibt die Anzahl der Datenbeispiele in jede Richtung an, um nach einem Nicht-NaN-Wert zu suchen. Wenn kein Nicht-NaN-Wert gefunden wird, wird NaN verwendet.
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – iqr()

    Führen Sie eine Interquartilbereichstransformation durch.

    Erzeugt einen Ergebnissatz von vier Serien.
    • IQR, der Median aller Einträge
    • IQR-Bereich unter Q1-1.5IQR oder über Q3+1.5IQR
    • Q1, der Median der kleinsten Hälfte der Einträge
    • Q3, der Median der größten Hälfte der Einträge
    Tabelle : 27. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – label(String label)

    Fügen Sie eine Bezeichnung für die resultierende Serie hinzu.

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    label Zeichenfolge Die Bezeichnung für die Transformationsergebnisse.
    Tabelle : 30. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – limit(Object count)

    Gibt höchstens die angegebene Anzahl von Werten zurück, beginnend mit dem neuesten Nicht-NaN-Wert.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    count Objekt Eine Anzahl von Zeitstempeln.
    Tabelle : 32. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – log(Number base)

    Führen Sie einen Logarithmus für den Wert in jedem Zeitstempel aus, wobei das Ergebnis das Protokoll der angegebenen Basis für den Zeitstempelwert ist.

    Tabelle : 33. Parameter
    Name Typ Beschreibung
    base Zahl Die Basis für die Berechnung des Logarithmus.
    Tabelle : 34. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – max()

    Gibt eine Serie mit dem maximalen Wert für jeden Zeitstempel zurück.

    Tabelle : 35. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 36. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – median()

    Erstellen Sie eine Serie mit dem Median der Werte für jeden Zeitstempel in einen Satz von Serien.

    Wenn im TranformPart-Objekt n Serien vorhanden sind, ist der Wert (n / 2 + 1) für einen Zeitstempel der Median, wenn n ungerade ist. Wenn n gerade ist, ist der Durchschnitt der Werte (n / 2) und (n / 2 + 1) für einen Zeitstempel der Median.

    Tabelle : 37. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 38. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – metric(String metric)

    Geben Sie das Metrikfeld an, das bei der Transformation verwendet werden soll.

    Sie können mehrere Metriken angeben, die bei der Transformation verwendet werden sollen. Die Methode metric() kann nicht aufgerufen werden, nachdem die Transformation ausgeführt wurde.

    Tabelle : 39. Parameter
    Name Typ Beschreibung
    metric Zeichenfolge Name des Metrikfelds.
    Tabelle : 40. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – min()

    Gibt eine Serie mit dem Mindestwert für jeden Zeitstempel zurück.

    Tabelle : 41. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 42. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – mul(Number constant)

    Multiplizieren Sie den Wert in jedem Zeitstempel mit der angegebenen Zahl.

    Tabelle : 43. Parameter
    Name Typ Beschreibung
    constant Zahl Die Zahl, mit der der Wert jedes Zeitstempels multipliziert werden soll.
    Tabelle : 44. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – partition(String aggregator, GlideDateTime duration, GlideDateTime base)

    Partitionieren Sie die Serie in Intervalle gleicher Dauer.

    Tabelle : 45. Parameter
    Name Typ Beschreibung
    aggregator Zeichenfolge Der zu verwendende Aggregator. Kann MIN, MAX, AVG oder LAST sein.
    duration GlideDateTime oder eine nach ISO 8601 formatierte Zeichenfolge Die Intervalllänge.
    base GlideDateTime oder eine nach ISO 8601 formatierte Zeichenfolge Die Nullpunktverschiebung für die Partitionierung. Wenn Sie beispielsweise nach Tag partitionieren (24 Stunden), setzen Sie die Basis in Ihrer Zeitzone auf Montag um Mitternacht. Wenn Sie nach 30 Tagen partitionieren, setzen Sie die Basis auf den ersten Tag des letzten Monats.
    Tabelle : 46. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – resample(Number count)

    Geben Sie die Anzahl der Datenpunkte an, die in das Ergebnis aufgenommen werden sollen.

    Richtet eine Serie mit einer festen Anzahl von Datenpunkten im angegebenen Bereich aus. Wenn die ursprüngliche Serie mehr Datenpunkte als angegeben enthält, werden mehrere Werte gemittelt. Wenn die ursprüngliche Serie weniger Datenpunkte als angegeben hat, werden Datenpunkte durch Interpolation von Datenpunkten zwischen vorhandenen Datenpunkten hinzugefügt.

    Mit der Methode resample() können Sie die Anzahl der Beispiele im Ergebnis reduzieren, um die Anzahl der anzuzeigenden Beispiele genauer zu bestimmen.

    Tabelle : 47. Parameter
    Name Typ Beschreibung
    count Zahl Die Anzahl der Beispiele, die in das Ergebnis aufgenommen werden sollen.
    Tabelle : 48. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – resample(Number min, Number max)

    Geben Sie die minimale und maximale Anzahl von Beispielen an, die in das Ergebnis aufgenommen werden sollen.

    Diese Methode ist nützlich, wenn Sie Serien mit unterschiedlichen Zeiträumen (Granularitäten) anzeigen.

    Diese Methode bestimmt die durchschnittliche Anzahl von Punkten pro Serie. Wenn diese Zahl zwischen dem angegebenen Minimum und Maximum liegt, wird jede Serie auf diese durchschnittliche Anzahl von Punkten neu berechnet. Wenn der berechnete Durchschnitt größer als das angegebene Maximum oder kleiner als das angegebene Minimum ist, wird das angegebene Maximum oder Minimum verwendet.

    Tabelle : 49. Parameter
    Name Typ Beschreibung
    min Zahl Die Mindestanzahl von Beispielen, die in das Ergebnis aufgenommen werden sollen. Wenn nicht genügend Beispiele verfügbar sind, wird die Interpolation zum Erstellen von Beispielen verwendet.
    max Zahl Die maximale Anzahl von Beispielen, die in das Ergebnis aufgenommen werden sollen.
    Tabelle : 50. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – resample(String aggregator, Number numValues)

    Geben Sie einen Aggregator an, der zum Erstellen eines Ergebnissatzes mit der angegebenen Größe verwendet werden soll. Der Aggregator kann LETZTER, DURCHSCHNITT, MIN oder MAX sein.

    Mit der Methode resample() können Sie die Anzahl der Beispiele im Ergebnis reduzieren, um die Anzahl der anzuzeigenden Beispiele genauer zu bestimmen.

    Tabelle : 51. Parameter
    Name Typ Beschreibung
    aggregator Zeichenfolge Kann LETZTER, DURCHSCHNITT, MIN oder MAX sein.
    numValues Zahl Die Anzahl der Beispiele, die in den Ergebnissatz aufgenommen werden sollen.

    Wenn die Anzahl der angeforderten Werte größer ist als die Anzahl der Werte in den Daten für den angeforderten Zeitraum, können mit interpolate() Werte zwischen vorhandenen Punkten hinzugefügt werden, um die angeforderte Anzahl von Werten zu erreichen.
    Tabelle : 52. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – resample(String aggregator, GlideDuration duration)

    Geben Sie einen Aggregator an, der zum Erstellen eines Ergebnissatzes über die angegebene Dauer verwendet werden soll. Der Aggregator kann LETZTER, DURCHSCHNITT, MIN oder MAX sein.

    Berechnet die zugrunde liegenden Daten für den angeforderten Zeitraum neu.
    • Wenn die Zeitreihe mit einem Abstand von 1 Minute gespeichert wird und resample (DURCHSCHNITT, new GlideDuration("1:00")) aufgerufen wird, enthält das Ergebnis zu jeder Stunde einen Datenpunkt, der den Durchschnitt der vorherigen 60 Werte widerspiegelt.
    • Wenn der angeforderte Zeitraum kleiner als der Zeitraum der Daten ist, werden die dazwischenliegenden Datenpunkte durch Interpolation berechnet.

    Mit der Methode resample() können Sie die Anzahl der Beispiele im Ergebnis reduzieren, um die Anzahl der anzuzeigenden Beispiele genauer zu bestimmen.

    Tabelle : 53. Parameter
    Name Typ Beschreibung
    aggregator Zeichenfolge Kann LETZTER, DURCHSCHNITT, MIN oder MAX sein.
    duration GlideDuration Der Zeitraum für den Ergebnissatz.
    Tabelle : 54. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – round(Number precision)

    Runden Sie den Wert in jedem Zeitstempel auf die angegebene Genauigkeit.

    Führt diese Berechnung für jeden Wert durch.
    (v / precision) * precision
    Tabelle : 55. Parameter
    Name Typ Beschreibung
    precision Zahl Der Wert, der bei der Rundungsberechnung verwendet werden soll.
    Tabelle : 56. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – stddev()

    Erstellen Sie eine Serie mit der Standardabweichung der Werte für jeden Zeitstempel in einem Satz von Serien.

    Tabelle : 57. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 58. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – sub(Object constant)

    Subtrahieren Sie die angegebene Zahl von dem Wert in jedem Zeitstempel.

    Tabelle : 59. Parameter
    Name Typ Beschreibung
    constant Objekt Die Zahl, die von dem Wert in jedem Zeitstempel subtrahiert werden soll.
    Tabelle : 60. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – sum()

    Fassen Sie die ausgewählten Metrikserien zu einer Serie zusammen, die die Summe aller Werte für jeden Zeitstempel enthält.

    Tabelle : 61. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 62. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.

    TransformPart – top(Number count)

    Erstellen Sie einen Ergebnissatz, der für jeden Zeitstempel die angegebene Anzahl von Spitzenwerten zurückgibt. Bei dieser Methode wird „count“ für die Anzahl der Serien abgerufen. Jeder Wert behält die Bezeichnung seiner Quellserie bei.

    Tabelle : 63. Parameter
    Name Typ Beschreibung
    count Zahl Die Anzahl der Serien, die zurückgegeben werden sollen. Die Serien sind mit 0 bis -1 bezeichnet.
    Tabelle : 64. Ergebnisse
    Typ Beschreibung
    TransformPart Ein TransformPart-Objekt, mit dem Transformationseigenschaften angegeben werden können.