Détruire les nœuds d’un TIN (3D Analyst)

Synthèse

Crée un jeu de données de type réseau triangulé irrégulier (TIN) à l'aide d'un sous-ensemble de nœuds à partir d'un TIN source.

Illustration

Illustration de l'outil DecimateTinNodes

Utilisation

  • Cet outil permet d'affiner les données suréchantillonnées et d'améliorer ainsi l'affichage. Les options d'affinage suivantes sont proposées :

    • Tolérance Z : le TIN obtenu maintient la précision verticale de son TIN source dans la valeur de tolérance Z spécifiée, qui est toujours exprimée dans l'unité Z native du TIN source. La déviation d’un nœud quelconque du TIN source, lorsqu’elle est comparée à la valeur interpolée du TIN en sortie, n’excède pas la tolérance Z.
      Remarque :

      Cette méthode prend en charge également l'application d'une limite de nœud facultative, qui entraîne l'arrêt de l'exécution de l'outil si la valeur de la tolérance Z entraîne le dépassement du nombre maximal de nœuds dans le TIN obtenu. Dans ce cas, le TIN est produit, mais un avertissement est renvoyé.

    • Total : réduit le nombre de nœuds dans le TIN en sortie à la valeur spécifiée, laquelle est supposément inférieure au nombre de nœuds du TIN source. Les nœuds sont généralement sélectionnés pour maintenir les caractéristiques d'étendue et de surface du TIN source.
  • Si l’option Copy Breaklines (Copier les lignes de fracture) est sélectionnée, les lignes de fracture dans le TIN source sont stockées dans la sortie sans aucune généralisation. Les nœuds auxquels contribuent les lignes de fracture sont indépendants de toute limite relative à un nombre de nœuds maximal.

  • La limite de données du TIN obtenu sera appliquée sous la forme de tronçons de ligne de fracture, peu importe si l'option de copie des lignes de fracture a été utilisée ou si la limite de données du TIN en entrée est appliquée avec des tronçons de ligne de fracture. Ce processus est susceptible d'augmenter la taille du TIN en sortie et fonctionne indépendamment de toute limite spécifiée relative à un nombre de nœuds maximal.

Paramètres

ÉtiquetteExplicationType de données
TIN en entrée

Jeu de données TIN qui sera traité.

TIN Layer
TIN en sortie

Jeu de données TIN qui va être généré.

TIN
Méthode de destruction

Spécifie la méthode d'affinage utilisée pour sélectionner un sous-ensemble de nœuds à partir du TIN en entrée.

  • Tolérance ZCrée un TIN permettant de maintenir la précision verticale spécifiée dans le paramètre Tolérance Z. Il s’agit de l’option par défaut.
  • TotauxCrée un TIN qui ne dépassera pas la limite de nœud spécifiée dans le paramètre Nombre maximal de nœuds.
String
Copier les lignes de fracture
(Facultatif)

Indique si les lignes de fracture du TIN en entrée sont copiées dans la sortie.

  • Non coché - Les lignes de rupture ne sont pas copiées. Il s’agit de l’option par défaut.
  • Coché - Les lignes de rupture sont copiées.

Boolean
Tolérance Z
(Facultatif)

Écart maximal par rapport à la valeur Z du TIN source qui sera autorisé dans le TIN en sortie. Par défaut, il s’agit de la valeur la plus petite entre le dixième de la plage Z ou le nombre 10.

Double
Nombre maximal de nœuds
(Facultatif)

Nombre maximum de nœuds pouvant être stockés dans le TIN en sortie qui correspond, par défaut, au nombre total de nœuds du TIN source, moins 1. Si la méthode de tolérance Z est utilisée, l'outil arrêtera le traitement si la valeur de tolérance Z entraîne le dépassement du nombre maximal de nœuds dans le TIN obtenu.

Long

arcpy.ddd.DecimateTinNodes(in_tin, out_tin, method, {copy_breaklines}, {z_tolerance_value}, {max_node_value})
NomExplicationType de données
in_tin

Jeu de données TIN qui sera traité.

TIN Layer
out_tin

Jeu de données TIN qui va être généré.

TIN
method

Spécifie la méthode d'affinage utilisée pour sélectionner un sous-ensemble de nœuds à partir du TIN en entrée.

  • Z_TOLERANCECrée un TIN permettant de maintenir la précision verticale spécifiée dans le paramètre z_tolerance_value. Il s’agit de l’option par défaut.
  • COUNTCrée un TIN qui ne dépassera pas la limite de nœud spécifiée dans le paramètre max_node_value.
String
copy_breaklines
(Facultatif)

Indique si les lignes de fracture du TIN en entrée sont copiées dans la sortie.

  • BREAKLINESLes lignes de fracture sont copiées.
  • NO_BREAKLINESLes lignes de rupture ne sont pas copiées. Il s’agit de l’option par défaut.
Boolean
z_tolerance_value
(Facultatif)

Écart maximal par rapport à la valeur Z du TIN source qui sera autorisé dans le TIN en sortie. Par défaut, il s’agit de la valeur la plus petite entre le dixième de la plage Z ou le nombre 10.

Double
max_node_value
(Facultatif)

Nombre maximum de nœuds pouvant être stockés dans le TIN en sortie qui correspond, par défaut, au nombre total de nœuds du TIN source, moins 1. Si la méthode de tolérance Z est utilisée, l'outil arrêtera le traitement si la valeur de tolérance Z entraîne le dépassement du nombre maximal de nœuds dans le TIN obtenu.

Long

Exemple de code

1er exemple d'utilisation de l'outil DecimateTinNodes (fenêtre Python)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.DecimateTinNodes("tin", "tin_simple", "COUNT 5000" "BREAKLINES")
2e exemple d'utilisation de l'outil DecimateTinNodes (script autonome)

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

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

# Import system modules
import arcpy
from arcpy import env

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

# Set Local Variables
inTin = "elevation"
method = "COUNT 5000"
copyBrk = "BREAKLINES"
# Ensure output name is unique
outTin = arcpy.CreateUniqueName("simple_elev")

#Execute DecimateTinNodes
arcpy.ddd.DecimateTinNodes(inTin, outTin, method, copyBrk)

Informations de licence

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

Rubriques connexes