ConcatenateList (FPScript)

21.09.2021

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']
ConcatenateList(l)

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.

Siehe auch

List-Funktion

ListToSeries-Funktion

SeriesToList-Funktion

Datenstrukturen

Verkettungsoperator

Listenoperator

Listenelementoperator

Artikel teilen oder als Email versenden:

Diese Beiträge könnten Sie ebenfalls interessieren