Saltar navegación

Documentación de FlexPro 2025

PositivePeaks

Busca picos positivos en un conjunto de datos.

Sintaxis

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

 

La sintaxis de la función PositivePeaks 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 encima 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

Solo se encuentran los picos que tienen pasos a nivel en ambas direcciones. Se encuentra un inicio de pico si el valor es mayor o igual que el nivel y el valor anterior es menor que el nivel. Se encuentra un final de pico cuando el valor es mayor o igual que el nivel y el valor posterior es menor que el nivel.

Disponibilidad

FlexPro Basic, Professional, Developer Suite

Ejemplos

PositivePeaks({1,1,2,3,4,5,4,3,2,4,4,1,4}, 3, EVENT_POSITIVE)

Devuelve {3L, 9L, 12L}. Busca en el conjunto de datos picos positivos con un cruce de nivel de 3. Se devuelven los índices en los que comienzan los picos.

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

Devuelve {3L, 7L}. Busca en la señal picos positivos con un cruce de nivel de 3. Se devuelven los índices en los que comienzan y terminan los picos. Un pico debe tener un ancho mínimo de 3 y máximo de 4.

Véase también

Función NegativePeaks

Función NextPositivePeak

Función LevelCrossings

Función ValuesAboveLevel

Función ValuesBelowLevel

Función ValuesInInterval

Función TimePeriods

Objeto de análisis Aislamiento de eventos