Mettre à jour un TIN (3D Analyst)

Résumé

Charge les données d'une ou plusieurs entités en entrée afin de modifier la surface d'un réseau triangulé irrégulier (TIN) existant.

Pour en savoir plus sur la mise à jour des TIN

Illustration

Ajouter des lignes de fracture au TIN

Utilisation

  • Cet outil modifie le TIN en entrée. Vous pouvez utiliser l'outil Copier TIN pour disposer d'une sauvegarde si vous souhaitez conserver une version intacte du TIN source.

  • 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 cotés, qui offrent des nœuds de données dont les valeurs Z sont utilisées 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 (p. ex. plans d’eau, par exemple) et effacent les entités qui indiquent des surfaces internes où aucune donnée n’est présente.
  • Le nombre maximal de nœuds pris en charge par un TIN dépend principalement des ressources de mémoire libres et contiguës disponibles sur l'ordinateur. Limitez le nombre total de nœuds à moins de 6 millions pour garantir la réactivité des performances d'affichage et une facilité d'utilisation. Il est préférable de gérer les surfaces triangulées plus importantes à l'aide d'un jeu de données de MNT à plusieurs résolutions.

Syntaxe

arcpy.3d.EditTin(in_tin, in_features, {constrained_delaunay})
ParamètreExplicationType de données
in_tin

Jeu de données TIN à traiter.

TIN Layer
in_features
[[in_features, height_field, tag_value, SF_type, use_z],...]
False

Les entités en entrée et leurs propriétés associées qui contribueront à la définition du TIN.

  • in_features : entité dont la géométrie va être importée dans le TIN.
  • height_field : la source de l'altitude des entités en entrée. Les champs numériques issus de la table attributaire des entités en entrée peuvent être utilisés, ainsi que les valeurs Z ou M stockées dans le champ Shape. Si le mot-clé <None> est sélectionné, l'altitude de l'entité est interpolée à partir de la surface environnante.
  • tag_field : attribut numérique découlant d'un champ d'entier dans la table attributaire des entités en entrée dont les valeurs peuvent servir à affecter une forme élémentaire d'attribution aux éléments de données du TIN. Si vous indiquez <None>, aucune valeur de balise n'est attribuée.
  • sf_type : rôle des entités en entrée dans la définition de la surface TIN. Les options valides dépendent de la géométrie des entités en entrée. Les entités ponctuelles et multipoints peuvent être définies comme Mass_Points qui fournissent des valeurs d'altitude stockées sous forme de nœuds de données TIN. Les entités linéaires peuvent être désignées comme Mass_Points ou lignes de fracture en spécifiant Hard_Line ou Soft_Line. Les entités surfaciques peuvent représenter la limite d'interpolation en spécifiant Hard_Clip ou Soft_Clip, des portions intérieures sans donnée en choisissant Hard_Erase ou Soft_Erase ou encore des zones de hauteur constante en spécifiant Hard_Replace ou Soft_Replace. En outre, les polygones peuvent également servir à attribuer des valeurs attributaires entières en spécifiant Hardvalue_Fill ou Softvalue_Fill.
  • use_z : indique si les valeurs Z ou M sont utilisées lorsque le champ SHAPE est spécifié comme la source de la hauteur. Si vous définissez cette option sur True, les valeurs Z sont utilisées, tandis que si vous la définissez sur False, les valeurs M sont utilisées.
Value Table
constrained_delaunay
(Facultatif)

Spécifie la technique de triangulation utilisée le long des lignes de fracture du TIN.

  • DELAUNAYLe TIN utilise la triangulation de Delaunay qui peut densifier chaque segment des lignes de rupture pour produire plusieurs arêtes de triangle. Il s’agit de l’option par défaut.
  • CONSTRAINED_DELAUNAYLe TIN utilise la triangulation de Delaunay avec contrainte qui ajoute chaque segment sous la forme d'une arête unique. Les règles de triangulation de Delaunay sont reconnues partout, sauf le long des lignes de rupture, lesquelles ne sont pas densifiées.
Boolean

Sortie dérivée

NomExplicationType de données
derived_out_tin

TIN mis à jour.

Couche du TIN

Exemple de code

Exemple 1 d'utilisation de l'outil EditTin (fenêtre Python)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.

arcpy.env.workspace = "C:/data"
arcpy.ddd.EditTin("my_tin", "clip_polygon.shp <None> <None> hardclip false; "\
                 "new_points.shp Shape <None> masspoints true", "Delaunay")
Exemple 2 d'utilisation de l'outil EditTin (script autonome)

L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.

'''****************************************************************************
Name: EditTin Example
Description: This script demonstrates how to use the
             EditTin tool to add features to a output of the CopyTin tool.
****************************************************************************'''

# Import system modules
import arcpy

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

# Set Local Variables
origTin = "elevation"
copyTin = "elev_copy"
inFCs = [["Clip_Polygon.shp", "<None>", "<None>", "hardclip", False],
         ["new_points.shp", "Shape", "<None>", "masspoints", True]]

# Execute CopyTin
arcpy.CopyTin_3d(origTin, copyTin, "CURRENT")

# Execute EditTin
arcpy.EditTin_3d(copyTin, inFCs, Delaunay)

Informations de licence

  • Basic: Requiert 3D Analyst
  • Standard: Requiert 3D Analyst
  • Advanced: Requiert 3D Analyst

Rubriques connexes