PositivePeaks (FPScript)

21.09.2021

Recherche de pics positifs dans un ensemble de données.

Syntaxe

PositivePeaks(DataSet, Level, [ Orientation = EVENT_BOTH ], [ Operation = EVENT_DEFAULT ], [ DeltaXmin ] [ , DeltaXmax ])

 

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

Précise le niveau au-dessus 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

Seul les pics qui ont des passages de niveau dans les deux sens sont trouvés.

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 .

Operation

Précise le mode de fonctionnement de la fonction.

L'argument Operation peut avoir les valeurs suivantes :

Constante

Signification

EVENT_INDEX

Les indices des valeurs ou des points remplissant la condition sont placés dans l'ensemble de données de résultat.

EVENT_EXTRACT

Seuls les points ou valeurs remplissant la condition sont transférés dans l'ensemble de données de résultat.

EVENT_SETVOID

Les points ou valeurs qui ne remplissent pas la condition sont également inclus dans l'ensemble de données de résultat, mais ils y sont marqués comme nuls.

EVENT_DEFAULT

Correspond à EVENT_SETVOID si une matrice de données ou une série de signaux est présente, et sinon EVENT_INDEX.

+ EVENT_COMPLEMENT

Cette constante peut être ajoutée de manière optionnelle et permet ensuite d'inverser l'opération sélectionnée. Ainsi, par exemple, avec EVENT_EXTRACT, les points qui ne correspondent pas à la condition sont copiés.

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

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 supérieure ou égale au niveau et que la valeur précédente est inférieure au niveau. Une fin de pic est trouvée lorsque la valeur est supérieure ou égale au niveau et que la valeur suivante est inférieure au niveau.

Disponible dans

FlexPro Basic, Professional, Developer Suite

Exemples

PositivePeaks({1,1,2,3,4,5,4,3,2,4,4,1,4}, 3, EVENT_POSITIVE)

Renvoie {3L, 9L, 12L}. Recherche dans l'ensemble de données des pics positifs dont le passage de niveau est à 3. Les indices où les pics commencent sont renvoyés.

PositivePeaks(Signal({1,1,2,3,4,5,4,3,2,4,4,1},1), 3, EVENT_BOTH, EVENT_INDEX, 3, 4)

Renvoie {3L, 7L}. Recherche dans le signal des pics positifs dont le passage de niveau est à 3. Les indices où les pics commencent et se terminent sont renvoyés. Une largeur de pic doit être au moins de 3, mais pas plus de 4.

Voir aussi

Fonction NegativePeaks

Fonction NextPositivePeak

Fonction LevelCrossings

Fonction ValuesAboveLevel

Fonction ValuesBelowLevel

Fonction ValuesInInterval

Fonction TimePeriods

Objet d'analyse Isolation d'événements

Partager l’article ou envoyer par mail :

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