Busca el siguiente valor que se encuentre dentro de un intervalo determinado o el siguiente valor inválido.
Sintaxis
NextValueInInterval(DataSet, [ Position ], LowerLimit, UpperLimit, [ Direction = EVENT_RIGHT ], [ DeltaXmin ] [ , DeltaXmax ])
La sintaxis de la función NextValueInInterval consta de los siguientes elementos:
Parte |
Descripción |
||||||
|---|---|---|---|---|---|---|---|
DataSet |
Es el conjunto de datos en el que se va a buscar. Las estructuras de datos permitidas son Serie de datos y Señal. Se permiten todos los tipos de datos numéricos. En los tipos de datos complejos se calcula un valor absoluto. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||
Position |
Si busca en una señal, es el valor X a partir del cual quiere buscar. Si busca en una serie de datos, es el índice del valor a partir del cual quiere buscar. Un índice negativo determina una posición relativa al final del conjunto de datos. Si omite el argumento o transmite el valor Empty, la búsqueda comienza al incio o al final del conjunto de datos, dependiendo de la dirección de búsqueda. El primer o último valor del conjunto de datos solo se tiene en cuenta si se omite el argumento o se transmite el valor Empty. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos numéricos. La unidad debe ser compatible con la del parámetro DataSet. En los tipos de datos complejos se calcula un valor absoluto. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||
LowerLimit |
Límite inferior del intervalo en el que debe situarse el valor. También se encuentran valores que se sitúan exactamente en el límite. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos numéricos. La unidad debe ser compatible con la del parámetro DataSet. En los tipos de datos complejos se calcula un valor absoluto. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||
UpperLimit |
Límite superior del intervalo en el que debe situarse el valor. También se encuentran valores que se sitúan exactamente en el límite. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos numéricos. La unidad debe ser compatible con la del parámetro DataSet. En los tipos de datos complejos se calcula un valor absoluto. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||
Direction |
Define la dirección de búsqueda de la función. El argumento Direction puede tener los siguientes valores:
Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. Se establece el valor predeterminado EVENT_RIGHT si no se especifica el argumento. |
||||||
DeltaXmin |
Especifica de forma opcional la duración mínima o el número de valores que debe tener un evento para ser válido. Si busca en una señal, esto corresponde al rango X desde el primer valor del evento hasta el último valor del evento. Si está buscando en una serie de datos, este es el número mínimo de puntos de datos que debe tener el evento. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos numéricos. La unidad debe ser compatible con la del parámetro DataSet. En los tipos de datos complejos se calcula un valor absoluto. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||
DeltaXmax |
De forma opcional, especifica la duración máxima o el número de valores que puede tener un evento para ser válido. Si busca en una señal, esto corresponde al rango X desde el primer valor del evento hasta el último valor del evento. Si está buscando en una serie de datos, este es el número máximo de puntos de datos que debe tener el evento. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos numéricos. La unidad debe ser compatible con la del parámetro DataSet. En los tipos de datos complejos se calcula un valor absoluto. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
Notas
El resultado siempre tiene la estructura de datos Valor escalar.
Si desea buscar un valor determinado, debe introducirlo como límite superior e inferior. Puede buscar valores inválidos estableciendo LowerLimit y UpperLimit como inválidos. Si DataSet es una serie de datos, el resultado es el índice del valor encontrado. Si DataSet es una señal, el resultado es el valor X del valor Y encontrado. Si no se encuentra ningún valor, el resultado es el valor Empty.
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
NextValueInInterval(Signal, 5.5 s, 800 mV, 1.2 V, EVENT_LEFT) |
Busca en una señal desde la posición X = 5,5 s hacia la izquierda el siguiente valor que se encuentre en el intervalo [0,8 V, 1,2 V]. El resultado es el valor X del valor encontrado. |
NextValueInInterval(Signal, , ?, ?) |
Busca el siguiente valor inválido en una señal desde el inicio de la señal hacia la derecha. El resultado es el valor X del valor encontrado. |
Signal[[NextValueInInterval(Signal, 4.5 s, 0.6 V, 1.0 V)]] |
Busca en una señal desde la posición X = 4,5 s hacia la derecha el siguiente valor que se encuentre en el intervalo [0,6 V, 1,0 V]. El resultado es el valor Y encontrado. |
NextValueInInterval(Datenreihe, 100, 1.2 V, 1.2 V) |
Busca en una serie de datos desde la posición índice 100 hacia la derecha el siguiente valor 1,2 V. El resultado es el índice del valor encontrado. |