ScatteredSurface (FPScript)
Modelliert eine Oberfläche mit der "Natural Neighbor" Methode für die als Raumkurve gegebenen Stützstellen und wertet diese an vorgebbaren Gitterpunkten aus.
Syntax
ScatteredSurface(SpaceCurve, GridX, GridZ, SamplingMode)
oder
ScatteredSurface(Y, X, Z, GridX, GridZ, SamplingMode)
Die Syntax der ScatteredSurface-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||
|---|---|---|---|---|---|---|---|
SpaceCurve |
Die Raumkurve, welche die Stützstellen der zu interpolierenden Oberfläche enthält. Erlaubte Datenstrukturen sind Raumkurve. Es sind alle numerischen Datentypen erlaubt. Bei komplexen Datentypen erfolgt eine Betragsbildung. 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 |
Eine Datenreihe mit der Y-Komponente der Raumkurve, welche die Stützstellen der zu interpolierenden Oberfläche enthält. Erlaubte Datenstrukturen sind Datenreihe und Signal. Es sind alle numerischen Datentypen erlaubt. Bei komplexen Datentypen erfolgt eine Betragsbildung. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||
X |
Eine Datenreihe mit der X-Komponente der Raumkurve, welche die Stützstellen der zu interpolierenden Oberfläche enthält. Erlaubte Datenstrukturen sind Datenreihe und Signal. Es sind alle numerischen Datentypen erlaubt. Bei komplexen Datentypen erfolgt eine Betragsbildung. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||
Z |
Eine Datenreihe mit der Z-Komponente der Raumkurve, welche die Stützstellen der zu interpolierenden Oberfläche enthält. Erlaubte Datenstrukturen sind Datenreihe und Signal. Es sind alle numerischen Datentypen erlaubt. Bei komplexen Datentypen erfolgt eine Betragsbildung. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||
GridX |
Eine Datenreihe mit den X-Werten des Gitters, für das die modellierte Oberfläche ausgewertet werden soll. Erlaubte Datenstrukturen sind Datenreihe. Es sind alle numerischen Datentypen erlaubt. Ungültige Werte sind in diesem Argument nicht zulässig. Bei komplexen Datentypen erfolgt eine Betragsbildung. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||
GridZ |
Eine Datenreihe mit den Z-Werten des Gitters, für das die modellierte Oberfläche ausgewertet werden soll. Erlaubte Datenstrukturen sind Datenreihe. Es sind alle numerischen Datentypen erlaubt. Ungültige Werte sind in diesem Argument nicht zulässig. Bei komplexen Datentypen erfolgt eine Betragsbildung. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||
SamplingMode |
Gibt an, wie die berechnete Oberfläche abgetastet werden soll. Das Argument SamplingMode 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. |
Anmerkungen
Das Ergebnis ist immer vom Datentyp 64-Bit Fließkomma.
Das Ergebnis hat die gleiche Einheit wie das Argument SpaceCurve.
Das Ergebnis ist eine Signalreihe mit Z-Komponente (Oberfläche), die die Argumente GridX und GridZ als X- bzw. Z-Komponente enthält.
Die Raumkurve muss mindestens 3 Punkte enthalten und darf nicht entartet sein, d. h. die X- und Z-Werte müssen so angeordnet sein, dass diese eine Fläche aufspannen.
Die X- und Z-Komponente des Datensatzes dürfen keine ungültigen Werte enthalten. Ungültige Werte in der Y-Komponente werden als fehlende Stützstellen behandelt.
Die Einheit der X- bzw. Z-Komponente des Ergebnisses entspricht der der Argumente GridX bzw. GridZ.
Die folgenden Grafiken zeigen eine "Natural Neighbor" Oberfläche und die zugrunde liegenden Daten:
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
Dim x = Series(0,2 * PI, 2 * PI / 100)
Dim data = Signal(sin(x) * cos(x), cos(x), sin(x))
ScatteredSurface(data, (100, -1, 0.02), (100, -1, 0.02), SURFACE_CONVEX)
Modelliert eine konvexe Oberfläche mit der "Natural Neighbor" Methode.
ScatteredSurface(data, (100, -1, 0.02), (100, -1, 0.02), SURFACE_RECTANGULAR)
Modelliert eine rechteckige Oberfläche mit der "Natural Neighbor" Methode.
Siehe auch
Analyseobjekt Oberflächeninterpolation
Analyseobjekt Kurvenumwandlung
Analyseobjekt 2D-Approximation
Literatur
[1] "Watson, Dave": "nngridr - An Implementation of Natural Neighbor Interpolation". "Dave Watson Publisher, Claremont, Australia",1994.
[2] "Watson, Dave": "Contouring: - A Guide To The Analysis and Display of Spatial Data". "Pergamon Press",1992.ISBN 0-08-040286-0.