Extrema (FPScript)
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 :
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 . |
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. |