NextValueInSpike (FPScript)
Recherche la prochaine valeur dans un pic à partir d'une position donnée.
Syntaxe
NextValueInSpike(DataSet, [ Position ], MinHeight, MaxWidth [ , Direction = EVENT_RIGHT ])
La syntaxe de la fonction NextValueInSpike se compose des éléments suivants :
Section |
Description |
||||||
|---|---|---|---|---|---|---|---|
DataSet |
L'ensemble de données dans lequel rechercher. Les structures de données autorisées sont Séries de données et Signal. Tous les types de données numériques sont autorisés. Pour les types de données complexes, un nombre est formé. 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. |
||||||
Position |
Si vous recherchez dans un signal, il s'agit de la valeur X où la recherche doit commencer. Si vous recherchez une série de données, il s'agit de l'index de la valeur à partir de laquelle vous devez lancer la recherche. Un indice négatif détermine une position par rapport à la fin de l'ensemble de données. Si vous omettez l'argument ou passez la valeur Empty, la recherche commence au début ou à la fin de l'ensemble de données, selon la direction de la recherche. La première ou la dernière valeur de l'ensemble de données n'est prise en compte que si vous omettez l'argument ou passez la valeur Empty. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. L'unité doit être compatible avec celle du paramètre DataSet . Pour les types de données complexes, un nombre est formé. 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. |
||||||
MinHeight |
Spécifie la quantité de delta y minimum qui doit être atteinte pour détecter le début ou la fin d'un pic. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. L'unité doit être compatible avec celle du paramètre DataSet . Pour les types de données complexes, un nombre est formé. 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. |
||||||
MaxWidth |
Nombre maximum de points de données qu'un pic peut avoir. Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés. 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. |
||||||
Direction |
Précise la direction de la recherche dans la fonction. L'argument Direction peut avoir les valeurs suivantes :
Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut EVENT_RIGHT . |
Remarques
Un pic montant est détecté, par exemple, lorsque le signal augmente d'au moins MinHeight et tombe au plus tard après MaxWidth points de données par au moins -MinHeight. Les pics situés au début ou à la fin de l'ensemble de données sont également détectés, c'est-à-dire que le début de l'ensemble de données est considéré comme le début du pic et la fin de l'ensemble de données est considérée comme la fin du pic en conséquence. Si DataSet est une série de données, alors le résultat est l'indice de la valeur trouvée. Si DataSet est un signal, le résultat est la valeur X. Si aucune prochaine valeur n'a pu être trouvée dans un pic, alors la valeur Empty est renvoyée comme résultat.
Le graphique suivant montre un signal avec deux pics mis en évidence :
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
NextValueInSpike(Signal, , 0.2 V, 1, EVENT_LEFT) |
Recherche dans un signal à partir de l'extrémité du signal vers la gauche pour trouver la prochaine valeur dans un pic. La hauteur minimale des pics est de 0,2 V et la largeur maximale est d'un point de données. Le résultat est la valeur X du pic trouvé. |
Signal[[NextValueInSpike(Signal, 4.5 s, 0.2 V, 1)]] |
Recherche dans un signal à partir de la position X = 4,5 s vers la droite pour la prochaine valeur dans un pic. Le résultat est la valeur Y de la position trouvée. |