Interpoler des polygones vers multipatchs (Outils 3D Analyst)

Résumé

Crée des entités multipatch conformes à la surface en drapant des entités surfaciques sur une surface.

Utilisation

Chaque entité surfacique présente une limite profilée le long de la surface. Les hauteurs sont obtenues par interpolation linéaire en procédant à un échantillonnage à chaque sommet en entrée et partout où la ligne de limite intersecte les nœuds et les segments du triangle de surface. Cette densification naturelle capture la définition complète de la surface linéaire en utilisant un nombre minimal d’échantillons. Ensuite, tous les nœuds qui se trouvent dans le polygone sont extraits. Les nœuds sont retriangulés dans un nouveau TIN basé sur la mémoire et la limite de polygone 3D est appliquée comme polygone de découpage. Les triangles de ce nouveau TIN sont ensuite extraits en une série de bandes utilisées pour définir une entité basée sur le multipatch.
Le multipatch obtenu capture la représentation 3D de la surface dans sa géométrie. Les calculs de surface planimétrique et de surface réelle sont inclus dans la sortie, avec d’autres attributs du polygone en entrée.
Envisagez de convertir des polygones en multipatchs si vous rencontrez des problèmes d’affichage lors du rendu tridimensionnel des polygones drapés sur une surface.
La valeur Maximum Triangle Strip Size (Taille maximale des bandes de triangles) doit être au moins 3. Ce paramètre spécifie le nombre maximal de sommets autorisés dans une bande de triangles utilisée pour créer le multipatch. ArcGIS n’impose pas de limite de taille ni de préférence particulière, mais certaines cartes graphiques 3D le peuvent, car les bandes de triangles sont chargées directement dans l’API de graphique 3D pour le rendu. Les valeurs de la plage recommandée sont comprises entre 128 et 2048.

Etiqueter	Explication	Type de données
Surface en entrée	Surface du réseau triangulé irrégulier (TIN) ou du jeu de données de MNT en entrée.	Terrain Layer; TIN Layer
Classe d’entités en entrée	Entité surfacique en entrée.	Feature Layer
Classe d’entités en sortie	Classe d’entités multipatch en sortie.	Feature Class
Taille maximale de bande (Facultatif)	Contrôle le nombre maximal de points utilisés pour créer une bande de triangles individuelle. Notez que chaque multipatch est généralement composé de plusieurs bandes. La valeur par défaut est 1 024.	Long
Facteur Z (Facultatif)	Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier aux unités linéaires x,y. La valeur par défaut est 1 et laisse les valeurs d’élévation inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z avec une unité linéaire spécifiée.	Double
Champ de surface (Facultatif)	Nom du champ en sortie contenant la surface planimétrique, ou 2D, des multipatchs obtenus.	String
Champ de surface réelle (Facultatif)	Nom du champ en sortie contenant la surface 3D des entités multipatch obtenues. Cette surface réelle tient compte des ondulations de la surface et est toujours plus grande que la surface planimétrique, à moins que la surface ne soit plane, auquel cas les deux surfaces sont égales.	String
Résolution des niveaux de pyramide (Facultatif)	Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée. La valeur par défaut est 0 (ou résolution maximale).	Double

arcpy.3d.InterpolatePolyToPatch(in_surface, in_feature_class, out_feature_class, {max_strip_size}, {z_factor}, {area_field}, {surface_area_field}, {pyramid_level_resolution})

Nom	Explication	Type de données
in_surface	Surface du réseau triangulé irrégulier (TIN) ou du jeu de données de MNT en entrée.	Terrain Layer; TIN Layer
in_feature_class	Entité surfacique en entrée.	Feature Layer
out_feature_class	Classe d’entités multipatch en sortie.	Feature Class
max_strip_size (Facultatif)	Contrôle le nombre maximal de points utilisés pour créer une bande de triangles individuelle. Notez que chaque multipatch est généralement composé de plusieurs bandes. La valeur par défaut est 1 024.	Long
z_factor (Facultatif)	Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier aux unités linéaires x,y. La valeur par défaut est 1 et laisse les valeurs d’élévation inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z avec une unité linéaire spécifiée.	Double
area_field (Facultatif)	Nom du champ en sortie contenant la surface planimétrique, ou 2D, des multipatchs obtenus.	String
surface_area_field (Facultatif)	Nom du champ en sortie contenant la surface 3D des entités multipatch obtenues. Cette surface réelle tient compte des ondulations de la surface et est toujours plus grande que la surface planimétrique, à moins que la surface ne soit plane, auquel cas les deux surfaces sont égales.	String
pyramid_level_resolution (Facultatif)	Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée. La valeur par défaut est 0 (ou résolution maximale).	Double

Exemple de code

Exemple 1 d’utilisation de la fonction InterpolatePolygonToMultipatch (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :

arcpy.env.workspace = "C:/data"
arcpy.ddd.InterpolatePolyToPatch("sample.gdb/featuredataset/terrain", "polygon.shp", "out_multipatch.shp", 1024, 1, "Area", "SArea", 5)

Exemple 2 d’utilisation de la fonction InterpolatePolygonToMultipatch (script autonome)

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :

'''****************************************************************************
Name: InterpolatePolyToPatch Example
Description: This script demonstrates how to use the
             InterpolatePolyToPatch tool.
****************************************************************************'''

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set Local Variables
inTerrain = "sample.gdb/featuredataset/terrain"
inPoly = "polygon.shp"
outMP = arcpy.CreateUniqueName("out_multipatch.shp")

# Run InterpolatePolyToPatch
arcpy.ddd.InterpolatePolyToPatch(inTerrain, inPoly, outMP, 1024, 1, "Area", "SArea", 5)

Environnements

Espace de travail courant, Système de coordonnées en sortie, Étendue, Transformations géographiques, Mot-clé CONFIG en sortie, Validation automatique, Résolution XY, Résolution Z, Domaine XY en sortie, Domaine Z en sortie

Informations de licence