TransformPart : dans le champ d’application, 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 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 : add(constante de nombre)

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

Tableau 1. Paramètres

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

Tableau 2. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : avg()

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

Tableau 3. Paramètres

Nom	Type	Description
Aucun

Tableau 4. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : bas (nombre de numéros)

Créez un jeu de résultats qui, pour chaque horodatage, renvoie un nombre spécifié de valeurs inférieures. Cette méthode permet de « compter » 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 0 pour compter - 1.

Tableau 6. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : plafond du nombre (plafond)

Remplacez la valeur de tout 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	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : collect()

Marquez cette transformation pour collecte.

Par défaut, les transformations qui font partie d’une chaîne, mais pas la dernière, ne sont 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
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : count()

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

Tableau 11. Paramètres

Nom	Type	Description
Aucun

Tableau 12. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : div(constante de nombre)

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

Tableau 13. Paramètres

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

Tableau 14. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : filter(agrégateur d’objets, durée d’objet)

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

Tableau 15. Paramètres

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

Tableau 16. Renvoie

Type	Description
TransformPart	Objet TransformPart que vous pouvez utiliser pour spécifier les caractéristiques de transformation.

TransformPart : floor(numéro, étage)

Remplacez la valeur de tout horodatage inférieur à la valeur spécifiée par la valeur spécifiée.

Tableau 17. Paramètres

Nom	Type	Description
sol	Numéro	Valeur minimale de n’importe quel horodatage.

Tableau 18. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : fractiles (fractions de tableau)

Créez une série composée de la valeur sous laquelle le pourcentage de valeurs spécifié se trouve. 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 0,5, la valeur de l’horodatage est la valeur où la moitié des valeurs de la série d’entrée sont inférieures (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	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()

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 de transformation	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 sur 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	Objet TransformPart qui peut être utilisé pour spécifier les 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 effectuant une interpolation à partir des 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 aucune valeur non NaN n’est trouvée, NaN est utilisé.

Tableau 26. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : iqr()

Effectuez une transformation de l’intervalle interquartile.

Crée un ensemble 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, médiane de la plus petite moitié des entrées
• Q3, médiane de la plus grande moitié des entrées

Tableau 27. Paramètres

Nom	Type	Description
Aucun

Tableau 28. Renvoie

Type	Description
TransformPart	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 la transformation.

Tableau 30. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : limit(nombre d’objets)

Renvoie au maximum le nombre spécifié de valeurs, 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	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
TransformPart	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
TransformPart	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 y a n séries dans l’objet TranformPart, 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
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : metric(String metric)

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
TransformPart	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
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les 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	Objet TransformPart qui peut être utilisé pour spécifier les 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	L’agrégateur à utiliser. Peut être min, max, avg ou last.
durée	GlideDateTime ou une chaîne au format ISO 8601	La longueur de l’intervalle.
base	GlideDateTime ou une chaîne au format ISO 8601	Décalage nul pour le partitionnement. Par exemple, si vous partitionnez par jour (24h), définissez la base sur lundi à minuit dans votre fuseau horaire. Si vous partitionnez par 30 jours, définissez la base sur le 1er jour du mois le plus récent.

Tableau 46. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : resample(Nombre de numéros)

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 a plus de points de données que spécifié, la moyenne des valeurs multiples 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 de mieux correspondre 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	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : resample(Number min, Number 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 différentes (granularités).

Cette méthode détermine le nombre moyen de points par série et si celui-ci se situe entre le minimum et le maximum spécifiés, chaque série est rééchantillonnée à ce nombre moyen de points. Si la moyenne calculée est supérieure ou inférieure au maximum 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. Si l’on ne dispose pas de suffisamment d’échantillons, 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	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 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 de mieux correspondre 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 le jeu 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	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : resample(agrégateur de chaîne, 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 à la période demandée.

• Lorsque la série chronologique est stockée à un intervalle de 1 minute et que resample(AVG, new GlideDuration(« 1:00 »)) est appelé, le résultat aura un point de données à chaque heure 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 de mieux correspondre 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	Durée GlideDuration	La période de l’ensemble de résultats.

Tableau 54. Renvoie

Type	Description
TransformPart	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
TransformPart	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 pour chaque horodatage dans un ensemble de séries.

Tableau 57. Paramètres

Nom	Type	Description
Aucun

Tableau 58. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les 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	Numéro à soustraire de la valeur de chaque horodatage.

Tableau 60. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : somme()

Regrouper la série de mesures sélectionnée en une 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	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.

TransformPart : top (nombre de numéros)

Créez un jeu de résultats qui, pour chaque horodatage, renvoie le nombre spécifié de valeurs principales. Cette méthode permet de « compter » 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 0 pour compter - 1.

Tableau 64. Renvoie

Type	Description
TransformPart	Objet TransformPart qui peut être utilisé pour spécifier les caractéristiques de transformation.