RemoveVoidValues (FPScript)
Entfernt ungültige Werte aus einem Datensatz.
Syntax
RemoveVoidValues(DataSet)
oder
RemoveVoidValues(Y, X)
oder
RemoveVoidValues(Y, X, Z)
Die Syntax der RemoveVoidValues-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
DataSet |
Der Datensatz, aus dem ungültige Punkte entfernt werden sollen. Eine fehlende X- oder Z-Komponente wird automatisch als lineare Reihe generiert, damit auch bei einer Datenreihe oder Datenmatrix erkennbar ist, welche Werte bzw. Zeilen oder Spalten entfernt wurden. Es sind alle Datenstrukturen erlaubt außer Einzelwert. 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. |
Y |
Die Y-Komponente des zu bearbeitenden Datensatzes. Wenn Sie eine zusammengesetzte Datenstruktur angeben, wird deren Y-Komponente verwendet. Erlaubte Datenstrukturen sind Datenreihe, Datenmatrix, Signal, Signalreihe und Signalreihe mit zweidimensionaler X-Komponente. Es sind alle numerischen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
X |
Die X-Komponente des zu bearbeitenden Datensatzes. Wenn Sie eine zusammengesetzte Datenstruktur angeben, wird deren Y-Komponente verwendet. Erlaubte Datenstrukturen sind Datenreihe, Datenmatrix, Signal, Signalreihe und Signalreihe mit zweidimensionaler X-Komponente. Es sind alle numerischen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Z |
Die Z-Komponente des zu bearbeitenden Datensatzes. Wenn Sie eine zusammengesetzte Datenstruktur angeben, wird deren Y-Komponente verwendet. Erlaubte Datenstrukturen sind Datenreihe und Signal. Es sind alle numerischen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Anmerkungen
Ein komplexer Wert gilt als ungültig, wenn dessen Realteil oder Imaginärteil ungültig ist. Ein Punkt in einem Signal wird als ungültig angenommen, wenn dessen Y- oder X-Komponente ungültig ist. Ein Punkt in einer Raumkurve wird als ungültig angenommen, wenn dessen Y-, X- oder Z-Komponente ungültig ist. Eine Zeile in einer Signalreihe wird als ungültig angenommen, wenn deren X-Wert oder alle Y-Werte ungültig sind. Eine Spalte in einer Signalreihe wird als ungültig angenommen, wenn deren Z-Wert oder alle Y-Werte ungültig sind. In einer Signalreihe mit zweidimensionaler X-Komponente wird eine Zeile oder Spalte als ungültig angenommen, wenn bei allen XY-Wertepaaren mindestens eine der Komponenten ungültig ist. Bei zweidimensionalen Datensätzen bleiben also u. U. ungültige Werte im Ergebnis enthalten. Wenn Sie alle ungültigen Werte aus einer Signalreihe entfernen möchten, müssen Sie die Signalreihe vor dem Entfernen der ungültigen Werte mit der SeriesToList-Funktion in eine Liste wandeln.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
RemoveVoidValues(Signal) |
Entfernt alle ungültigen Wert aus dem Signal. |
RemoveVoidValues(SeriesToList(SignalSeries)) |
Entfernt alle ungültigen Wert aus der Signalreihe und liefert eine Liste mit potentiell unterschiedlich langen Signalen. |