Isoligne de surface (3D Analyst)

Synthèse

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

Illustration de l'outil Isolignes TIN

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.

Paramètres

ÉtiquetteExplicationType de données
Surface en entrée

Surface du jeu de données TIN, de MNT ou LAS qui sera traitée.

LAS Dataset Layer; Terrain Layer; TIN Layer
Classe d’entités en sortie

Classe d’entités qui va être produite.

Feature Class
Intervalle des isolignes

Intervalle entre les isolignes.

Double
Isoligne de base
(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
Champ d’isoligne
(Facultatif)

Champ qui stocke la valeur d'isoligne associée à chaque ligne dans la classe d'entités en sortie.

String
Précision de champ d’isoligne
(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
Intervalle de l’index
(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 Champ d'intervalle de l'index à la table attributaire de la classe d'entités en sortie, où une valeur de 1 indique des isolignes d'index.

Double
Champ d’intervalle de l’index
(Facultatif)

Nom du champ utilisé afin d’identifier les isolignes 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
Facteur Z
(Facultatif)

Facteur par lequel les valeurs z sont multipliées. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent 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 dont l’unité linéaire est spécifiée.

Double
Résolution des niveaux de pyramide
(Facultatif)

Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée. La valeur par défaut est 0 (ou résolution maximale).

Double

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})
NomExplicationType de données
in_surface

Surface du jeu de données TIN, de MNT ou LAS qui sera traitée.

LAS Dataset Layer; Terrain Layer; TIN Layer
out_feature_class

Classe d’entités qui va être produite.

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. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent 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 dont l’unité linéaire est 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. 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.

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceContour("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

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

# Set Local Variables
inSurface = "sample.gdb/featuredataset/terrain"
outContour = arcpy.CreateUniqueName("contour.shp")

#Execute SurfaceContour
arcpy.ddd.SurfaceContour(inSurface, outContour, 10)

Rubriques connexes