NegativePeaks (FPScript)
Recherche de pics négatifs dans un ensemble de données.
Syntaxe
NegativePeaks(DataSet, Level, [ Orientation = EVENT_BOTH ], [ Operation = EVENT_DEFAULT ], [ DeltaXmin ] [ , DeltaXmax ])
La syntaxe de la fonction NegativePeaks 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, Matrice de données, Signal et Série de signaux. Tous les types de données numériques sont autorisés. Des restrictions supplémentaires s'appliquent à la composante X.Les valeurs doivent être monotonement croissantes. 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. |
||||||||||||
Level |
Spécifie le niveau en dessous duquel les valeurs doivent se situer. 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. |
||||||||||||
Orientation |
Précise l'orientation des pics à trouver. L'argument Orientation 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_BOTH . |
||||||||||||
Operation |
Précise le mode de fonctionnement de la fonction. L'argument Operation 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_DEFAULT . |
||||||||||||
DeltaXmin |
Détermine facultativement la durée minimale ou le nombre de valeurs qu'un événement doit durer pour être valable. Si vous effectuez une recherche dans un signal, il s'agit de la plage X de la première valeur de l'événement à la dernière valeur de l'événement. Si vous effectuez une recherche dans une série de données, c'est le nombre minimum de points de données que l'événement doit avoir. 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 son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||
DeltaXmax |
Détermine facultativement la durée maximale ou le nombre de valeurs qu'un événement peut durer pour être valable. Si vous effectuez une recherche dans un signal, il s'agit de la plage X de la première valeur de l'événement à la dernière valeur de l'événement. Si vous effectuez une recherche dans une série de données, c'est le nombre maximum de points de données que l'événement peut avoir. 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 son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Remarques
Un début de pic est trouvé lorsque la valeur est inférieure ou égale au niveau et que la valeur précédente est supérieure au niveau. Une fin de pic est trouvée lorsque la valeur est inférieure ou égale au niveau et que la valeur suivante est supérieure au niveau. Les pics qui se trouvent au début ou à la fin de l'ensemble de données sont également trouvés.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
NegativePeaks({2,2,3,4,2,2,4,2}, 2, EVENT_POSITIVE) |
Renvoie {0L, 4L, 7L}. Recherche dans l'ensemble de données des pics négatifs dont le passage de niveau est à 2. Les indices où les pics commencent sont renvoyés. |
NegativePeaks(Signal({2,2,2,3,4,2,2,4,2},1), 2, EVENT_BOTH, EVENT_INDEX, , 1) |
Renvoie {5L, 6L, 8L, 8L}. Recherche dans le signal des pics négatifs dont le passage de niveau est à 2. Les indices où les pics commencent et se terminent sont renvoyés. Un pic peut avoir au maximum la largeur de 1. |