Isoligne (3D Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence 3D Analyst.

Synthèse

Crée une classe d’entités d’isolignes à partir d’une surface raster.

En savoir plus 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. Ajuste dans un premier temps les bords des entrées de contours adjacents dans un jeu de données d’entités continues. 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 lorsque la valeur de Contour type (Type d’isoligne) n’est pas 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 vous disposez de Extension ArcGIS Spatial Analyst, il est possible d’obtenir des isolignes plus lisses, mais moins précises en prétraitant le raster en entrée à l’aide de l’outil Statistiques focales par l’intermédiaire de l’option Moyenne ou de l’outil Filtre au moyen de l’option Basse.

  • Par exemple, une isoligne de base est utilisée pour 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 est de 15. Les valeurs des isolignes sont 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 comprises entre 0 et 575 et que l’intervalle d’isolignes est 250, les classes d’entités en sortie suivantes sont créées : La sortie réelle est présentée, ainsi que les polygones des composants individuels séparément.

    • CONTOUR : lignes à 250 et 500
    • CONTOUR_POLYGON : polygones non superposés de 0 à 250, de 250 à 500 et de 500 à 575 (Fig. 1)

      Polygones de 0 à 250, de 250 à 500 et de 500 à 575

      Figure 1. L’option Contour polygon (Polygone d’isoligne) crée trois polygones non superposés de 0 à 250, de 250 à 500 et de 500 à 575.

    • CONTOUR_SHELL : polygones superposés de 0 à 575, de 0 à 500 et de 0 à 250 (Fig. 2)

      Polygones de 0 à 575, de 0 à 500 et de 0 à 250

      Figure 2. L’option Contour shell (Enveloppe d’isoligne) crée trois polygones superposés de 0 à 575, de 0 à 500 et de 0 à 250.

    • CONTOUR_SHELL_UP : Polygones superposés de 0 à 575, de 250 à 575 et de 500 à 575 (Fig. 3)

      Polygones de 0 à 575, de 250 à 575 et de 500 à 575

      Figure 3. L’option Contour shell up (Enveloppe d’isoligne supérieur) crée trois polygones superposés de 0 à 575, de 250 à 575 et de 500 à 575.

  • Le paramètre Maximum vertices per feature (Nombre maximal de sommets par entité) permet de subdiviser une entité. 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 Segmenter.

    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 de limite de sommets permet de subdiviser une entité. 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).

  • Par défaut, cet outil utilise des processeurs à plusieurs cœurs. Le nombre maximal de cœurs pouvant être utilisés est de quatre.

    Pour utiliser moins de cœurs, utilisez le paramètre d’environnement Facteur de traitement parallèle.

  • Si l’environnement Étendue est spécifié 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 pour l’environnement Raster de capture.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Raster de surface en entrée.

Raster Layer
Classe d'entités en sortie

Entités isolignes en sortie.

Feature Class
Intervalle des isolignes

Intervalle, ou distance, entre les isolignes.

Il peut s’agir d’un nombre positif quelconque.

Double
Isoligne de Base
(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
Facteur Z
(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. 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 du 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 (1 pied = 0,3048 mètre).

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 cela, définissez la valeur Intervalle des isolignes sur 100, la valeur Isoligne de base sur 50 et la valeur Facteur Z sur 3,2808 (1 mètre = 3,2808 pieds).

Double
Type d'isoligne
(Facultatif)

Spécifie le type de sortie. La sortie peut représenter les isolignes sous forme de lignes ou de polygones. Il existe plusieurs options pour les polygones.

  • IsoligneClasse d’entités polylignes d’isolignes. Il s’agit de l’option par défaut.
  • Polygone d’isoligneClasse d’entités surfaciques d’isolignes remplies.
  • Enveloppe d’isoligneClasse d’entités surfaciques où la limite supérieure du polygone augmente de manière cumulative selon la valeur d’intervalle. La limite inférieure reste constante au raster minimum.
  • Enveloppe d’isoligne supérieurClasse d’entités surfaciques où la limite inférieure du polygone augmente de manière cumulative selon la valeur d’intervalle, à partir du minimum du raster La limite supérieure reste constante au minimum du raster.
String
Nombre maximal de sommets par entité
(Facultatif)

Limite de sommets lors de la subdivision d’une entité. 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.

S’il est laissé vide, les entités en sortie ne seront pas fractionnées. Le format par défaut est vide.

Long

arcpy.ddd.Contour(in_raster, out_polyline_features, contour_interval, {base_contour}, {z_factor}, {contour_type}, {max_vertices_per_feature})
NomExplicationType 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. 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 du 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 (1 pied = 0,3048 mètre).

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 cela, définissez contour_interval sur 100, base_contour sur 50, et z_factor sur 3,2808 (1 mètre = 3,2808 pieds).

Double
contour_type
(Facultatif)

Spécifie le type de sortie. La sortie peut représenter les isolignes sous forme de lignes ou de polygones. Il existe plusieurs options pour les polygones.

  • CONTOURClasse d’entités polylignes d’isolignes. Il s’agit de l’option par défaut.
  • CONTOUR_POLYGONClasse d’entités surfaciques d’isolignes remplies.
  • CONTOUR_SHELLClasse d’entités surfaciques où la limite supérieure du polygone augmente de manière cumulative selon la valeur d’intervalle. La limite inférieure reste constante au raster minimum.
  • CONTOUR_SHELL_UPClasse d’entités surfaciques où la limite inférieure du polygone augmente de manière cumulative selon la valeur d’intervalle, à partir du minimum du raster La limite supérieure reste constante au minimum du raster.
String
max_vertices_per_feature
(Facultatif)

Limite de sommets lors de la subdivision d’une entité. 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.

S’il est laissé vide, les entités en sortie ne seront pas fractionnées. 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  
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"

# Execute Contour
arcpy.ddd.Contour(inRaster, outContours, contourInterval, baseContour)

Informations de licence

  • Basic: Nécessite 3D Analyst ou Spatial Analyst
  • Standard: Nécessite 3D Analyst ou Spatial Analyst
  • Advanced: Nécessite 3D Analyst ou Spatial Analyst

Rubriques connexes