NextValueInInterval (FPScript)
Recherche de la prochaine valeur dans un intervalle particulier ou de la prochaine valeur invalide (void).
Syntaxe
NextValueInInterval(DataSet, [ Position ], LowerLimit, UpperLimit, [ Direction = EVENT_RIGHT ], [ DeltaXmin ] [ , DeltaXmax ])
La syntaxe de la fonction NextValueInInterval 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. |
||||||
LowerLimit |
La limite inférieure de l'intervalle dans lequel la valeur doit se situer. Les valeurs qui se situent exactement sur la limite sont également trouvées. 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. |
||||||
UpperLimit |
La limite supérieure de l'intervalle dans lequel la valeur doit se situer. Les valeurs qui se situent exactement sur la limite sont également trouvées. 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 |
Précise la direction de la recherche dans 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 . |
||||||
DeltaXmin |
Détermine facultativement la durée minimale ou le nombre de valeurs qu'un événement doit durer pour être valable. Si vous effectuez une recherche dans un signal, cela équivaut à la plage X de la première valeur à la dernière valeur de l'événement. Si vous effectuez une recherche dans une série de données, c'est le nombre minimum de points de données que l'événement doit avoir. 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 son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||
DeltaXmax |
Détermine facultativement la durée maximale ou le nombre de valeurs qu'un événement peut durer pour être valable. Si vous effectuez une recherche dans un signal, cela équivaut à la plage X de la première valeur à la dernière valeur de l'événement. Si vous effectuez une recherche dans une série de données, c'est le nombre maximum de points de données que l'événement peut avoir. 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 son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Remarques
Le résultat a toujours la structure de données Scalaire.
Si vous souhaitez rechercher une valeur spécifique, vous devez la spécifier comme limite supérieure et inférieure. Vous pouvez rechercher des valeurs invalides (void) en définissant LowerLimit et UpperLimit à invalide (void). Si DataSet est une série de données, le résultat est l'indice de la valeur trouvée. Si DataSet est un signal, alors le résultat est la valeur X de la valeur Y trouvée. Si aucune valeur n'a pu être trouvée, la valeur Empty est renvoyée comme résultat.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
NextValueInInterval(Signal, 5.5 s, 800 mV, 1.2 V, EVENT_LEFT) |
Recherche dans un signal la prochaine valeur dans l'intervalle [0,8 V, 1,2 V] à partir de la position X = 5,5 s et en allant vers la gauche. Le résultat est la valeur X de la valeur trouvée. |
NextValueInInterval(Signal, , ?, ?) |
Recherche dans un signal la prochaine valeur invalide (void) en commençant par le début du signal et en allant vers la droite. Le résultat est la valeur X de la valeur trouvée. |
Signal[[NextValueInInterval(Signal, 4.5 s, 0.6 V, 1.0 V)]] |
Recherche dans un signal la prochaine valeur dans l'intervalle [0,6 V, 1,0 V] en partant de la position X = 4,5 s et en allant vers la droite. Le résultat est la valeur Y trouvée. |
NextValueInInterval(DataSeries, 100, 1.2 V, 1.2 V) |
Recherche dans une série de données la prochaine valeur 1,2 V en partant de la position 100 de l'indice et en allant vers la droite. Le résultat est l'indice de la valeur trouvée. |