SplitIntoSegments (FPScript)
Zerlegt einen Datensatz in Segmente unterschiedlicher Länge und gibt diese als Liste zurück.
Syntax
SplitIntoSegments(Data, Divisions, [ ExcludeBorderSegments = FALSE ] [ , NameTemplate = "%1Segment%2" ])
Die Syntax der SplitIntoSegments-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
Data |
Der zu segmentierende Datensatz. Erlaubte Datenstrukturen sind Datenreihe, Datenmatrix, Signal, Signalreihe, Signalreihe mit zweidimensionaler X-Komponente und Raumkurve. Es sind alle Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
Divisions |
Die Indizes der Positionen, an denen ein Segment endet und das nächste beginnt. Erlaubte Datenstrukturen sind Datenreihe. Es sind alle numerischen Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
ExcludeBorderSegments |
Setzen Sie dieses Argument auf True, wenn die Randsegmente vor der ersten und nach der letzten Teilung nicht in das Ergebnis übernommen werden sollen. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert FALSE gesetzt. |
NameTemplate |
Eine Vorlage, mit der die Elementnamen der Segmente gebildet werden. Verwenden Sie "%1", um den Namen des zu segmentierenden Datensatzes einzufügen, und "%2", um die Segmentnummer einzufügen. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert %1Segment%2 gesetzt. |
Anmerkungen
Die Funktion zerlegt den Datensatz lückenlos wobei die Werte aus Data mit den in Divisions aufgeführten Indizes jeweils dem nächsten Segment zugeordnet werden. Bezeichnet der jeweils nächste Index aus Divisions eine Position, die vor dem aktuellen Index liegt, dann wird dieser ignoriert und der nächste Index aus Divisions wird gelesen.
Die Indizes werden mit Null beginnend gezählt. Negative Indizes zählen vom Ende her, d. h. der Index -1 entspricht dem letzten Wert in Data, -2 dem vorletzten und so weiter.
Ist Data eine Signalreihe, dann wird in X-Richtung segmentiert. Bei einer Datenmatrix entsprechend in Zeilenrichtung. Dies entspricht der Index-Operation Data[][Beginning, End].
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
SplitIntoSegments(Signal, LevelCrossings(Signal, 0, 0.1, EVENT_POSITIVE)) |
Zerlegt ein Schwingungssignal in einzelne Wellen. |
Dim Segments = SplitIntoSegments(Signal, LevelCrossings(Signal, 0, 0.1, EVENT_POSITIVE)) |
Zerlegt ein Schwingungssignal in einzelne Wellen. Die X-Komponenten der Segmente werden so korrigiert, dass diese alle mit 0 beginnen. |
SplitIntoSegments(Signal, LevelCrossings(Signal, 0, 0.1, EVENT_POSITIVE), False) |
Entspricht dem ersten Beispiel, jedoch werden die Teilwellen am Anfang und am Ende verworfen. |