Isoligne—Aide | ArcGIS Desktop

Disponible avec une licence Spatial Analyst.

Disponible avec une licence 3D Analyst.

Résumé
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

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.
Cependant, les polygones d’isoligne sont extrapolés vers le bord extérieur du raster si le Contour type (Type d’isoligne) n'est pas égal à CONTOUR.
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.
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 l'outil Filtre au moyen de 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) sert à produire des isolignes ou des polygones. Par exemple, si vous avez un raster dont les valeurs sont entre 0 et 1000 et votre intervalle d'isolignes est 250, les classes d'entités en sortie suivantes seront créées :
- CONTOUR—Lignes à 250, 500, 750, et 1000
- CONTOUR_POLYGON—Polygones de 0 à 250, 250 à 500, 500 à 750, et 750 à 1000
- CONTOUR_SHELL—Polygones de 0 à 1000, 0 à 750, 0 à 500, et 0 à 250
- CONTOUR_SHELL_UP—Polygones de 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 sous-diviser un polygone en polygones plus petits selon la limite spécifiée du sommet. Ce paramètre doit être utilisé seulement si les entités en sortie contiennent un très grand nombre de sommets (de l’ordre de plusieurs millions). Ce paramètre produit une sortie similaire à celle créée par l'outil Dice.
Ce paramètre est conçu pour subdiviser des entités extrêmement grandes qui induisent de, par leur taille, des problèmes de stockage, de dessin et d’analyse.
La définition de la limite dépend de la mémoire disponible sur la machine sur laquelle l’outil est exécuté et de la taille de l’entité (les entités les plus grandes nécessitent une quantité de mémoire plus importante). Les ordinateurs les plus récents exécutant des logiciels 64 bits n’ont généralement pas de mal à traiter les entités contenant des milliers, voire des millions de sommets. En cas de problèmes, la définition de ce paramètre sur une valeur importante (1 million, par exemple) peut éviter les problèmes du fait de la taille de l’entité.
Le paramètre du maximum de sommets par polygone peut servir à subdiviser un polygone en polygones plus petits selon la limite de sommets définie. Ce paramètre doit être utilisé seulement si les entités en sortie contiennent un très grand nombre de sommets (de l’ordre de 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, une translation 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 subissent également une translation et les entités en sortie obtenues risquent de ne pas se superposer exactement au raster en entrée. Vous pouvez éviter ce décalage en utilisant le raster en entrée comme raster de capture dans l'environnement.
Pour plus d'informations sur les environnements de géotraitement qui s'appliquent à cet outil, reportez-vous à la rubrique Environnements d'analyse et Spatial Analyst.

Syntaxe

Contour (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. La sortie peut représenter les isolignes sous forme de lignes ou de polygones. Dans le cas de polygones, vous avez le choix entre plusieurs options. CONTOUR —Classe d'entité polyligne des contours (isolignes). Il s’agit de l’option par défaut. CONTOUR_POLYGON —Classe d'entité surfacique des isolignes remplis. CONTOUR_SHELL —La classe d'entité surfacique où la limite supérieure du polygone culmine jusqu'à la valeur d'intervalle. La limite inférieure reste constante au raster minimum. CONTOUR_SHELL_UP —Classe d’entités surfaciques dans laquelle la limite inférieure du polygone culmine, à partir du raster minimum jusqu’à la valeur d’intervalle, et dans laquelle la limite supérieure reste constante au raster maximum.	String
max_vertices_per_feature (Facultatif)	Spécifie une limite de sommets lors de la subdivision d’un polygone en polygones plus petits. Ce paramètre doit être utilisé seulement si les entités en sortie contiennent un très grand nombre de sommets (de l’ordre de plusieurs millions). Ce paramètre est conçu pour subdiviser des entités extrêmement grandes qui induisent de, par leur taille, des problèmes de stockage, de dessin et d’analyse. Si laissée vide, les polygones de sortie ne seront pas séparés. Le format 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  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
Contour("elevation", "C:/sapyexamples/output/outcontours.shp", 200, 0)

2e exemple d'utilisation de l'outil Isoligne (script autonome)