ConcatenateList (FPScript)
Concatenates all elements of a list to a data series or signal, or the elements of several lists into a single list with data series or signals.
Syntax
ConcatenateList(List, [ CalendarTime = TRUE ], [ ShiftXValues = FALSE ] [ , InsertVoidValues = FALSE ])
The syntax of the ConcatenateList function consists of the following parts:
Part |
Description |
|---|---|
List |
A list whose elements are to be concatenated, or a list of lists with the same number of elements that are to be concatenated element by element. The list elements to be concatenated must be either scalar values, signals, space curves or data series. Permitted data structures are list. All data types are permitted. |
CalendarTime |
TRUE, if time values are to be transformed to absolute time before concatenation. Permitted data structures are scalar value. Supported data types are Boolean value. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. If this argument is omitted, it will be set to the default value TRUE. |
ShiftXValues |
TRUE, if the X values of the signals to be appended are to be shifted so that they connect seamlessly to that of the respective predecessor. Permitted data structures are scalar value. Supported data types are Boolean value. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. If this argument is omitted, it will be set to the default value FALSE. |
InsertVoidValues |
TRUE if the concatenated segments are to be separated by one void value each. When displayed as a curve, you can then see gaps between the segments. Permitted data structures are scalar value. Supported data types are Boolean value. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. If this argument is omitted, it will be set to the default value FALSE. |
Remarks
If a list of lists is specified, then they are concatenated element by element and the result is a list with the concatenated elements. The elements are preferably assigned by their element names. If only one list is specified, then its elements are concatenated and the result is a data series, signal or space curve. An empty list is interpreted as a list with zero lists, i.e. the result is again an empty list.
If ShiftXValues is set to TRUE, then the X values of the data sets to be appended are shifted so that an ascending series occurs without jumps. The first value of the appended data set then corresponds to the last value of the predecessor plus the difference between the last and next to last value. If the list elements are data series, this argument is ignored.
If CalendarTime is set to TRUE or is omitted, then, as long present in the header information of the list elements, the timestamp is added to the numeric data in order to convert them to the calendar time data type. If the data already have a unit, then a unit with the time SI dimension must be present. If not converted to calendar time, then the units of the data to be concatenated must be identical.
Available in
FlexPro Basic, Professional, Developer Suite
Examples
ConcatenateList(MyList) |
Concatenates all elements of the list MyList. |
Dim l = ['Data2019-08-09','Data2019-08-10','Data2019-08-11'] |
Concatenates the data of a measurement that spanned three days and was stored in folders by day. |
ConcatenateList('Data2019-08-*') |
Concatenates data from August 2019 of a measurement that spanned three days and was stored in folders by day. |