NextNegativePeak (FPScript)

21.09.2021

Recherche dans un ensemble de données le prochain pic négatif à partir d'une position prédéfinie.

Syntaxe

NextNegativePeak(DataSet, [ Position ], Level, [ Orientation = EVENT_BOTH ], [ Direction = EVENT_RIGHT ], [ DeltaXmin ] [ , DeltaXmax ])

 

La syntaxe de la fonction NextNegativePeak 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.

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.

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 où la recherche doit commencer. Ici, 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 le sens 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.

Level

Spécifie le niveau en dessous duquel les valeurs doivent se situer. Seul les pics qui ont des passages de niveau dans les deux sens sont trouvés. 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 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 :

Constante

Signification

EVENT_BEGINNING

Rechercher uniquement les débuts de pics.

EVENT_END

Rechercher uniquement les fins de pics.

EVENT_BOTH

Rechercher les débuts et les fins de pics.

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 .

Direction

Précise la direction de la recherche dans la fonction.

L'argument Direction peut avoir les valeurs suivantes :

Constante

Signification

EVENT_RIGHT

Chercher à droite.

EVENT_LEFT

Chercher à gauche.

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 .

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, cela équivaut à la plage X de la première valeur à 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, cela équivaut à la plage X de la première valeur à 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

Le résultat a toujours la structure de données Scalaire.

Si DataSet est une série de données, le résultat est l'indice du pic de début ou de fin trouvé. Si DataSet est un signal, alors le résultat est la valeur X du début ou de la fin du pic. Si aucun pic n'a pu être trouvé, la valeur Empty est renvoyée comme résultat.

Disponible dans

FlexPro Basic, Professional, Developer Suite

Exemples

NextNegativePeak(Signal({2,4,4,3,2,1,4,3,2,1,1,4,1},1), , 2, EVENT_BOTH, EVENT_RIGHT, 2)

Renvoie 8. Recherche dans l'ensemble de données depuis le début le prochain pic négatif d'une largeur minimale de 2, pour lequel le passage de niveau est à 2. La valeur X où le pic commence est renvoyée.

NextNegativePeak({3,4,4,2,2,1,4,3,2,1,4,1}, , 2, EVENT_BOTH, EVENT_RIGHT, , 2)

Renvoie 8L. Recherche dans l'ensemble de données depuis le début le prochain pic négatif avec un maximum de 2 valeurs dont le passage de niveau est à 2. L'indice où le pic commence est renvoyé.

Voir aussi

Fonction PositivePeaks

Fonction NegativePeaks

Fonction NextPositivePeak

Fonction LevelCrossings

Fonction ValuesAboveLevel

Fonction ValuesBelowLevel

Fonction ValuesInInterval

Objet d'analyse Isolation d'événements

Partager l’article ou envoyer par mail :

Vous serez probablement intéressé par les articles suivants :