weisang.com > Documents Articles > LevelCrossings (FPScript)

Documentation FlexPro

LevelCrossings (FPScript)

21.09.2021

Recherche les passages de niveau dans un ensemble de données.

Syntaxe

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

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

Level

Précise le niveau pour lequel les passages de niveau doivent être trouvés.

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

L'hystérésis forme une bande symétrique [niveau - hystérésis, niveau + hystérésis] autour du niveau spécifié. Un passage de niveau n'est alors accepté que si la variation de la courbe entre dans la bande d'un côté et en sort de l'autre.

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 l'orientation des passages de niveau à trouver.

L'argument Orientation peut avoir les valeurs suivantes :

Constante	Signification
EVENT_POSITIVE	Rechercher uniquement les passages de niveau ascendants.
EVENT_NEGATIVE	Rechercher uniquement les passages de niveau descendants.
EVENT_BOTH	Rechercher les passages de niveau ascendants et descendants.

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

L'hystérésis empêche les passages de niveau d'être détectés plusieurs fois dans les signaux bruités. Si la variation de la courbe oscille plusieurs fois autour du niveau avant de quitter la bande d'hystérésis, alors la valeur moyenne du premier et du dernier passage par le niveau est passée comme indice.