SamplingRate (FPScript)
Détermine le taux d'échantillonnage d'un ensemble de données ou de sa composante X dont les valeurs augmentent ou diminuent de façon linéaire.
Syntaxe
SamplingRate(DataSet)
La syntaxe de la fonction SamplingRate se compose des éléments suivants :
Section |
Description |
|---|---|
DataSet |
L'ensemble de données dont le taux d'échantillonnage est déterminé. 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. Le taux d'échantillonnage correspond à la réciproque de la différence de valeurs consécutives dans l'ensemble de données. Toutefois, les incréments entre des valeurs adjacentes ne doivent pas nécessairement être exactement les mêmes, mais peuvent différer de 1 % au maximum. Si cette bande de tolérance est dépassée, si l'incrément est égal à zéro, si l'ensemble de données ne contient pas au moins deux valeurs, ou s'il contient des valeurs invalides (void), alors une valeur à virgule flottante invalide est renvoyée. Sinon, la réciproque de l'augmentation entre la première et la deuxième valeur est rendue.
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
SamplingRate({1, 3, 5}) |
Renvoie 0.5. |
SamplingRate({1, 1, 1}) |
Renvoie ?. |
SamplingRate({1, 2.001, 3}) |
Renvoie 0.999000999. |
SamplingRate({1, 2, 3.001}) |
Renvoie 1.. |
SamplingRate({1, 2.1, 3}) |
Renvoie ?. |
SamplingRate({1, 2, ?, 4}) |
Renvoie ?. |
SamplingRate((10, 0 s, 0.5 s)) |
Renvoie 2 Hz. |
SamplingRate(Signal({1 V, 1.5 V }, 0.5 ms)) |
Renvoie 2 kHz. |