ScatteredSurface (FPScript)

21.09.2021

Modélisation d'une surface par la méthode du voisin naturel pour les points d'échantillonnage spécifiés comme une courbe 3D et évaluation de celle-ci à des points de grille définissables.

Syntaxe

ScatteredSurface(SpaceCurve, GridX, GridZ, SamplingMode)
ou
ScatteredSurface(Y, X, Z, GridX, GridZ, SamplingMode)

 

La syntaxe de la fonction ScatteredSurface se compose des éléments suivants :

Section

Description

SpaceCurve

La courbe 3D qui contient les points d'échantillonnage de la surface à interpoler.

Les structures de données autorisées sont Courbe 3D. Tous les types de données numériques sont autorisés.

Pour les types de données complexes, un nombre est formé.

Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste.

Y

Une série de données avec la composante Y de la courbe 3D qui contient les points d'échantillonnage de la surface à interpoler.

Les structures de données autorisées sont Séries de données et Signal. Tous les types de données numériques sont autorisés.

Pour les types de données complexes, un nombre est formé.

Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.

X

Une série de données avec la composante X de la courbe 3D qui contient les points d'échantillonnage de la surface à interpoler.

Les structures de données autorisées sont Séries de données et Signal. Tous les types de données numériques sont autorisés.

Pour les types de données complexes, un nombre est formé.

Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.

Z

Une série de données avec la composante Z de la courbe 3D qui contient les points d'échantillonnage de la surface à interpoler.

Les structures de données autorisées sont Séries de données et Signal. Tous les types de données numériques sont autorisés.

Pour les types de données complexes, un nombre est formé.

Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.

GridX

Une série de données avec les valeurs X de la grille pour laquelle la surface modélisée doit être évaluée.

Les structures de données autorisées sont Séries de données. Tous les types de données numériques sont autorisés.

Les valeurs invalides ne sont pas autorisées dans cet argument.

Pour les types de données complexes, un nombre est formé.

Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.

GridZ

Une série de données avec les valeurs Z de la grille pour laquelle la surface modélisée doit être évaluée.

Les structures de données autorisées sont Séries de données. Tous les types de données numériques sont autorisés.

Les valeurs invalides ne sont pas autorisées dans cet argument.

Pour les types de données complexes, un nombre est formé.

Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.

SamplingMode

Précise comment la surface calculée doit être échantillonnée.

L'argument SamplingMode peut avoir les valeurs suivantes :

Constante

Signification

SURFACE_RECTANGULAR

Surface rectangulaire, c'est-à-dire extrapolation sur les bords.

SURFACE_CONVEX

Surface convexe, c'est-à-dire pas d'extrapolation sur les bords. Les points situés à l'extérieur de la coque convexe de la surface déterminée par la courbe 3D sont définis comme invalides (void).

Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.

Remarques

Le résultat est toujours du type de données Virgule flottante de 64 bits.

Le résultat a la même unité que l'argument SpaceCurve.

Le résultat est une série de signaux avec une composante Z (surface) qui contient les arguments GridX et GridZ comme la composante X ou Z.

La courbe 3D doit contenir au moins 3 points et ne peut pas être dégénérée, c'est-à-dire que les valeurs X et Z doivent être disposées de manière à ce qu'elles couvrent une surface.

Les composantes X et Z de l'ensemble de données ne peuvent pas contenir de valeurs invalides (void). Les valeurs invalides (void) dans la composante Y sont traitées comme des points d'échantillonnage manquants.

L'unité de la composante X ou Z du résultat correspond à celle de l'argument GridX ou GridZ.

Les illustrations suivantes montrent une surface Natural Neighbor et les données sur lesquelles elle est basée :

Disponible dans

FlexPro Basic, Professional, Developer Suite

Exemples

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)
 

Modélise une surface convexe en utilisant la méthode du voisin naturel.

ScatteredSurface(data, (100, -1, 0.02), (100, -1, 0.02), SURFACE_RECTANGULAR)
 

Modélise une surface rectangulaire en utilisant la méthode du voisin naturel.

Voir aussi

Fonction Clip2D

Fonction BicubicSpline

Fonction CompensatingSpline2D

Fonction CurveToSurface

Fonction GriddedSurface

Fonction Spline2D

Objet d'analyse Interpolation de surface

Objet d'analyse Transformation de courbe

Objet d'analyse Approximation 2D

Littérature

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

Partager l’article ou envoyer par mail :

Vous serez probablement intéressé par les articles suivants :