Recherche de la valeur suivante dans une salve à partir d'une position donnée.
Syntaxe
NextValueInBurst(DataSet, le [ Position ], le Threshold, le DeltaX [ , le Direction Variable EVENT_RIGHT ])
La syntaxe de la fonction NextValueInBurst 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érie 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. Un indice négatif détermine une position relative à 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. |
||||||
Threshold |
Spécifie la valeur seuil pour la recherche de salves. Les valeurs pour lesquelles au moins une des valeurs voisines dans l'intervalle [-DeltaX, DeltaX] se trouve à gauche ou à droite se situe au-dessus du seuil sont affectées à une salve. Les structures de données autorisées sont Scalaire. 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. |
||||||
DeltaX |
Détermine l'intervalle [-DeltaX, DeltaX] dans lequel au moins une valeur doit se trouver au-dessus de la valeur seuil pour que la valeur respective à vérifier soit attribuée à la salve. 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. |
||||||
Direction |
Définit la direction de recherche de la fonction. L'argument Direction 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_RIGHT . |
Remarques
Une valeur est reconnue comme appartenant à une salve si elle-même ou au moins une des valeurs voisines dans l'intervalle [-DeltaX, DeltaX] à gauche ou à droite de celle-ci se trouve au-dessus du seuil. Si DataSet est une série de données, le résultat est l'indice de la valeur trouvée. Si DataSet est une série de données, alors le résultat est l'indice de la valeur trouvée. Si aucune valeur suivante n'a pu être trouvée dans une salve, la valeur Empty est renvoyée comme résultat.
L'illustration suivante montre un signal avec deux salves en surbrillance :
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
NextValueInBurst(Signal, , 0.2 V, 0.1 s, EVENT_LEFT) |
Recherche à l'intérieur d'un signal la prochaine valeur dans une salve, en commençant à la fin du signal et en se dirigeant vers la gauche. La valeur seuil est de 0,2 V et l'intervalle X [-0,1 s, 0,1 s]. Le résultat est la valeur X de la salve trouvée. |
Signal[[NextValueInBurst(Signal, 4.5 s, 0.2 V, 0.1 s)]] |
Recherche dans un signal la prochaine valeur dans une salve, en partant de la position X = 4,5 s et en se dirigeant vers la droite. Le résultat est la valeur Y de la position trouvée. |