Increment (FPScript)
Détermine l'incrément d'un ensemble de données ou de sa composante X avec des valeurs augmentant ou diminuant de façon linéaire.
Syntaxe
Increment(DataSet)
La syntaxe de la fonction Increment se compose des éléments suivants :
Section |
Description |
|---|---|
DataSet |
L'ensemble de données pour lequel l'incrément est déterminée. Toutes les structures de données sont autorisées, sauf Scalaire et Liste. Les types de données non pris en charge sont Chaîne de caractères. |
Remarques
Par conséquent, la fonction renvoie un scalaire du type de données Virgule flottante de 64 bits.
Le résultat a la même unité que l'argument DataSet.
Pour les signaux, les séries de signaux et les courbes 3D, seule la composante X est analysée. L'incrément correspond à la différence entre des valeurs consécutives de l'ensemble de données. Les incréments entre des valeurs voisines ne doivent toutefois pas être exactement les mêmes, mais peuvent s'écarter de 1 % au maximum. Si cette marge de tolérance est dépassée, si l'ensemble de données ne contient pas au moins deux valeurs ou s'il contient des valeurs invalides, , une valeur à virgule flottante invalide est transmise. Sinon, l'incrément entre la première et la deuxième valeur est renvoyée.
Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste.
Pour les types de données complexes, un nombre est formé.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
Increment({1, 3, 5}) |
Renvoie 2. |
Increment({1, 2.001, 3}) |
Renvoie 1.001. |
Increment({1, 2, 3.001}) |
Renvoie 1. |
Increment({1, 2.1, 3}) |
Renvoie ?. |
Increment({1, 2, ?, 4}) |
Renvoie ?. |
Increment((10, 0 Hz, 0.5 Hz)) |
Renvoie 0.5 Hz. |
Increment(Signal({1 V, 1.5 V }, 0.5 ms)) |
Renvoie 0.5 ms. |