Extrema (FPScript)

21.09.2021

Recherche de minima et/ou maxima locaux dans un ensemble de données.

Syntaxe

Extrema(DataSet, Hysteresis, [ Orientation = EVENT_BOTH ] [ , Operation = EVENT_DEFAULT ])

 

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

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.

Hysteresis

Spécifie la valeur minimum dont l'amplitude du signal doit augmenter ou diminuer une fois qu'un maximum ou un minimum local a été reconnu pour qu'il soit accepté comme un extrema local.

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 s'il faut rechercher des minima, des maxima ou les deux.

L'argument Orientation peut avoir les valeurs suivantes :

Constante

Signification

EVENT_POSITIVE

Recherche uniquement les maxima locaux.

EVENT_NEGATIVE

Recherche uniquement les minima locaux.

EVENT_BOTH

Recherche les minima et maxima locaux.

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 .

Remarques

Les extrema locaux dans l'ensemble de données sont identifiés par une hystérésis. Une valeur est reconnue comme un maximum local lorsque les valeurs précédentes dans l'ensemble de données augmentent d'au moins la quantité d'hystérésis spécifiée, et que les valeurs suivantes diminuent d'au moins la quantité d'hystérésis spécifiée. Une valeur est reconnue comme un minimum local lorsque les valeurs précédentes de l'ensemble de données diminuent d'au moins la quantité d'hystérésis spécifiée, et que les valeurs suivantes augmentent d'au moins la quantité d'hystérésis spécifié.

Disponible dans

FlexPro Basic, Professional, Developer Suite

Exemples

Extrema({1, 3, 5, 4, 1}, 1, EVENT_BOTH, EVENT_EXTRACT)

Renvoie 5.

Voir aussi

Fonction NextExtremum

Objet d'analyse Isolation d'événements

Partager l’article ou envoyer par mail :

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