NextSlopeAtLevel (FPScript)

21.09.2021

Recherche de la prochaine pente d'une inclinaison minimale spécifiée au passage d'un niveau à partir d'une certaine position.

Syntaxe

NextSlopeAtLevel(DataSet, [ Position ], Level, DeltaY, DeltaX, Hysteresis, [ Orientation = EVENT_BOTH ] [ , Direction = EVENT_RIGHT ])

 

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

Level

Précise le niveau que les pentes doivent franchir.

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.

DeltaY

Spécifie l'intervalle Y minimum par lequel l'amplitude doit monter ou descendre pour qu'une pente puisse être reconnue.

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.

DeltaX

Spécifie l'intervalle X dans lequel l'amplitude doit augmenter ou diminuer d'au moins la quantité de DeltaY.

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 la valeur maximale de l'amplitude du signal qui peut osciller sur une pente dans la direction opposée.

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 pentes descendantes et/ou ascendante.

L'argument Orientation peut avoir les valeurs suivantes :

Constante

Signification

EVENT_POSITIVE

Rechercher uniquement les pentes ascendantes.

EVENT_NEGATIVE

Rechercher uniquement les pentes descendantes.

EVENT_BOTH

Rechercher les pentes descendantes et ascendantes.

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.

La pente peut être caractérisée par le fait qu'elle passe par le niveau spécifié et que les valeurs adjacentes dépassent ou tombent en dessous de la pente spécifiée. Si DataSet est une série de données, le résultat est l'indice de la pente trouvée. Si DataSet est un signal, le résultat est la valeur X de la pente. Si aucune pente n'a pu être trouvée, la valeur Empty est sortie comme résultat.

Disponible dans

FlexPro Basic, Professional, Developer Suite

Exemples

NextSlopeAtLevel(Signal, 5.5 s, 0 V, 1.2 V, 0.1 s, EVENT_POSITIVE,EVENT_LEFT)

Recherche dans un signal de la position X = 5,5 s en se dirigeant vers la gauche pour la prochaine pente ascendante au niveau 0 V, qui augmente en 0,1 s d'au moins 1,2 V. Le résultat est la valeur X de la pente trouvée.

Signal[[NextSlopeAtLevel(Signal, 4.5 s, 0 V, 1.2 V, 0.1 s)]]

Recherche dans un signal de la position X = 4,5 s en se dirigeant vers la droite pour la prochaine pente ascendante au niveau 0 V. Le résultat est la valeur Y de la pente trouvée.

Voir aussi

Fonction SlopesAtLevel

Fonction Slopes

Fonction NextSlope

Objet d'analyse Isolation d'événements

Partager l’article ou envoyer par mail :

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