Divide un conjunto de datos en segmentos de diferentes longitudes y los devuelve como una lista.
Sintaxis
SplitIntoSegments(Data, Divisions, [ ExcludeBorderSegments = FALSE ] [ , NameTemplate = "%1Segment%2" ])
La sintaxis de la función SplitIntoSegments 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. |
Divisions |
Los índices de las posiciones en las que termina un segmento y comienza el siguiente. 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. |
ExcludeBorderSegments |
Establezca este argumento en True si los segmentos marginales antes de la primera y después de la última división no deben incluirse en el resultado. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. Se establece el valor predeterminado FALSE si no se especifica el argumento. |
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 función divide el conjunto de datos sin espacios, por lo que los valores de Data con los índices indicados en Divisions se asignan al segmento siguiente. Si el siguiente índice desde Divisions indica una posición anterior al índice actual, se ignora y se lee el siguiente índice desde Divisions.
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
SplitIntoSegments(Signal, LevelCrossings(Signal, 0, 0.1, EVENT_POSITIVE)) |
Divide una señal de vibración en ondas individuales. |
Dim Segments = SplitIntoSegments(Signal, LevelCrossings(Signal, 0, 0.1, EVENT_POSITIVE)) |
Divide una señal de vibración en ondas individuales. Los componentes X de los segmentos se corrigen para que todos empiecen por 0. |
SplitIntoSegments(Signal, LevelCrossings(Signal, 0, 0.1, EVENT_POSITIVE), False) |
Corresponde al primer ejemplo, pero se descartan las ondas parciales al principio y al final. |