weisang.com > Dokumentation > GriddedSurface (FPScript)

FlexPro-Dokumentation

GriddedSurface (FPScript)

21.09.2021

Interpoliert einen zweidimensionalen Datensatz durch eine "Natural Neighbor" Interpolation und tastet diese an vorgebbaren Stellen ab.

Syntax

GriddedSurface(Surface, NX, NZ, SamplingMode)
oder
GriddedSurface(DataMatrix, LocusX, LocusZ, NX, NZ, SamplingMode)

Die Syntax der GriddedSurface-Funktion besteht aus folgenden Teilen:

Teil

Beschreibung

Surface

Die Datenmatrix oder die Signalreihe mit Z-Komponente mit konstantem Abtastintervall, welche interpoliert wird. Fehlen die X- und Z-Komponenten, so werden sie automatisch generiert.

Erlaubte Datenstrukturen sind Datenmatrix und Signalreihe. 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.

DataMatrix

Datenmatrix mit der Y-Komponente der zu interpolierenden Signalreihe. Wenn Sie eine Signalreihe angeben, wird deren Y-Komponente verwendet.

Erlaubte Datenstrukturen sind Datenmatrix und Signalreihe. 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.

LocusX

Datenreihe mit der X-Komponente der zu interpolierenden Signalreihe. Wenn Sie ein Signal angeben, wird dessen 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.

LocusZ

Datenreihe mit der Z-Komponente der zu interpolierenden Signalreihe. Wenn Sie ein Signal angeben, wird dessen 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.

Gibt die Anzahl der Punkte insgesamt bzw. pro X-Intervall der Signalreihe an.

Erlaubte Datenstrukturen sind Einzelwert. Es sind alle ganzzahligen Datentypen erlaubt.

Der Wert muss größer gleich 0 sein.

Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

Gibt die Anzahl der Punkte insgesamt bzw. pro Z-Intervall der Signalreihe an.

Erlaubte Datenstrukturen sind Einzelwert. Es sind alle ganzzahligen Datentypen erlaubt.

Der Wert muss größer gleich 0 sein.

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 Spline-Oberfläche abgetastet werden soll.

Das Argument SamplingMode kann folgende Werte haben:

Konstante	Bedeutung
SURFACE_EQUIDISTANT	N Werte äquidistant abgetastet. Die Werteanzahl des Ergebnisses ist NX * NZ.
SURFACE_INTERVAL	N Werte pro ursprünglichem X- und Z-Intervall. Die Werteanzahl des Ergebnisses ist ((NumberOfRows(Surface) - 1) * NX + 1) * ((NumberOfColumns(Surface) - 1) * NZ + 1).

...plus einer Konstanten, die die Behandlung der Ränder der Oberfläche bestimmt.

Konstante	Bedeutung
+ SURFACE_CONVEX	Konvexe Oberfläche, d. h. keine Extrapolation.

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 Surface.

Die Y-Komponente des zu interpolierenden Datensatzes muss mindestens 3 x 3 Werte enthalten.

Die X- und Z-Komponente des Datensatzes darf keine ungültigen Werte enthalten. Ungültige Werte in der Y-Komponente werden als fehlende Stützstellen behandelt.

Die folgenden Grafiken zeigen eine "Natural Neighbor" Oberfläche und die zugrunde liegenden Daten: