Busca el siguiente valor en una ráfaga a partir de una posición especificada.
Sintaxis
NextValueInBurst(DataSet, [ Position ], Threshold, DeltaX [ , Direction = EVENT_RIGHT ])
La sintaxis de la función NextValueInBurst 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. 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. |
||||||
Threshold |
Especifica el valor umbral para la búsqueda de ráfagas. Se asignan a una ráfaga los valores para los que al menos uno de los valores vecinos en el intervalo [-DeltaX, DeltaX] a la izquierda o a la derecha está por encima del valor umbral. Las estructuras de datos permitidas son Valor escalar. 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. |
||||||
DeltaX |
Determina el intervalo [-DeltaX, DeltaX] en el que, al menos, un valor debe estar por encima del valor umbral para que el valor que se va a comprobar se asigne a la ráfaga. 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. |
||||||
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
Se reconoce que un valor pertenece a una ráfaga si este o, al menos, uno de los valores vecinos en el intervalo [-DeltaX, DeltaX] a la izquierda o a la derecha del mismo están por encima del umbral. Si DataSet es una serie de datos, el resultado es el índice del valor encontrado. Si DataSet es una señal, el resultado es el valor X. Si no se encuentra ningún valor siguiente en una ráfaga, el resultado es el valor Empty.
El siguiente gráfico muestra una señal con dos ráfagas resaltadas:
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
NextValueInBurst(Signal, , 0.2 V, 0.1 s, EVENT_LEFT) |
Busca el siguiente valor en una señal desde el final de la señal hacia la izquierda en una ráfaga. El valor umbral es 0,2 V y el intervalo X es [-0,1 s; 0,1 s]. El resultado es el valor X de la ráfaga encontrada. |
Signal[[NextValueInBurst(Signal, 4.5 s, 0.2 V, 0.1 s)]] |
Busca en una señal desde la posición X = 4,5 s hacia la derecha el siguiente valor en una ráfaga. El resultado es el valor Y de la ubicación encontrada. |