Busca en un conjunto de datos el siguiente pico positivo a partir de una posición especificada.
Sintaxis
NextPositivePeak(DataSet, [ Position ], Level, [ Orientation = EVENT_BOTH ], [ Direction = EVENT_RIGHT ], [ DeltaXmin ] [ , DeltaXmax ])
La sintaxis de la función NextPositivePeak 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 y Señal. 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. |
||||||||
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 incio 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. |
||||||||
Level |
Especifica el nivel por encima del cual deben situarse los valores. 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. 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:
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. |
||||||||
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
El resultado siempre tiene la estructura de datos Valor escalar.
Si DataSet es una serie de datos, el resultado es el índice del inicio o final del pico encontrado. Si DataSet es una señal, el resultado es el valor X del inicio o final del pico. Si no se encuentra ningún pico, el resultado es el valor Empty.
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
NextPositivePeak(Signal({3,1,1,3,2,1,4,3,2,1,4,1},1), , 2, EVENT_BOTH, EVENT_RIGHT, 2) |
Devuelve 6. Busca en el conjunto de datos desde el inicio el siguiente pico positivo con un ancho mínimo de 2 cuyo cruce de nivel sea 2. Se devuelve el valor X en el que comienza el pico. |
NextPositivePeak({2,4,4,3,2,1,4,3,2,1,4,1}, , 2, EVENT_BOTH, EVENT_RIGHT, , 2) |
Devuelve 10L. Busca en el conjunto de datos desde el inicio el siguiente pico positivo con un máximo de 2 valores con un cruce de nivel de 2. Se devuelve el índice en el que comienza el pico. |
NextPositivePeak({2,4,4,3,2,1,4,3,2,1,3,4,1}, -1, 2, EVENT_POSITIVE, EVENT_LEFT) |
Devuelve 10L. Busca desde el final del conjunto de datos en la dirección opuesta el siguiente pico positivo cuyo cruce de nivel sea 2. Se devuelve el índice en el que comienza el pico. |