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:
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:
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. |