TransformPart - Inclus, global

L’API TransformPart fournit des méthodes pour spécifier les détails de la transformation à effectuer.

Vous pouvez appeler cette classe dans les scripts de serveur inclus dans le champ d’application et globaux. Lors de l’utilisation de la classe TransformPart , utilisez l’identificateur d’espace de noms sn_clotho.

Il n’existe aucun constructeur pour cette classe. Les objets TransformPart sont renvoyés par de nombreuses méthodes Transformer et TransformPart .

Les méthodes de cette classe définissent les transformations à effectuer. La transformation réelle est effectuée lorsque la méthode execute() est appelée sur l’objet Transformer.

L’ordre dans lequel les méthodes TransformPart sont appelées est important.

• Vous devez appeler la méthode metric() avant d’appeler une méthode de transformation.
• Vous ne pouvez pas utiliser les méthodes metric() ou groupBy() après avoir appelé une méthode de transformation.
• Les transformations intermédiaires ne sont pas renvoyées dans un résultat à moins que la méthode collect() ne soit appelée pour le résultat intermédiaire souhaité.

  // 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

Cette classe fait partie de l’application MetricBase .

TransformPart : ajouter (nombre constant)

Ajoutez le nombre spécifié à la valeur de chaque horodatage.

Tableau 1. Paramètres

Nom	Type	Description
constante	Numéro	Nombre à ajouter à la valeur de chaque horodatage.

Tableau 2. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : avg()

Regroupez la série de mesures sélectionnée en une seule série contenant la valeur moyenne de chaque horodatage.

Tableau 3. Paramètres

Nom	Type	Description
Aucun

Tableau 4. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : bottom(nombre de nombres)

Créez un jeu de résultats qui, pour chaque horodatage, renvoie un nombre spécifié de valeurs inférieures. Cette méthode permet d’obtenir le nombre de séries. Chaque valeur conserve l’étiquette de sa série source.

Tableau 5. Paramètres

Nom	Type	Description
compter	Numéro	Nombre de séries à renvoyer. Les séries sont étiquetées de 0 à 1.

Tableau 6. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart - ceil(Plafond numérique)

Remplacez la valeur de n’importe quel horodatage supérieure à la valeur spécifiée par la valeur spécifiée.

Tableau 7. Paramètres

Nom	Type	Description
plafond	Numéro	Valeur maximale autorisée pour tout horodatage.

Tableau 8. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : collect()

Marquez cette transformation pour la collecte.

Les transformations qui font partie d’une chaîne, mais pas la dernière, ne sont par défaut pas collectées. Une transformation collectée est renvoyée dans le cadre du résultat de la transformation.

Tableau 9. Paramètres

Nom	Type	Description
Aucun

Tableau 10. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : count()

Regroupez la série de mesures sélectionnée en une seule série contenant le nombre de valeurs de chaque horodatage.

Tableau 11. Paramètres

Nom	Type	Description
Aucun

Tableau 12. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : div(nombre constant)

Divisez la valeur de chaque horodatage par le nombre spécifié.

Tableau 13. Paramètres

Nom	Type	Description
constante	Numéro	Nombre par lequel diviser la valeur de chaque horodatage.

Tableau 14. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart - filter(agrégateur d’objet, durée de l’objet)

Créez une série à l’aide de l’agrégateur spécifié pour la période spécifiée.

Tableau 15. Paramètres

Nom	Type	Description
agrégateur	Objet	Peut être : MOY CHICARRÉ DERNIER MAX MÉDIAN MIN. DEV STANDARD Pour obtenir les définitions de ces options, consultez Transformations MetricBase.
durée	Objet	Période de la série.

Tableau 16. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart que vous pouvez utiliser pour spécifier les caractéristiques de transformation.

TransformPart : floor(numéro d’étage)

Remplacez la valeur de n’importe quel horodatage inférieur à la valeur spécifiée par la valeur spécifiée.

Tableau 17. Paramètres

Nom	Type	Description
étage	Numéro	La valeur minimale de n’importe quel horodatage.

Tableau 18. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart - fractiles(Tableau de fractions)

Créez une série composée de la valeur ci-dessous dont le pourcentage de valeurs spécifié est inférieur. Renvoie une série pour chaque fraction du tableau spécifié.

La valeur d’un horodatage d’une série retournée est la valeur à laquelle la fraction spécifiée des échantillons pour cet horodatage est inférieure. Par exemple, si la fraction est égale à 0,5, la valeur de l’horodatage est la valeur où la moitié des valeurs de la série en entrée se trouvent en dessous (médiane).

Tableau 19. Paramètres

Nom	Type	Description
Fractions	Tableau de nombres	Fractions à utiliser sur la série d’entrée.

Tableau 20. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation. Contient une série pour chaque fraction spécifiée.

// 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()

Renvoie la partie du résultat pertinente pour cette transformation.

La méthode collect() doit être appelée avant la méthode execute(), et la méthode execute() doit être appelée avant l’appel de la méthode getResult().

Tableau 21. Paramètres

Nom	Type	Description
Aucun

Tableau 22. Renvoie

Type	Description
TransformResult (en anglais seulement)	Contient les résultats de transformation associés à cette partie de la transformation.

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 (champ de chaîne)

Spécifiez un champ dans lequel regrouper les données. Pour spécifier plusieurs champs, exécutez des appels successifs individuellement.

Remarque :

La méthode groupBy() ne peut pas être appelée après l’exécution d’une transformation.

Tableau 23. Paramètres

Nom	Type	Description
champ	Chaîne	Nom d’un champ dans la table selon lequel regrouper les résultats de la transformation.

Tableau 24. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

L’exemple suivant montre comment regrouper les mesures d’altitude moyenne par flotte et par champ de modèle.

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 : interpoler(nombre d’objets)

Créez une valeur de données pour un élément de données NaN en interpolant à partir de valeurs de données adjacentes.

Tableau 25. Paramètres

Nom	Type	Description
compter	Objet	Spécifie le nombre d’échantillons de données dans chaque direction pour vérifier une valeur non NaN. Si une valeur autre que NaN n’est pas trouvée, NaN est utilisé.

Tableau 26. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : iqr()

Effectuez une transformation d’intervalle interquartile.

Crée un jeu de résultats de quatre séries.

• IQR, la médiane de toutes les entrées
• Plage IQR, inférieure à Q1-1.5IQR, ou supérieure à Q3+1.5IQR
• Q1, la médiane de la plus petite moitié des entrées
• Q3, la médiane de la plus grande moitié des entrées

Tableau 27. Paramètres

Nom	Type	Description
Aucun

Tableau 28. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : étiquette (étiquette de chaîne)

Ajoutez une étiquette pour la série résultante.

Tableau 29. Paramètres

Nom	Type	Description
étiquette	Chaîne	Étiquette des résultats de transformation.

Tableau 30. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : limite(nombre d’objets)

Renvoie au maximum le nombre de valeurs spécifié, en commençant par la valeur non NaN la plus récente.

Tableau 31. Paramètres

Nom	Type	Description
compter	Objet	Un certain nombre d’horodatages.

Tableau 32. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : journal (base de numéro)

Exécutez un logarithme sur la valeur de chaque horodatage où le résultat est le journal de la base spécifiée pour la valeur d’horodatage.

Tableau 33. Paramètres

Nom	Type	Description
base	Numéro	Base du calcul du logarithme.

Tableau 34. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : max()

Renvoie une série avec la valeur maximale pour chaque horodatage.

Tableau 35. Paramètres

Nom	Type	Description
Aucun

Tableau 36. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : median()

Créez une série contenant la médiane des valeurs pour chaque horodatage dans un ensemble de séries.

S’il existe n séries dans l’objet TranformPart, alors si n est impair, la valeur (n / 2 + 1) d’un horodatage est la médiane. Si n est pair, la moyenne des valeurs (n / 2) et (n / 2 + 1) pour un horodatage est la médiane.

Tableau 37. Paramètres

Nom	Type	Description
Aucun

Tableau 38. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : mesure (mesure de chaîne)

Spécifiez le champ de mesure à utiliser dans la transformation.

Vous pouvez spécifier plusieurs mesures à utiliser dans la transformation. La méthode metric() ne peut pas être appelée après l’exécution de la transformation.

Tableau 39. Paramètres

Nom	Type	Description
mesure	Chaîne	Nom du champ de mesure.

Tableau 40. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : min()

Renvoie une série avec la valeur minimale pour chaque horodatage.

Tableau 41. Paramètres

Nom	Type	Description
Aucun

Tableau 42. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : mul(nombre constant)

Multipliez la valeur de chaque horodatage par le nombre spécifié.

Tableau 43. Paramètres

Nom	Type	Description
constante	Numéro	Nombre par lequel multiplier la valeur de chaque horodatage.

Tableau 44. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart - partition(agrégateur de chaîne, durée GlideDateTime, base GlideDateTime)

Partitionnez la série en intervalles de même durée.

Tableau 45. Paramètres

Nom	Type	Description
agrégateur	Chaîne	L’agrégateur à utiliser. Peut être min, max, moy ou dernier.
durée	GlideDateTime ou une chaîne au format ISO 8601	Longueur de l’intervalle.
base	GlideDateTime ou une chaîne au format ISO 8601	Décalage zéro pour le partitionnement. Par exemple, si vous partitionnez par jour (24h), puis définissez la base sur le lundi à minuit dans votre fuseau horaire. Si vous divisez de 30 jours, définissez la base sur le 1er jour du mois le plus récent.

Tableau 46. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : rééchantillonner(nombre de nombres)

Spécifiez le nombre de points de données à inclure dans le résultat.

Aligne une série avec un nombre fixe de points de données dans la plage donnée. Si la série d’origine contient plus de points de données que spécifié, la moyenne de plusieurs valeurs est calculée. Si la série d’origine comporte moins de points de données que spécifié, des points de données sont ajoutés en interpolant des points de données entre des points de données existants.

Vous pouvez utiliser la méthode resample() pour réduire le nombre d’échantillons dans le résultat afin qu’il corresponde mieux au nombre d’échantillons que vous allez afficher.

Tableau 47. Paramètres

Nom	Type	Description
compter	Numéro	Nombre d’échantillons à inclure dans le résultat.

Tableau 48. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : rééchantillon(nombre min, nombre max.)

Spécifiez le nombre minimal et maximal d’échantillons à inclure dans le résultat.

Cette méthode est utile lorsque vous affichez des séries avec des périodes de temps différentes (granularités).

Cette méthode permet de déterminer le nombre moyen de points par série et, s’il se situe entre le minimum et le maximum spécifiés, chaque série est rééchantillonnée selon ce nombre moyen de points. Si la moyenne calculée est supérieure au maximum spécifié ou inférieure au minimum spécifié, le maximum ou le minimum spécifié est utilisé.

Tableau 49. Paramètres

Nom	Type	Description
min.	Numéro	Nombre minimal d’échantillons à inclure dans le résultat. S’il n’y a pas assez d’échantillons disponibles, l’interpolation est utilisée pour créer des échantillons.
max.	Numéro	Nombre maximal d’échantillons à inclure dans le résultat.

Tableau 50. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : resample(String aggregator, Number numValues)

Spécifiez un agrégateur à utiliser pour créer un ensemble de résultats de la taille spécifiée. L’agrégateur peut être LAST, AVG, MIN ou MAX.

Vous pouvez utiliser la méthode resample() pour réduire le nombre d’échantillons dans le résultat afin qu’il corresponde mieux au nombre d’échantillons que vous allez afficher.

Tableau 51. Paramètres

Nom	Type	Description
agrégateur	Chaîne	Peut être LAST, AVG, MIN ou MAX.
Valeurs num	Numéro	Nombre d’échantillons à inclure dans l’ensemble de résultats. Lorsque le nombre de valeurs demandées est supérieur au nombre de valeurs dans les données pour la période demandée, interpolate() est utilisé pour ajouter des valeurs entre les points existants afin d’atteindre le nombre de valeurs demandé.

Tableau 52. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : resample(agrégateur de chaînes, durée GlideDuration)

Spécifiez un agrégateur à utiliser pour créer un ensemble de résultats sur la durée spécifiée. L’agrégateur peut être LAST, AVG, MIN ou MAX.

Rééchantillonne les données sous-jacentes pour la période demandée.

• Lorsque la série chronologique est stockée à un intervalle de 1 minute et que le rééchantillonnage (AVG, new GlideDuration(« 1:00 »)) est appelé, le résultat comporte un point de données toutes les heures reflétant la moyenne des 60 valeurs précédentes.
• Lorsque la période demandée est inférieure à la période des données, l’interpolation est utilisée pour calculer les points de données intermédiaires.

Vous pouvez utiliser la méthode resample() pour réduire le nombre d’échantillons dans le résultat afin qu’il corresponde mieux au nombre d’échantillons que vous allez afficher.

Tableau 53. Paramètres

Nom	Type	Description
agrégateur	Chaîne	Peut être LAST, AVG, MIN ou MAX.
durée	GlideDuration (en anglais seulement)	La période pour l’ensemble de résultats.

Tableau 54. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : arrondi (précision numérique)

Arrondissez la valeur de chaque horodatage à la précision spécifiée.

Effectue ce calcul sur chaque valeur.

(v / precision) * precision

Tableau 55. Paramètres

Nom	Type	Description
précision	Numéro	Valeur à utiliser dans le calcul de l’arrondi.

Tableau 56. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : stddev()

Créez une série contenant l’écart-type des valeurs de chaque horodatage dans un ensemble de séries.

Tableau 57. Paramètres

Nom	Type	Description
Aucun

Tableau 58. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart - sous(constante d’objet)

Soustrayez le nombre spécifié de la valeur de chaque horodatage.

Tableau 59. Paramètres

Nom	Type	Description
constante	Objet	Nombre à soustraire de la valeur de chaque horodatage.

Tableau 60. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : sum()

Regroupez les séries de mesures sélectionnées en une seule série contenant la somme de toutes les valeurs pour chaque horodatage.

Tableau 61. Paramètres

Nom	Type	Description
Aucun

Tableau 62. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : top(nombre de nombres)

Créez un ensemble de résultats qui, pour chaque horodatage, renvoie le nombre spécifié de valeurs principales. Cette méthode permet d’obtenir le nombre de séries. Chaque valeur conserve l’étiquette de sa série source.

Tableau 63. Paramètres

Nom	Type	Description
compter	Numéro	Nombre de séries à renvoyer. Les séries sont étiquetées de 0 à 1.

Tableau 64. Renvoie

Type	Description
Transformer la pièce	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.