PolarTransform (FPScript)
Führt eine Polartransformation durch.
Syntax
PolarTransform(DataSet, [ Scale = POLARSCALE_RAD_PI ] [ , Unwrapped = FALSE ])
oder
PolarTransform(Y, X, [ Scale = POLARSCALE_RAD_PI ] [ , Unwrapped = FALSE ])
Die Syntax der PolarTransform-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
DataSet |
Ist der Datensatz mit reellen oder komplexen Werten, die polartransformiert werden sollen. Reelle Daten müssen als Signal vorliegen. In diesem Fall müssen die Einheiten der Y- und X-Komponente von DataSet kompatibel sein. Bei komplexen Daten, die als Signal vorliegen, wird nur die Y-Komponente betrachtet. Erlaubte Datenstrukturen sind Datenreihe und Signal. Es sind alle numerischen Datentypen erlaubt außer Kalenderzeit und Zeitspanne. 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 |
Ist die Y-Komponente der Daten, die polartransformiert werden sollen. Von einem Signal wird nur die Y-Komponente verwendet. Erlaubte Datenstrukturen sind Datenreihe und Signal. Es sind alle reellen Datentypen erlaubt außer Kalenderzeit und Zeitspanne. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||
X |
Ist die X-Komponente der Daten, die polartransformiert werden sollen. Von einem Signal wird nur die Y-Komponente verwendet. Die Einheiten von Y und X müssen kompatibel sein. Erlaubte Datenstrukturen sind Datenreihe und Signal. Es sind alle reellen Datentypen erlaubt außer Kalenderzeit und Zeitspanne. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||
Scale |
Bestimmt die Skalierung der Polartransformation. Das Argument Scale kann folgende Werte haben:
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 POLARSCALE_RAD_PI gesetzt. |
||||||||||
Unwrapped |
Gibt an, ob der Phasengang der Polartransformation entfaltet wird (zur Erzeugung glatter Phasenverläufe). TRUE steht für Phasenentfaltung. 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
Das Ergebnis ist immer vom Datentyp 64-Bit Fließkomma.
Das Ergebnis ist ein Signal mit den polartransformierten Daten. Die Y-Komponente enthält den Betrag und die X-Komponente den Phasenwinkel. Der Phasenwinkel wird mit der Funktion ArcTan2 berechnet und anschließend skaliert.
Die X-Komponente des Ergebnisses hat die Einheit "°" oder "rad" und die Y-Komponente hat die Einheit der Y-Komponente von DataSet.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
PolarTransform(YData, XData) |
Transformiert die beiden Datenreihen ins Bogenmaß im Intervall ]-Pi, Pi]. |