Saltar navegación

Documentación de FlexPro 2025

NegativePeaks

Busca picos negativos en un conjunto de datos.

Sintaxis

NegativePeaks(DataSet, Level, [ Orientation = EVENT_BOTH ], [ Operation = EVENT_DEFAULT ], [ DeltaXmin ] [ , DeltaXmax ])

 

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

Se aplican restricciones adicionales al componente X. Los valores deben ser monótonos crecientes.

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

Especifica el nivel por debajo del cual deben situarse los valores.

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

Indica la orientación de los picos que se van a buscar.

El argumento Orientation puede tener los siguientes valores:

Constante

Significado

EVENT_BEGINNING

Buscar solo inicios de pico.

EVENT_END

Buscar solo finales de pico.

EVENT_BOTH

Buscar inicios y finales de pico.

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.

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.

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

Se encuentra un inicio de pico si el valor es menor o igual que el nivel y el valor anterior es mayor que el nivel. Se encuentra un final de pico cuando el valor es menor o igual que el nivel y el valor posterior es mayor que el nivel. También se encuentran picos situados al principio o al final del conjunto de datos.

Disponibilidad

FlexPro Basic, Professional, Developer Suite

Ejemplos

NegativePeaks({2,2,3,4,2,2,4,2}, 2, EVENT_POSITIVE)

Devuelve {0L, 4L, 7L}. Busca en el conjunto de datos picos negativos con un cruce de nivel de 2. Se devuelven los índices en los que comienzan los picos.

NegativePeaks(Signal({2,2,2,3,4,2,2,4,2},1), 2, EVENT_BOTH, EVENT_INDEX, , 1)

Devuelve {5L, 6L, 8L, 8L}. Busca en la señal picos negativos con un cruce de nivel de 2. Se devuelven los índices en los que comienzan y terminan los picos. Un pico puede tener un ancho máximo de 1.

Véase también

Función PositivePeaks

Función NextNegativePeak

Función LevelCrossings

Función ValuesAboveLevel

Función ValuesBelowLevel

Función ValuesInInterval

Función TimePeriods

Objeto de análisis Aislamiento de eventos