NextExtremum (FPScript)

21.09.2021

Recherche de l'extrême suivant à partir d'une position donnée.

Syntaxe

NextExtremum(DataSet, [ Position ], Hysteresis, [ Orientation = EVENT_BOTH ] [ , Direction = EVENT_RIGHT ])

 

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

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.

Hysteresis

Spécifie l'amplitude minimum dont le signal doit monter ou descendre après l'extrême pour que l'extrême soit accepté.

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 si des minima, des maxima ou les deux doivent être recherchés.

L'argument Orientation peut avoir les valeurs suivantes :

Constante

Signification

EVENT_POSITIVE

Rechercher uniquement les maximum locaux.

EVENT_NEGATIVE

Rechercher uniquement les minimum locaux.

EVENT_BOTH

Rechercher les minimum et les maximum 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 .

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 .

Remarques

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

L'extrémum local dans l'ensemble de données est identifiée 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é.

Si DataSet est une série de données, le résultat est l'indice de l'extrémum trouvé. Si DataSet est un signal, le résultat est la valeur X de l'extrémum. Si aucun extremum n'a pu être trouvé, la valeur Empty est renvoyée comme résultat.

Disponible dans

FlexPro Basic, Professional, Developer Suite

Exemples

NextExtremum(Signal, , 0.1 V, EVENT_POSITIVE, EVENT_LEFT)

Recherche dans un signal à partir de la fin du signal en direction de la gauche le prochain maximum local. L'hystérésis est de 0,1 V. Le résultat est la valeur X de l'extrémum trouvé.

Signal[[NextExtremum(Signal, 4.5 s, 0.1 V)]]

Recherche dans un signal le prochain minimum ou maximum local, en commençant à la position X = 4,5 s et en se dirigeant vers la droite. L'hystérésis est de 0,1 V. Le résultat est la valeur Y de l'extrémum trouvé.

Voir aussi

Fonction Extrema

Objet d'analyse Isolation d'événements

Partager l’article ou envoyer par mail :

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