Busca el siguiente extremo a partir de una posición especificada.
Sintaxis
NextExtremum(DataSet, [ Position ], Hysteresis, [ Orientation = EVENT_BOTH ] [ , Direction = EVENT_RIGHT ])
La sintaxis de la función NextExtremum consta de los siguientes elementos:
Parte |
Descripción |
||||||||
|---|---|---|---|---|---|---|---|---|---|
DataSet |
Es el conjunto de datos en el que se va a buscar. Las estructuras de datos permitidas son Serie de datos y Señal. 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. |
||||||||
Position |
Si busca en una señal, es el valor X a partir del cual quiere buscar. Si busca en una serie de datos, es el índice del valor a partir del cual quiere buscar. Un índice negativo determina una posición relativa al final del conjunto de datos. Si omite el argumento o transmite el valor Empty, la búsqueda comienza al inicio o al final del conjunto de datos, dependiendo de la dirección de búsqueda. El primer o último valor del conjunto de datos solo se tiene en cuenta si se omite el argumento o se transmite el valor Empty. 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 |
El valor mínimo que debe caer o subir la señal después del extremo para que este sea aceptado. 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 si se buscan mínimos, máximos o ambos. El argumento Orientation puede tener los siguientes valores:
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. |
||||||||
Direction |
Define la dirección de búsqueda de la función. El argumento Direction puede tener los siguientes valores:
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_RIGHT si no se especifica el argumento. |
Notas
El resultado siempre tiene la estructura de datos Valor escalar.
El extremo local del conjunto de datos se determina mediante un análisis de histéresis. Un valor se reconoce como máximo local si los valores precedentes del conjunto de datos aumentan, al menos, en el valor de histéresis especificado y los valores siguientes disminuyen, al menos, en el valor de histéresis especificado. Un valor se reconoce como mínimo local si los valores precedentes del conjunto de datos disminuyen, al menos, en el valor de histéresis especificado y los valores posteriores aumentan, al menos, en el valor de histéresis especificado.
Si DataSet es una serie de datos, el resultado es el índice del extremo encontrado. Si DataSet es una señal, el resultado es el valor X del extremo. Si no se encuentra ningún extremo, el resultado es el valor Empty.
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
NextExtremum(Signal, , 0.1 V, EVENT_POSITIVE, EVENT_LEFT) |
Busca el siguiente máximo local en una señal desde el final de la señal hacia la izquierda. La histéresis es de 0,1 V. El resultado es el valor X del extremo encontrado. |
Signal[[NextExtremum(Signal, 4.5 s, 0.1 V)]] |
Busca el siguiente mínimo o máximo local en una señal desde la posición X = 4,5 s hacia la derecha. La histéresis es de 0,1 V. El resultado es el valor Y del extremo encontrado. |