Isoligne de surface (3D Analyst)
Récapitulatif
Crée des isolignes dérivées à l'aide d'une surface de MNT ou TIN.
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
| Paramètre | Explication | Type de données |
in_surface |
Jeu de données de MNT ou TIN en entrée. | Terrain Layer; TIN Layer |
out_feature_class |
Classe d'entités en sortie. | Feature Class |
interval |
Intervalle entre les isolignes. | Double |
base_contour (Facultatif) |
Outre l'intervalle d'index, la hauteur de base permet de déterminer quelles isolignes sont produites. La hauteur de base est un point de départ à partir duquel l'intervalle d'index est soit ajouté soit soustrait. L'isoligne de base est égale à 0,0 par défaut. | 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) |
Valeur facultative qui spécifie la différence d'altitude entre des isolignes d'index. Cette valeur est généralement cinq fois plus grande que l'intervalle des isolignes. L'utilisation de ce paramètre ajoute un champ de nombre entier défini par Champ d'intervalle de l'index à la table attributaire de la classe d'entités en sortie, où une valeur de 1 définit des isolignes d'index. | Double |
index_interval_field (Facultatif) |
Nom du champ qui indique si une isoligne est une isoligne d'index. Ce paramètre est utilisé uniquement si l'option Intervalle de l'index est définie. Par défaut, le nom de ce champ est Index. | String |
z_factor (Facultatif) |
Indique un facteur par lequel multiplier les hauteurs de surface pour convertir des unités Z afin d'apparier des unités XY. 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. | 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
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)
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