Résumé
Crée des isolignes dérivées d'une surface de jeu de données MNT, TIN ou LAS.
Pour en savoir plus sur le fonctionnement de l'outil Isoligne de surface
Illustration
Utilisation
La classe d'entités en sortie est en 2D et contient un attribut avec les valeurs d'isolignes.
Utilisez les options d'isoligne de base et d'intervalle pour adapter l'étendue et la résolution de la classe d'entités en sortie.
Utilisez les données extraites du champ d'isoligne pour convertir la classe d'entités en 3D.
Dans certaines instances, la dernière isoligne valide peut ne pas être produite lors de la création d'isolignes avec des surfaces TIN. Il s'agit d'une limitation algorithmique propre aux logiciels de création d'isolignes. Afin de vous assurer de la génération de toutes les isolignes valides, ajoutez une valeur négative très faible au champ Isoligne de base pour légèrement décaler les données.
Le paramètre Facteur Z affecte uniquement les résultats pour les rasters et les TIN, et non pour les jeux de données de MNT. Lorsque vous utilisez des jeux de données de MNT, vous pouvez spécifier un intervalle d'isolignes ayant le facteur z intégré. Par exemple, si vous souhaitez un intervalle d'isolignes d'un pied et si votre surface de jeu de données de MNT est en mètres, spécifiez un intervalle d'isolignes de 0,3048. Vous pouvez également convertir le jeu de données de MNT en un raster ou un TIN à l'aide des outils de géotraitement MNT vers raster ou MNT vers TIN.
Syntaxe
arcpy.ddd.SurfaceContour(in_surface, out_feature_class, interval, {base_contour}, {contour_field}, {contour_field_precision}, {index_interval}, {index_interval_field}, {z_factor}, {pyramid_level_resolution})| Paramètre | Explication | Type de données |
in_surface | Surface du jeu de données TIN, de MNT ou LAS à traiter. | LAS Dataset Layer; Terrain Layer; TIN Layer |
out_feature_class | Classe d'entités qui va être produite par cet outil. | Feature Class |
interval | Intervalle entre les isolignes. | Double |
base_contour (Facultatif) | Définit la valeur Z de départ de laquelle l'intervalle d'isoligne est soit ajoutée soit soustraite pour délimiter les isolignes. La valeur par défaut est 0.0. | Double |
contour_field (Facultatif) | Champ qui stocke la valeur d'isoligne associée à chaque ligne dans la classe d'entités en sortie. | String |
contour_field_precision (Facultatif) | Précision du champ d'isoligne. Zéro représente un nombre entier et la plage 1 à 9 indique le nombre de décimales incluses dans le champ. Par défaut, le champ est de type nombre entier (0). | Long |
index_interval (Facultatif) | Les courbes maîtresses sont communément utilisées comme aide cartographique pour aider à visualiser les isolignes. L'intervalle d'index est généralement cinq fois supérieur à l'intervalle des isolignes. L'utilisation de ce paramètre ajoute un champ de nombre entier défini par le index_interval_field à la table attributaire de la classe d'entités en sortie, où une valeur de 1 indique des isolignes d'index. | Double |
index_interval_field (Facultatif) | Nom du champ utilisé afin d’identifier les isolignes d'index. Ce paramètre est utilisé uniquement si l'option index_interval est définie. Par défaut, le nom de ce champ est Index. | 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 d'apparier les unités linéaires XY. La valeur par défaut est de 1, ce qui laisse les valeurs d’altitude inchangées. Ce paramètre est désactivé 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 |
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 par cet outil. La valeur par défaut est 0 (ou résolution maximale). | Double |
Exemple de code
1er exemple d'utilisation de l'outil SurfaceContour (fenêtre Python)
L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SurfaceContour_3d("sample.gdb/featuredataset/terrain", "contour.shp", 10)
2e exemple d'utilisation de l'outil SurfaceContour (script autonome)
L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.
'''****************************************************************************
Name: SurfaceContour Example
Description: This script demonstrates how to use the
SurfaceContour tool.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inSurface = "sample.gdb/featuredataset/terrain"
outContour = arcpy.CreateUniqueName("contour.shp")
#Execute SurfaceContour
arcpy.SurfaceContour_3d(inSurface, outContour, 10)
del inSurface, outContour, arcpy
Environnements
Informations de licence
- Basic: Requiert 3D Analyst
- Standard: Requiert 3D Analyst
- Advanced: Requiert 3D Analyst