Saltar navegación

Documentación de FlexPro 2025

LevelCrossings

Busca pasos a nivel en un conjunto de datos.

Sintaxis

LevelCrossings(DataSet, Level, Hysteresis, [ Orientation = EVENT_BOTH ] [ , Operation = EVENT_DEFAULT ])

 

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

Level

Especifica el nivel cuyos pasos se buscan.

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.

Hysteresis

La histéresis forma una banda simétrica [nivel - histéresis, nivel + histéresis] en torno al nivel especificado. Solo se acepta un cruce de nivel si la curva entra en la banda por un lado y sale por el otro.

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 la orientación de los pasos a nivel que se van a buscar.

El argumento Orientation puede tener los siguientes valores:

Constante

Significado

EVENT_POSITIVE

Buscar solo pasos a nivel crecientes.

EVENT_NEGATIVE

Buscar solo pasos a nivel decrecientes.

EVENT_BOTH

Buscar pasos a nivel crecientes y decrecientes.

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.

Notas

La histéresis evita la detección múltiple de transiciones de nivel en caso de señales con ruido. Si la curva oscila varias veces alrededor del nivel antes de salir de la banda de histéresis, se transfiere como índice el valor medio del primer y el último paso por el nivel.

Disponibilidad

FlexPro Basic, Professional, Developer Suite

Ejemplos

LevelCrossings({1, 5, 7, 4, 3}, 5, 0)

Devuelve {1L, 2L}. El resultado son los índices de los puntos en los que se ha superado el nivel.

Véase también

Función NextLevelCrossing

Función ValuesAboveLevel

Función ValuesBelowLevel

Función ValuesInInterval

Función Intersections

Objeto de análisis Aislamiento de eventos