Toma segmentos de diferentes longitudes de un conjunto de datos y los devuelve como una lista.
Sintaxis
ExtractSegments(Data, BeginningsEnds [ , NameTemplate = "%1Segment%2" ])
o
ExtractSegments(Data, Beginnings, Ends [ , NameTemplate = "%1Segment%2" ])
La sintaxis de la función ExtractSegments consta de los siguientes elementos:
Parte |
Descripción |
|---|---|
Data |
El conjunto de datos que se va a segmentar. Las estructuras de datos permitidas son Serie de datos, Matriz de datos, Señal, Serie de señales, Serie de señales con componente X bidimensional y Curva espacial. Se permiten todos los tipos de datos. 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. |
BeginningsEnds |
Se alternan los índices de las posiciones en las que comienzan y terminan los segmentos que se van a extraer. Las estructuras de datos permitidas son Serie de datos. Se permiten todos los tipos de datos numéricos. 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. |
Beginnings |
Los índices de las posiciones en las que comienzan los segmentos que se van a extraer. Las estructuras de datos permitidas son Serie de datos. Se permiten todos los tipos de datos numéricos. 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. |
Ends |
Los índices de las posiciones en las que terminan los segmentos que se van a extraer. Las estructuras de datos permitidas son Serie de datos. Se permiten todos los tipos de datos numéricos. 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. |
NameTemplate |
Una plantilla con la que se crean los nombres de los elementos de los segmentos. Utilice "%1" para insertar el nombre del conjunto de datos que se va a segmentar y "%2" para insertar el número de segmento. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena. Se establece el valor predeterminado %1Segment%2 si no se especifica el argumento. |
Notas
La primera variante de la función utiliza una serie de datos común para las posiciones inicial y final de los segmentos. En BeginningsEnds se toman dos índices, que definen el inicio y el final de un segmento. Si el segundo índice desde BeginningsEnds designa una posición anterior al primer índice, se ignora y se lee el siguiente índice de BeginningsEnds. Un índice excedente al final será ignorado.
La segunda variante de la función utiliza series de datos separadas para las posiciones inicial y final. A partir de los índices en Beginnings y Ends se forman pares que definen el inicio y el final de un segmento. Si el siguiente índice de Ends indica una posición anterior al índice actual desde Beginnings entonces se ignora y se lee el siguiente índice desde Ends. Los segmentos se forman hasta que no se pueden formar más pares de índices. Los índices excedentes se ignora.
Los valores de las posiciones de índice se incluyen en el segmento. Los índices se cuentan empezando por cero. Los índices negativos cuentan desde el final, es decir, el índice -1 corresponde al último valor en Data; -2 el penúltimo y así sucesivamente.
Si Data es una serie de señales, la segmentación tiene lugar en la dirección X. En el caso de una matriz de datos, en la dirección de las filas. Esto corresponde a la operación de índice Data[][Beginning, End].
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
ExtractSegments(Signal, Bursts(Signal, 0.1, 1.2, EVENT_BEGINNING), Bursts(Signal, 0.1, 1.2, EVENT_END)) |
Extrae una serie de ráfagas de una señal. |
ExtractSegments(Signal, Bursts(Signal, 0.1, 1.2, EVENT_BOTH)) |
Corresponde al primer ejemplo. |
Dim Segments = ExtractSegments(Signal, Bursts(Signal, 0.1, 1.2, EVENT_BOTH)) |
En este ejemplo, los componentes X de los segmentos se corrigen para que todos empiecen por 0. |
ExtractSegments(Signal, SearchValue(Signal, {1.5 s, 3 s}), SearchValue(Signal, {1.8 s, 3.4 s})) |
Toma dos segmentos de una señal de tiempo. El primero contiene la sección de señal de 1,5 s a 1,8 s y el segundo la de 3 s a 3,4 s. |