Créer un TIN (Outils 3D Analyst)

Résumé

Crée un jeu de données de réseau triangulé irrégulier (TIN).

Illustration

Illustration de l’outil Create TIN (Créer un TIN).

Utilisation

Évitez de créer un TIN avec un système de coordonnées géographiques, car la règle de triangulation de Delaunay ne peut pas être appliquée de manière efficace lorsque les unités x,y sont exprimées dans des coordonnées sphériques.
Le type d'entité de surface détermine dans quelle mesure les entités en entrée vont contribuer à la définition de la surface triangulée.
- Les entités ponctuelles peuvent être spécifiées en tant que points de masse, qui offrent des nœuds de données avec des valeurs z servant dans la triangulation de la surface.
- Les entités linéaires peuvent être spécifiées en tant que points de masse et lignes de fracture, qui représentent les emplacements le long d’une surface avec des discontinuités linéaires au niveau de la pente (par exemple, des lignes de crête, des lignes de rivage, des tronçons de chaussée, des emprises de bâtiment, etc.).
- Les entités surfaciques peuvent également être spécifiées en tant que points de masse et lignes de fracture, ainsi que les entités de découpage qui définissent la zone de données, remplacent les entités qui définissent les régions par des valeurs z constantes (des plans d’eau, par exemple) et effacent les entités qui indiquent des surfaces internes où aucune donnée n’est présente.
L’outil peut créer un TIN composé de plusieurs millions de points si la mémoire est suffisante. Limitez toutefois le nombre total de nœuds TIN à moins de 6 millions pour garantir la réactivité des performances d’affichage et une facilité d’utilisation. Si une surface TIN plus grande est requise, envisagez d’utiliser un [jeu de données de MNT] (../../help/data/terrain-dataset/terrain-dataset-in-arcgis-pro.md). Le jeu de données de MNT offre une surface TIN multi-résolutions qui peut prendre en charge des collections bien plus grandes de mesures source.
Définissez l’environnement Default TIN Storage Version (Version de stockage TIN par défaut) sur PRE_10.0 si le TIN en cours de création doit être utilisé dans des versions d’ArcGIS Desktop antérieures à la version 10.0.
Une fois un jeu de données TIN créé, vous pouvez le modifier à l’aide de l’outil Edit TIN (Mettre à jour un TIN) afin d’intégrer des mesures supplémentaires basées sur des entités à la surface TIN. Vous pouvez également utiliser l’outil Delineate TIN Data Area (Délimiter la zone de données d’un TIN) pour définir les triangles TIN qui constituent la zone d’interpolation en fonction de la longueur maximale de segment d’un triangle. Il est également possible de modifier la surface TIN grâce à la mise à jour interactive.

Etiqueter	Explication	Type de données
TIN en sortie	Jeu de données TIN qui va être généré.	TIN
Système de coordonnées (Facultatif)	Référence spatiale du TIN en sortie. Définissez la référence spatiale sur un système de coordonnées projetées. Il est déconseillé d’utiliser des systèmes de coordonnées géographiques car la triangulation de Delaunay ne peut pas être garantie lorsque les coordonnées x,y sont exprimées en unités angulaires, ce qui peut avoir un effet négatif sur la précision des calculs basés sur la distance, comme la pente, le volume et la ligne de visée.	Coordinate System
Classe d’entités en entrée (Facultatif)	Entités en entrée et leurs propriétés associées qui définissent la manière dont ils sont ajoutés au TIN. Colonnes de la table de valeurs : Input Features—The feature whose geometry will be imported to the TIN. Height Field—The source of elevation for the input features. Any numeric field from the input feature's attribute table can be specified, along with `Shape.Z` for the z-values of 3D features and `Shape.M` for the m-values stored with the geometry. Choosing the `<None>` keyword will result in the feature's elevation being interpolated from the surrounding surface. Type—The input feature's role in defining the TIN surface. The available options depend on the geometry of the input features. For line- and polygon-based surface feature types, the hard and soft designations for the surface feature type impact the way the line or polygon boundary is handled when interpolating a raster surface from the TIN dataset when using natural neighbor interpolation. A hard surface feature type represents a border with a sharp discontinuity in elevation, such as the edge of a cliff, a wall, or a curb on the side of the road. A soft surface feature type represents a border where the elevation is more smoothly defined. Mass Points—Elevation measurements will be incorporated as TIN nodes. Hard Line—Breakline features will define linear discontinuities in the TIN. Soft Line—Breakline features will define linear discontinuities in the TIN. Hard Clip—Polygon features will define the data area of the TIN surface. Soft Clip—Polygon features will define the data area of the TIN surface. Hard Erase—Polygon features will define interior voids in the data. Soft Erase—Polygon features will define interior voids in the data. Hard Replace—Polygon features will define areas of constant height. Soft Replace—Polygon features will define areas of constant height. Hard Value Fill—Integer attributes will be assigned to nodes and triangle faces. Soft Value Fill—Integer attributes will be assigned to nodes and triangle faces. Tag Field—A numeric attribute will be assigned to the TIN's data elements using values obtained from an integer field in the input feature's attribute table.	Value Table
Delaunay sous contraintes (Facultatif)	Détermine la technique de triangulation qui sera utilisée le long des lignes de fracture du TIN. Activé—The TIN will use constrained Delaunay triangulation, which will add each segment as a single edge. Delaunay triangulation rules are honored everywhere except along breaklines, which will not be densified. Décoché—The TIN will use Delaunay conforming triangulation, which may densify each segment of the breaklines to produce multiple triangle edges. This is the default.	Boolean

arcpy.3d.CreateTin(out_tin, {spatial_reference}, {in_features}, {constrained_delaunay})

Nom	Explication	Type de données
out_tin	Jeu de données TIN qui va être généré.	TIN
spatial_reference (Facultatif)	Référence spatiale du TIN en sortie. Définissez la référence spatiale sur un système de coordonnées projetées. Il est déconseillé d’utiliser des systèmes de coordonnées géographiques car la triangulation de Delaunay ne peut pas être garantie lorsque les coordonnées x,y sont exprimées en unités angulaires, ce qui peut avoir un effet négatif sur la précision des calculs basés sur la distance, comme la pente, le volume et la ligne de visée.	Coordinate System
in_features [[in_features, height_field, SF_type, tag_value],...] (Facultatif)	Entités en entrée et leurs propriétés associées qui définissent la manière dont ils sont ajoutés au TIN. Colonnes de la table de valeurs : `Input Features`—The feature whose geometry will be imported to the TIN. `Height Field`—The source of elevation for the input features. Any numeric field from the input feature's attribute table can be specified, along with `Shape.Z` for the z-values of 3D features and `Shape.M` for the m-values stored with the geometry. Choosing the `<None>` keyword will result in the feature's elevation being interpolated from the surrounding surface. `Type`—The input feature's role in defining the TIN surface. The available options depend on the geometry of the input features. For line- and polygon-based surface feature types, the hard and soft designations for the surface feature type impact the way the line or polygon boundary is handled when interpolating a raster surface from the TIN dataset when using natural neighbor interpolation. A hard surface feature type represents a border with a sharp discontinuity in elevation, such as the edge of a cliff, a wall, or a curb on the side of the road. A soft surface feature type represents a border where the elevation is more smoothly defined. `Mass_Points`—Elevation measurements will be incorporated as TIN nodes. `Hard_Line`—Breakline features will define linear discontinuities in the TIN. `Soft_Line`—Breakline features will define linear discontinuities in the TIN. `Hard_Clip`—Polygon features will define the data area of the TIN surface. `Soft_Clip`—Polygon features will define the data area of the TIN surface. `Hard_Erase`—Polygon features will define interior voids in the data. `Soft_Erase`—Polygon features will define interior voids in the data. `Hard_Replace`—Polygon features will define areas of constant height. `Soft_Replace`—Polygon features will define areas of constant height. `Hardvalue_Fill`—Integer attributes will be assigned to nodes and triangle faces. `Softvalue_Fill`—Integer attributes will be assigned to nodes and triangle faces. `Tag Field`—A numeric attribute will be assigned to the TIN's data elements using values obtained from an integer field in the input feature's attribute table.	Value Table
constrained_delaunay (Facultatif)	Détermine la technique de triangulation qui sera utilisée le long des lignes de fracture du TIN. `CONSTRAINED_DELAUNAY`—The TIN will use constrained Delaunay triangulation, which will add each segment as a single edge. Delaunay triangulation rules are honored everywhere except along breaklines, which will not be densified. `DELAUNAY`—The TIN will use Delaunay conforming triangulation, which may densify each segment of the breaklines to produce multiple triangle edges. This is the default.	Boolean

Exemple de code

Exemple 1 d’utilisation de l’outil CreateTin (fenêtre Python)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.CreateTin("NewTIN", "NAD 1983 StatePlane California II FIPS 0402 (Feet).prj",
                   "points.shp Shape.Z masspoints", "constrained_delaunay")

Exemple 2 d’utilisation de l’outil CreateTin (script autonome)

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

'''****************************************************************************
Name: Define Data Boundary of LAS File
Description: This script demonstrates how to delineate data boundaries of
             LAS files with irregularly clustered points. It is intended for
             use as a script tool with one input LAS file.
****************************************************************************'''
# Import system modules
import arcpy

# Set local variables
inLas = arcpy.GetParameterAsText(0)  # input LAS file
ptSpacing = arcpy.GetParameterAsText(1)  # LAS point spacing
classCode = arcpy.GetParameterAsText(2)  # List of integers
returnValue = arcpy.GetParameterAsText(3)  # List of strings
outTin = arcpy.GetParameterAsText(4)  # TIN created to delineate data area
outBoundary = arcpy.GetParameterAsText(5)  # Polygon boundary file

try:
    # Run LASToMultipoint
    lasMP = arcpy.CreateUniqueName('lasMultipoint', 'in_memory')
    arcpy.ddd.LASToMultipoint(inLas, LasMP, ptSpacing, class_code,
                             "ANY_RETURNS", "", sr, inFormat, zfactor)
    # Run CreateTin
    arcpy.ddd.CreateTin(outTin, sr, "{0} Shape.Z masspoints"\
                       .format(lasMP), "Delaunay")
    # Run CopyTin
    arcpy.ddd.CopyTin(outTin, "{0}_copy".format(outTin))
    # Run DelineateTinDataArea
    maxEdge = ptSpacing * 4
    arcpy.ddd.DelineateTinDataArea(outTin, maxEdge, "PERIMETER_ONLY")
    # Run TinDomain
    arcpy.ddd.TinDomain(outTin, outBoundary, "POLYGON")

except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err)

Environnements

Espace de travail courant, Système de coordonnées en sortie, Etendue, Transformations géographiques, Version de stockage TIN par défaut

Informations de licence

Basic: Nécessite 3D Analyst
Standard: Nécessite 3D Analyst
Advanced: Nécessite 3D Analyst