TransformPart : champ d’application, global

Utilisez la classe TransformPart 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. Lorsque vous utilisez la classe TransformPart , utilisez l’identificateur d’espace de noms sn_clotho.

Il n’existe aucun constructeur pour cette classe. Les objets TransformPart sont retourné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 transform.
• 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 - add(Number constant)

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

Tableau 1. Paramètres

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

Tableau 2. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart - avg()

Agrégez les séries de mesures sélectionnées en une seule contenant la valeur moyenne de chaque horodatage.

Tableau 3. Paramètres

Nom	Type	Description
Aucun

Tableau 4. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart : bas (nombre de nombres)

Créez un ensemble 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 à compter - 1.

Tableau 6. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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 n’importe quel horodatage.

Tableau 8. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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 transformation, ne sont pas collectées par défaut. 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart - count()

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

Tableau 11. Paramètres

Nom	Type	Description
Aucun

Tableau 12. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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 durée spécifiée.

Tableau 15. Paramètres

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

Tableau 16. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart que vous pouvez utiliser pour spécifier des caractéristiques de transformation.

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

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

Tableau 17. Paramètres

Nom	Type	Description
étage	Numéro	Valeur minimale pour n’importe quel horodatage.

Tableau 18. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart - fractiles(Array fractions)

Créez une série composée de la valeur ci-dessous correspondant au pourcentage de valeurs spécifié. Renvoie une série pour chaque fraction du tableau spécifié.

La valeur d’un horodatage dans une série renvoyé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 d’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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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()

Renvoyer 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 d’appeler la méthode getResult().

Tableau 21. Paramètres

Nom	Type	Description
Aucun

Tableau 22. Renvoie

Type	Description
Résultat transformateur	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 par lequel regrouper les données. Pour spécifier plusieurs champs, exécutez les 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 transformation.

Tableau 24. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

L’exemple suivant montre comment regrouper les mesures moyennes d’altitude par champs de flotte et 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 autre que NaN. Si aucune valeur autre que NaN n’est trouvée, NaN est utilisé.

Tableau 26. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart - limit(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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart : log(base des nombres)

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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart - max()

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

Tableau 35. Paramètres

Nom	Type	Description
Aucun

Tableau 36. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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) d’un horodatage est la médiane.

Tableau 37. Paramètres

Nom	Type	Description
Aucun

Tableau 38. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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
Métrique	Chaîne	Nom du champ de mesure.

Tableau 40. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart - mul(Constante de nombre)

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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart – partition(agrégateur de chaînes, 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	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 de zéro pour le partitionnement. Par exemple, si vous partitionnez de jour (24h), définissez la base sur Lundi à minuit dans votre fuseau horaire. Si vous divisez par 30 jours, définissez la base sur le 1er jour du mois le plus récent.

Tableau 46. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart : rééchantillon(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 a moins de points de données que spécifié, les 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart : rééchantillonner(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 différentes périodes de temps (granularités).

Cette méthode détermine 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart – resample(String aggregator, Number numValues)

Spécifiez un agrégateur à utiliser pour créer un jeu 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart – resample(String aggregator, GlideDuration duration)

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 à la période demandée.

• Lorsque la série chronologique est stockée toutes les minutes et que resample(AVG, new GlideDuration(« 1 :00 »)) est appelé, le résultat aura 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 (GlideDuration)	Période pour l’ensemble de résultats.

Tableau 54. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart - sub(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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart : sum()

Agrégez la série de mesures sélectionnée 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
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.

TransformPart : haut (nombre de nombres)

Créez un jeu 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 à compter - 1.

Tableau 64. Renvoie

Type	Description
TransformPart (Pièce transformée)	Objet TransformPart qui peut être utilisé pour spécifier des caractéristiques de transformation.