ConcatenateList (FPScript)
Verkettet alle Elemente einer Liste zu einer Datenreihe oder einem Signal oder die Elemente mehrerer Listen zu einer einzelnen Liste mit Datenreihen oder Signalen.
Syntax
ConcatenateList(List, [ CalendarTime = TRUE ], [ ShiftXValues = FALSE ] [ , InsertVoidValues = FALSE ])
Die Syntax der ConcatenateList-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
List |
Eine Liste, deren Elemente verkettet werden sollen, oder eine Liste von Listen gleicher Elementanzahl, die elementweise verkettet werden sollen. Die zu verkettenden Listenelemente müssen entweder Einzelwerte, Signale, Raumkurven oder Datenreihen sein. Erlaubte Datenstrukturen sind Liste. Es sind alle Datentypen erlaubt. |
CalendarTime |
TRUE, wenn Zeitwerte vor dem Verketten in Absolutzeit gewandelt werden sollen. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert TRUE gesetzt. |
ShiftXValues |
TRUE, wenn die X-Werte von anzuhängenden Signalen so verschoben werden sollen, dass diese lückenlos an die des jeweiligen Vorgängers anschließen. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert FALSE gesetzt. |
InsertVoidValues |
TRUE, wenn die verketteten Segmente durch je einen ungültigen Wert separiert werden sollen. Bei der Darstellung als Kurvenzug sieht man dann Lücken zwischen den Segmenten. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert FALSE gesetzt. |
Anmerkungen
Wenn eine Liste von Listen angegeben wird, dann werden diese elementweise verkettet und das Ergebnis ist eine Liste mit den verketteten Elementen. Die Zuordnung der Elemente erfolgt hierbei vorzugsweise über deren Elementnamen. Wird nur eine Liste angegeben, dann werden deren Elemente verkettet und das Ergebnis ist eine Datenreihe, ein Signal oder eine Raumkurve. Eine leere Liste wird als Liste mit null Listen interpretiert, d. h. das Ergebnis ist wiederum eine leere Liste.
Wenn ShiftXValues auf TRUE gesetzt wird, dann werden die X-Werte der anzuhängenden Datensätze so verschoben, dass eine aufsteigende Reihe ohne Sprünge entsteht. Der erste Wert des anzuhängenden Datensatzes entspricht dann dem letzten Wert des Vorgängers plus der Differenz zwischen letztem und vorletztem Wert. Wenn die Listenelemente Datenreihen sind, wird dieses Argument ignoriert.
Wenn CalendarTime auf TRUE gesetzt oder weggelassen wird, dann wird, sofern in den Kopfdaten der Listenelemente vorhanden, der Zeitstempel auf die numerischen Daten addiert, um diese in den Datentyp Kalenderzeit zu wandeln. Falls die Daten einheitenbehaftet sind, muss dann eine Einheit mit der SI-Dimension Zeit vorliegen. Wenn nicht in Kalenderzeit gewandelt wird, dann müssen die Einheiten der zu verkettenden Daten exakt identisch sein.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
ConcatenateList(MyList) |
Verkettet alle Elemente der Liste MyList. |
Dim l = ['Data2019-08-09','Data2019-08-10','Data2019-08-11'] |
Verkettet die Daten einer Messung, die sich über drei Tage erstreckte und tageweise in Ordnern abgelegt wurde. |
ConcatenateList('Data2019-08-*') |
Verkettet die Daten aus August 2019 einer Messung, die tageweise in Ordnern abgelegt wurde. |