Triangles TIN (Outils 3D Analyst)

Résumé

Exporte les faces de triangle d’un jeu de données TIN vers des entités surfaciques et fournit la pente, l’exposition et des attributs facultatifs d’ombrage et de valeurs de balise pour chaque triangle.

Illustration

Illustration de l’outil TIN Triangle (Triangle TIN)

Utilisation

Les calculs de pente et d’exposition sont basés sur le plan du triangle. La pente ne peut pas être calculée correctement si l’unité linéaire du système de coordonnées du TIN utilise des mesures angulaires, comme les degrés décimaux.
Les unités linéaires XY et Z doivent être dans la même unité de mesure afin d’obtenir des résultats précis lors du calcul de la pente et de l’ombrage. Si les unités diffèrent, mais que les systèmes de coordonnées verticales et horizontales du TIN sont définis, un facteur Z approprié est automatiquement déterminé. Sinon, le paramètre Z Factor (Facteur Z) peut être utilisé pour définir explicitement le facteur de conversion à appliquer aux valeurs d’élévation.
Les valeurs d’exposition sont exprimées en degrés et supposent que le nord correspond à 0°. Les valeurs augmentent dans le sens horaire et sont enregistrées dans le champ Aspect. Une valeur d’exposition de -1 est attribuée à tout triangle plat dans le TIN.
La pente peut être renvoyée en degrés ou en pourcentage, et le nom du champ dans lequel les valeurs sont enregistrées dépend de la sélection effectuée dans le paramètre Slope Units (Unités de pente) :
- PERCENT—Les valeurs de pente sont stockées dans un champ nommé Slope_Pct.
- DEGREE—Les valeurs de pente sont stockées dans un champ nommé Slope_Deg.
Les valeurs d’ombrage reflètent le relief localisé produit par une source lumineuse qui utilise l’azimut et l’angle vertical spécifiés dans le paramètre Hillshade (Ombrage). Il est admis que 0° correspond au nord pour l’azimut. La valeur de luminosité est exprimée entre 0 et 255 : plus le nombre est bas, plus la teinte est sombre.
Le paramètre Tag Value Field (Champ de valeur de balise) ne sera actif que si le TIN possède des valeurs de balise explicitement définies.

Etiqueter	Explication	Type de données
TIN en entrée	Jeu de données TIN à traiter.	TIN Layer
Classe d’entités en sortie	Classe d’entités qui va être produite.	Feature Class
Unités de pente (Facultatif)	Unités de mesure à utiliser pour calculer la pente. Percent—Slope is expressed as a percentage value. This is the default. Degree—Slope is expressed as the angle of inclination from a horizontal plane.	String
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, qui laisse les valeurs d'altitude 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
OMBRAGE azimut, altitude (Facultatif)	Spécifie les angles d’azimut et d’altitude de la source lumineuse lors de l’application d’un effet d’ombrage pour la couche d’entités en sortie. L’azimut peut être compris entre 0 et 360 degrés, alors que l’altitude peut être comprise entre 0 et 90 degrés. Pour spécifier un azimut de 45 degrés et une altitude de 30 degrés, entrez « HILLSHADE 45, 30 ».	String
Champ de la valeur portée (Facultatif)	Nom de champ dans l’entité en sortie qui stocke la valeur de balise du triangle. Ce paramètre est vide par défaut : les valeurs de balise ne sont donc pas écrites dans la sortie.	String

arcpy.3d.TinTriangle(in_tin, out_feature_class, {units}, {z_factor}, {hillshade}, {tag_field})

Nom	Explication	Type de données
in_tin	Jeu de données TIN à traiter.	TIN Layer
out_feature_class	Classe d’entités qui va être produite.	Feature Class
units (Facultatif)	Unités de mesure à utiliser pour calculer la pente. `PERCENT`—Slope is expressed as a percentage value. This is the default. `DEGREE`—Slope is expressed as the angle of inclination from a horizontal plane.	String
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, qui laisse les valeurs d'altitude 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
hillshade [HILLSHADE <azimuth>, <angle>,...] (Facultatif)	Spécifie les angles d’azimut et d’altitude de la source lumineuse lors de l’application d’un effet d’ombrage pour la couche d’entités en sortie. L’azimut peut être compris entre 0 et 360 degrés, alors que l’altitude peut être comprise entre 0 et 90 degrés. Pour spécifier un azimut de 45 degrés et une altitude de 30 degrés, entrez « HILLSHADE 45, 30 ».	String
tag_field (Facultatif)	Nom de champ dans l’entité en sortie qui stocke la valeur de balise du triangle. Ce paramètre est vide par défaut : les valeurs de balise ne sont donc pas écrites dans la sortie.	String

Exemple de code

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

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.TinTriangle("tin", "tin_triangle.shp", units="DEGREE",
                      z_factor=1, hillshade="HILLSHADE 310,45", tag_field="tag")

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

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

'''****************************************************************************
Name: TinTriangle Example
Description: This script demonstrates how to use the
             TinTriangle tool to extract triangles from each TIN in the
             target workspace.
****************************************************************************'''
# Import system modules
import arcpy

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

# Create list of TINs
TINList = arcpy.ListDatasets("*", "Tin")

# Verify the presence of TINs in the list
if TINList:
    for dataset in TINList:
        # Set Local Variables
        TINList = arcpy.ListDatasets("*", "Tin")
        slopeUnits = "PERCENT"
        zfactor = 1
        hillshade = "HILLSHADE 300, 45" # defines hillshade azimuth & angle
        tagField = "Tag"
        Output = dataset + "_triangles.shp" # name of the output file
        # Run TinTriangle
        arcpy.ddd.TinTriangle(dataset, Output, slopeUnits, zfactor,
                              hillshade, tagField)
        print("Finished.")
else:
    print("There are no TIN(s) in the " + arcpy.env.workspace + " directory.")

Environnements

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

Informations de licence

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