Saltar navegación

Documentación de FlexPro 2025

NextBurst

Busca el siguiente inicio y/o final de una ráfaga a partir de una posición especificada.

Sintaxis

NextBurst(DataSet, [ Position ], Threshold, DeltaX, [ Orientation = EVENT_BOTH ] [ , Direction = EVENT_RIGHT ])

 

La sintaxis de la función NextBurst 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 inicio 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.

Threshold

Especifica el valor umbral para la búsqueda de ráfagas. Se asignan a una ráfaga los valores para los que al menos uno de los valores vecinos en el intervalo [-DeltaX, DeltaX] a la izquierda o a la derecha está por encima del valor umbral.

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.

DeltaX

Determina el intervalo [-DeltaX, DeltaX] en el que, al menos, un valor debe estar por encima del valor umbral para que el valor que se va a comprobar se asigne a la ráfaga.

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.

Orientation

Especifica si se busca un inicio de ráfaga, un final de ráfaga o ambos.

El argumento Orientation puede tener los siguientes valores:

Constante

Significado

EVENT_BEGINNING

Buscar solo inicios de ráfagas.

EVENT_END

Buscar solo finales de ráfaga.

EVENT_BOTH

Buscar inicios y finales de ráfagas.

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_BOTH si no se especifica el argumento.

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.

Notas

Se reconoce que un valor pertenece a una ráfaga si este o, al menos, uno de los valores vecinos en el intervalo [-DeltaX, DeltaX] a la izquierda o a la derecha del mismo están por encima del umbral. Si DataSet es una serie de datos, el resultado es el índice del inicio o final de ráfaga encontrado. Si DataSet es una señal, el resultado es el valor X. Si no se encuentra ninguna ráfaga, el resultado es el valor Empty.

El siguiente gráfico muestra una señal con dos ráfagas resaltadas:

Disponibilidad

FlexPro Basic, Professional, Developer Suite

Ejemplos

NextBurst(Signal, , 0.2 V, 0.1 s, EVENT_POSITIVE, EVENT_LEFT)

Busca el siguiente inicio de ráfaga en una señal desde el final de la señal hacia la izquierda. El valor umbral es 0,2 V y el intervalo X es [-0,1 s; 0,1 s]. El resultado es el valor X de la ráfaga encontrada.

Signal[[NextBurst(Signal, 4.5 s, 0.2 V, 0.1 s)]]

Busca el siguiente inicio o final de ráfaga en una señal desde la posición X = 4,5 s hacia la derecha. El resultado es el valor Y del evento encontrado.

Véase también

Función Bursts

Función ValuesInBursts

Función NextValueInBurst

Objeto de análisis Aislamiento de eventos