Saltar navegación

Documentación de FlexPro 2025

ValuesInBursts

Busca en un conjunto de datos los valores que pertenecen a una ráfaga.

Sintaxis

ValuesInBursts(DataSet, Threshold, DeltaX [ , Operation = EVENT_DEFAULT ])

 

La sintaxis de la función ValuesInBursts consta de los siguientes elementos:

Parte

Descripción

DataSet

El conjunto de datos en el que se va a buscar.

Las estructuras de datos permitidas son Serie de datos, Matriz de datos, Señal y Serie de señales. 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.

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.

Operation

Define el método de operación de la función.

El argumento Operation puede tener los siguientes valores:

Constante

Significado

EVENT_INDEX

Los índices de los valores o puntos que corresponden a la condición se almacenan en el conjunto de datos resultante.

EVENT_EXTRACT

Sólo los puntos o valores que cumplen la condición se transfieren al conjunto de datos de resultante.

EVENT_SETVOID

Los puntos o valores que no cumplen la condición se transfieren al conjunto de datos resultante, pero se marcan como no válidos.

EVENT_DEFAULT

Corresponde a EVENT_SETVOID si existe una matriz de datos o una serie de señales, y en caso contrario EVENT_INDEX.

+ EVENT_COMPLEMENT

Esta constante puede añadirse opcionalmente e invierte la operación seleccionada. Por ejemplo EVENT_EXTRACT se transfieren los puntos que no corresponden a la condición.

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

Notas

El argumento DeltaX debe ser lo más pequeño posible, pero mayor que la duración del período, para que las ondas individuales no se reconozcan como ráfagas individuales. La función puede utilizarse para analizar no solo señales periódicas. La función también puede utilizarse, por ejemplo, para extraer un aumento de una señal. Para DeltaX igual a cero, la función representa un simple decisor de valor umbral.

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

Disponibilidad

FlexPro Basic, Professional, Developer Suite

Ejemplos

Arguments s
Dim idx, y, n
idx = IndexNot(ValuesInBursts(s, 0.5, 1., EVENT_INDEX), NumberOfRows(s))
s.y[idx] = 0.
return s
 

Este ejemplo busca ráfagas en una señal y genera una señal en la que todos los valores que no pertenecen a ráfagas se ponen a cero.

ValuesInBursts({0, 0.1, 0, 0.1, 1.3, 1.2, 1.4, 0.3, 0.1, 0, 0.2}, 0.2, 1)
 

Devuelve {3L, 4L, 5L, 6L, 7L, 8L}. Este ejemplo busca valores en una ráfaga y devuelve los índices. Un valor pertenece a una ráfaga si él mismo o el valor vecino izquierdo o derecho está por encima del nivel 0,2.

Véase también

Función Bursts

Función NextBurst

Función NextValueInBurst

Objeto de análisis Aislamiento de eventos