Disponible avec une licence Spatial Analyst.
Disponible avec une licence 3D Analyst.
Résumé
Crée une classe d'entités d'isolignes à partir d'une surface raster.
Pour plus d'informations sur le fonctionnement de l'outil Isoligne
Utilisation
Les isolignes ne se prolongent pas au-delà de l'étendue spatiale du raster, et ne sont pas générées dans les surfaces de NoData. Par conséquent, les entrées d'isolignes adjacentes doivent tout d'abord faire l'objet d'un recollement des bords dans un jeu de données d'entité continu. Au lieu de recoller les bords, vous pouvez fusionner les rasters adjacents avant de calculer les isolignes.
Toutefois, les polygones d’isolignes sont extrapolés au tronçon extérieur du raster si Contour type (Type d’isoligne) n’est pas égal à CONTOUR (ISOLIGNE).
Les isolignes peuvent être générées dans des surfaces de valeurs de raster négatives. Les valeurs d'isoligne sont négatives dans ce type de surface. Les intervalles d'isolignes négatifs ne sont pas autorisés.
Si l'extension ArcGIS Spatial Analyst est installée, des isolignes plus lisses mais moins précises peuvent être obtenues en prétraitant le raster en entrée via une opération Statistiques focales par l'intermédiaire de l'option MEAN ou de l'outil Filtre avec l'option LOW.
Par exemple, une isoligne de base est utilisée lorsque vous souhaitez créer des isolignes tous les 15 mètres, en commençant à 10 mètres. Ici, l'isoligne de base a la valeur 10 et l'intervalle des isolignes a la valeur 15. Les valeurs des isolignes sont alors 10, 25, 40, 55, etc.
La spécification d'une isoligne de base n'empêche pas la création d'isolignes au-dessus ou au-dessous de cette valeur.
Contour type (Type d’isoligne) permet de générer des isolignes ou des polygones. Par exemple, si votre raster comporte des valeurs entre 0 et 1000 et que la valeur de votre intervalle des isolignes est 250, les diverses classes d'entités en sortie suivantes sont créées :
- CONTOUR : lignes à 250, 500, 750 et 1000
- CONTOUR_POLYGON : polygones entre 0-250, 250-500, 500-750 et 750-1000
- CONTOUR_POLYGON : polygones entre 0-1000, 0-750, 0-500 et 0-250
- CONTOUR_SHELL_UP : polygones entre 0-1000, 250-1000, 500-1000 et 750-1000
Le paramètre Maximum vertices per polygon (Nombre maximal de sommets par polygone) peut être utilisé pour subdiviser un polygone en polygones plus petits selon la limite de sommets définie. Ce paramètre doit uniquement être utilisé lorsque des entités en sortie contiennent un très grand nombre de sommets (plusieurs millions). Ce paramètre produit une sortie analogue à celle qui est générée par l’outil Segmenter.
Ce paramètre a pour objectif de subdiviser les entités de très grande taille susceptibles d’entraîner des problèmes ultérieurement, par exemple lors du stockage, de l’analyse ou de l’affichage des entités.
Le choix d’une limite dépend de la mémoire disponible sur la machine sur laquelle l’outil s’exécute et de la taille de l’entité (les entités de grande taille requièrent une mémoire plus importante). La plupart des machines modernes qui exécutent des logiciels 64 bits ne rencontrent généralement aucun problème avec les entités individuelles qui contiennent des centaines de milliers ou des millions de sommets. Si vous rencontrez des problèmes, définissez ce paramètre sur une valeur plus élevée, par exemple 1 million, pour éviter les problèmes engendrés par la taille d’une entité.
Le paramètre de limite de sommets peut être utilisé pour subdiviser un polygone en polygones plus petits selon la limite de sommets définie. Ce paramètre doit uniquement être utilisé lorsque des entités en sortie contiennent un très grand nombre de sommets (plusieurs millions).
Si l'étendue est spécifiée dans le paramètre d'environnement et que l'angle inférieur gauche de l'étendue en sortie ne correspond à aucun angle de cellule du raster en entrée, au cours du traitement, un décalage de l'alignement de cellule du raster en entrée se produit pour correspondre à l'étendue spécifiée. Ce décalage déclenche un rééchantillonnage du raster en entrée à l'aide de la méthode Bilinéaire. Par conséquent, les entités en sortie se décalent également et les entités obtenues en sortie risquent de ne pas chevaucher exactement le raster en entrée. Vous pouvez éviter ce décalage en utilisant le raster en entrée comme raster de capture dans l'environnement.
Syntaxe
Contour_3d (in_raster, out_polyline_features, contour_interval, {base_contour}, {z_factor}, {contour_type}, {max_vertices_per_feature})
Paramètre | Explication | Type de données |
in_raster | Raster de surface en entrée. | Raster Layer |
out_polyline_features | Entités isolignes en sortie. | Feature Class |
contour_interval | Intervalle, ou distance, entre les isolignes. Il peut s'agir d'un nombre positif quelconque. | Double |
base_contour (Facultatif) | Valeur de l'isoligne de base. Les isolignes sont générées au-dessus et en dessous de cette valeur de façon à couvrir la plage de valeurs complète du raster en entrée. La valeur par défaut est zéro. | Double |
z_factor (Facultatif) | Facteur de conversion d'unités utilisé lors de la génération des isolignes. La valeur par défaut est 1. Les isolignes sont générées en fonction des valeurs z dans le raster en entrée, qui sont souvent mesurées en mètres ou en pieds. Avec la valeur par défaut 1, les isolignes sont dans les mêmes unités que les valeurs z du raster en entrée. Pour créer des isolignes dans une autre unité que celle des valeurs z, définissez une valeur appropriée pour le facteur z. Notez qu'il n'est pas nécessaire que les unités x,y au sol et les unités z de surface soient homogènes pour cet outil. Par exemple, si les valeurs d'altitude de votre raster en entrée sont en pieds, mais que vous voulez que les isolignes soient générées en mètres, définissez le facteur z sur 0,3048 (car 1 pied = 0,3048 m). Prenons un autre exemple : imaginons un raster en entrée en coordonnées géographiques WGS_84 et des unités d'altitude en mètres, pour lesquels vous voulez générer des isolignes tous les 100 pieds avec une base de 50 pieds (ainsi les isolignes seront à 50 pieds, 150 pieds, 250 pieds et ainsi de suite). Pour ce faire, définissez la valeur contour_interval sur 100, la valeur base_contour sur 50 et la valeur z_factor sur 3,2808 (car 1 mètre = 3,2808 pieds). | Double |
contour_type (Facultatif) | Type de sortie.
| String |
max_vertices_per_feature (Facultatif) | Indique une limite de sommets lors de la subdivision d’un polygone en polygones de plus petite taille. Ce paramètre doit uniquement être utilisé lorsque des entités en sortie contiennent un très grand nombre de sommets (plusieurs millions). Ce paramètre a pour objectif de subdiviser les entités de très grande taille susceptibles d’entraîner des problèmes ultérieurement, par exemple lors du stockage, de l’analyse ou de l’affichage des entités. S’il est laissé vide, les polygones en sortie ne seront pas divisés. La valeur par défaut est vide. | Long |
Exemple de code
1er exemple d'utilisation de l'outil Isoligne (fenêtre Python)
Cet exemple crée des isolignes à partir d'un raster de grille Esri et les rend sous forme de fichier de formes.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Contour_3d("elevation", "C:/output/outcontours.shp", 200, 0)
2e exemple d'utilisation de l'outil Isoligne (script autonome)
Cet exemple crée des isolignes à partir d'un raster de grille Esri et les rend sous forme de fichier de formes.
# Name: Contour_3d_Ex_02.py
# Description: Creates contours or isolines from a raster surface.
# Requirements: 3D Analyst Extension
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "elevation"
contourInterval = 200
baseContour = 0
outContours = "C:/sapyexamples/output/outcontours02.shp"
# Check out the ArcGIS 3D Analyst extension license
arcpy.CheckOutExtension("3D")
# Execute Contour
arcpy.Contour_3d(inRaster, outContours, contourInterval, baseContour)
Environnements
- Validation automatique
- Taille de cellule
- Espace de travail courant
- Valeur Z en sortie par défaut
- Etendue
- Transformations géographiques
- Résolution M
- Tolérance M
- Conserver un index spatial
- Mot-clé de configuration en sortie
- Système de coordonnées en sortie
- Valeurs M en sortie
- Valeurs Z en sortie
- Domaine M en sortie
- Domaine XY en sortie
- Domaine Z en sortie
- Espace de travail temporaire
- Raster de capture
- Résolution XY
- Tolérance XY
- Résolution Z
- Tolérance Z
Informations de licence
- ArcGIS Desktop Basic: Requiert 3D Analyst ou Spatial Analyst
- ArcGIS Desktop Standard: Requiert 3D Analyst ou Spatial Analyst
- ArcGIS Desktop Advanced: Requiert 3D Analyst ou Spatial Analyst