Saltar navegación

Documentación de FlexPro 2025

ValuesBelowLevel

Busca en un conjunto de datos los valores que están por debajo de un determinado nivel.

Sintaxis

ValuesBelowLevel(DataSet, Level, [ Operation = EVENT_DEFAULT ], [ DeltaXmin ] [ , DeltaXmax ])

 

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

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

También se encuentran valores que están exactamente en el nivel.

Disponibilidad

FlexPro Basic, Professional, Developer Suite

Ejemplos

ValuesBelowLevel({1, 5, 7, 4, 3}, 5)

Devuelve {0L, 1L, 3L, 4L}. El resultado son los índices de los valores que están por debajo del nivel.

ValuesBelowLevel({1, 7, 6, 4, 3}, 5, , 2)

Devuelve {3L, 4L}. El resultado son los índices de los valores que están por debajo del nivel. El número de valores vecinos del evento debe ser al menos 2.

ValuesBelowLevel(Signal({1, 7, 6, 4, 3}, (5, 0, 1)), 5, , 2)

Devuelve {}. No se encuentran índices porque el intervalo X de los valores vecinos que se encuentran por debajo del nivel es inferior a 2.

Véase también

Función ValuesAboveLevel

Función LevelCrossings

Función PositivePeaks

Función NegativePeaks

Función ValuesInInterval

Función TimePeriods

Función NextValueAboveLevel

Función NextValueBelowLevel

Función Trigger

Objeto de análisis Aislamiento de eventos