Busca el siguiente valor que esté por encima de un determinado nivel.
Sintaxis
NextValueAboveLevel(DataSet, [ Position ], Level, [ Direction = EVENT_RIGHT ], [ DeltaXmin ] [ , DeltaXmax ])
La sintaxis de la función NextValueAboveLevel 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. El valor en sí no se incluye en la búsqueda. Si busca en una serie de datos, es el índice del valor a partir del cual quiere buscar. El índice en sí no se incluye en la búsqueda. 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. |
||||||
Level |
Nivel por encima del cual debe situarse el valor. También se encuentran valores que se sitúan exactamente en el nivel. 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 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
NextValueAboveLevel({2, 3, 4, 3, 2}, , 2) |
Devuelve 0L. Busca en el conjunto de datos desde el inicio hacia la derecha el siguiente valor que sea al menos 2. |
NextValueBelowLevel({2, 3, 4, 3, 2}, 0, 3) |
Busca en el conjunto de datos desde el índice 0 hacia la derecha el siguiente valor que sea al menos 2. El resultado es el índice 1, puesto que la búsqueda ya no se realiza para la posición 0. |
NextValueAboveLevel(Signal, 5.5 s, 0.8 V, EVENT_LEFT) |
Busca en una señal desde la posición X = 5,5 s hacia la izquierda el siguiente valor que sea al menos 0,8 V. El resultado es el valor X del valor encontrado. |
Signal[[NextValueAboveLevel(Signal, 4.5 s, 0.6 V)]] |
Busca en una señal desde la posición X = 4,5 s hacia la derecha el siguiente valor que sea al menos 0,6 V. El resultado es el valor Y encontrado. |
NextValueAboveLevel(Datenreihe, 100, 1.2) |
Busca en una serie de datos desde la posición de índice 100 hacia la derecha el siguiente valor que sea al menos 1,2 V. El resultado es el índice del valor encontrado. |