GlobalMaximum (FPScript)

21.09.2021

Recherche du maximum global dans un ensemble de données.

Syntaxe

GlobalMaximum(DataSet [ , Operation = EVENT_DEFAULT ])

 

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

Operation

Précise le mode de fonctionnement de la fonction. Si vous omettez l'argument, la fonction pour les séries de données et les signaux fournit l'indice du maximum trouvé comme valeur scalaire. Pour les matrices de données et les séries de signaux, EVENT_SETVOID est utilisé dans ce cas.

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

Le maximum global est la valeur la plus élevée de l'ensemble de données. La fonction GlobalMaximum renvoie l'emplacement du maximum global. Utilisez la fonction Maximum avec l'option CALC_GLOBAL pour obtenir la valeur du maximum global. Si plusieurs de ces valeurs existent, seule la première valeur est reconnue comme un maximum global. Utilisez la fonction GlobalExtrema si vous voulez trouver toutes les occurrences dans ce cas.

Disponible dans

FlexPro Basic, Professional, Developer Suite

Exemples

GlobalMaximum({1,4,3,7,4,5})

Renvoie 3L. Le résultat est l'indice de la valeur la plus élevée en tant que valeur scalaire.

GlobalMaximum({1,4,3,7,4,5}, EVENT_INDEX)

Renvoie {3L}. Le résultat est l'indice de la valeur la plus élevée en tant que série de données.

Voir aussi

Fonction GlobalMinimum

Fonction GlobalExtrema

Fonction NextGlobalExtremum

Fonction Maximum

Objet d'analyse Isolation d'événements

Partager l’article ou envoyer par mail :

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