Concatena todos los elementos de una lista en una serie de datos o una señal, o los elementos de varias listas en una única lista con series de datos o señales.
Sintaxis
ConcatenateList(List, [ CalendarTime = TRUE ], [ ShiftXValues = FALSE ] [ , InsertVoidValues = FALSE ])
La sintaxis de la función ConcatenateList consta de los siguientes elementos:
Parte |
Descripción |
|---|---|
List |
Una lista cuyos elementos deben concatenarse, o una lista de listas con el mismo número de elementos que deben concatenarse elemento a elemento. Los elementos de la lista a concatenar deben ser valores escalares, señales, curvas espaciales o series de datos. Las estructuras de datos permitidas son Lista. Se permiten todos los tipos de datos. |
CalendarTime |
TRUE si los valores de tiempo deben convertirse a tiempo absoluto antes de la concatenación. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. 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 TRUE si no se especifica el argumento. |
ShiftXValues |
TRUE si los valores X de las señales que se van a añadir deben desplazarse de tal forma que se ajusten perfectamente a los de su predecesor. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. 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 FALSE si no se especifica el argumento. |
InsertVoidValues |
TRUE si los segmentos concatenados deben estar separados cada uno por un valor inválido. Cuando se visualiza como curva, se ven espacios entre los segmentos. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. 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 FALSE si no se especifica el argumento. |
Notas
Si se especifica una lista de listas, estas se concatenan elemento a elemento y el resultado es una lista con los elementos concatenados. Los elementos se asignan preferentemente a través de sus nombres de elemento. Si solo se especifica una lista, sus elementos se concatenan y el resultado es una serie de datos, una señal o una curva espacial. Una lista vacía se interpreta como una lista con cero listas, es decir, el resultado vuelve a ser una lista vacía.
Si ShiftXValues se establece en TRUE, los valores X de los conjuntos de datos que se van a añadir se desplazan para que se cree una serie ascendente sin saltos. El primer valor del conjunto de datos que se va a añadir corresponde entonces al último valor del predecesor más la diferencia entre el último y el penúltimo valor. Si los elementos de la lista son series de datos, este argumento se ignora.
Si CalendarTime se establece en TRUE o se omite, la marca de tiempo se añade a los datos numéricos, si están disponibles en los datos de cabecera de los elementos de lista, para convertirlos en el tipo de datos de tiempo de calendario. Si los datos tienen unidades, debe disponerse de una unidad con la dimensión SI de tiempo. Si no se está convirtiendo a tiempo de calendario, las unidades de los datos que se van a concatenar deben ser exactamente idénticas.
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
ConcatenateList(MyList) |
Concatena todos los elementos de la lista MyList. |
Dim l = ['Data2019-08-09','Data2019-08-10','Data2019-08-11'] |
Concatena los datos de una medición que abarcó tres días y se almacenó en carpetas diariamente. |
ConcatenateList('Data2019-08-*') |
Concatena los datos de agosto de 2019 de una medición que se almacenó en carpetas diariamente. |