ScatteredSurface (FPScript)

07.02.2018
 Daten mathematisch analysieren > Referenz > FPScript-Funktionen > Interpolation von Oberflächen > ScatteredSurface

ScatteredSurface (FPScript)

<< Klicken, um Inhaltsverzeichnis anzuzeigen >>

  Daten mathematisch analysieren > Referenz > FPScript-Funktionen > Interpolation von Oberflächen >

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:

Konstante

Bedeutung

SURFACE_RECTANGULAR

Rechteckige Oberfläche, d. h. Extrapolation an den Rändern.

SURFACE_CONVEX

Konvexe Oberfläche, d. h. keine Extrapolation an den Rändern. Die außerhalb der konvexen Hülle der durch die Raumkurve aufgespannten Fläche liegenden Punkte werden ungültig gesetzt.

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 Standard, 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

Clip2D-Funktion

BicubicSpline-Funktion

CompensatingSpline2D-Funktion

CurveToSurface-Funktion

GriddedSurface-Funktion

Spline2D-Funktion

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.

Share article or send as email:

You might be interested in these articles