Saltar navegación

Documentación de FlexPro 2025

NextValueAboveLevel

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:

Constante

Significado

EVENT_RIGHT

Buscar a la derecha.

EVENT_LEFT

Buscar a la izquierda.

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.

Véase también

Función LevelCrossings

Función NextValueInInterval

Función NextValueBelowLevel

Función ValuesAboveLevel

Función ValuesBelowLevel

Función ValuesInInterval

Objeto de análisis Aislamiento de eventos