Créer des isolignes avec barrières (ArcGIS Spatial Analyst)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Crée des isolignes à partir d'une surface raster. Grâce à l'inclusion d'entités interruptions, une entité peut générer indépendamment des isolignes de part et d'autre d'une interruption.

Utilisation

Syntaxe

ContourWithBarriers (in_raster, out_contour_feature_class, {in_barrier_features}, {in_contour_type}, {in_contour_values_file}, {explicit_only}, {in_base_contour}, {in_contour_interval}, {in_indexed_contour_interval}, {in_contour_list}, {in_z_factor})
ParamètreExplicationType de données
in_raster

Raster de surface en entrée.

Raster Layer
out_contour_feature_class

Entités isolignes en sortie.

Feature Class
in_barrier_features
(Facultatif)

Entités interruptions en entrée.

Feature Layer
in_contour_type
(Facultatif)

Type d'isoligne à créer.

  • POLYLINES Représentation d'isoligne du raster en entrée.
  • POLYGONS Polygones fermés représentant les isolignes.

La version actuelle de l'outil Créer des isolignes avec interruptions prend uniquement en charge la sortie de type polyligne. Si l'option en sortie Polygones est utilisée, elle sera ignorée et une sortie de type polyligne sera créée.

String
in_contour_values_file
(Facultatif)

L'isoligne de base, l'intervalle des isolignes, l'intervalle des isolignes indexées et les valeurs d'isolignes réelles peuvent également être spécifiées par un fichier texte.

File
explicit_only
(Facultatif)

Seules les valeurs d'isolignes réelles sont utilisées. L'isoligne de base, l'intervalle des isolignes et les intervalles des isolignes indexées ne sont pas spécifiés.

  • NO_EXPLICIT_VALUES_ONLY Par défaut, l'intervalle des isolignes doit être spécifié.
  • EXPLICIT_VALUES_ONLY Seules les valeurs d'isolignes réelles sont précisées.
Boolean
in_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
in_contour_interval
(Facultatif)

Intervalle, ou distance, entre les isolignes.

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

Double
in_indexed_contour_interval
(Facultatif)

Les isolignes sont également générées pour cet intervalle et sont signalées en conséquence dans la classe d'entités en sortie.

Double
in_contour_list
[in_explicit_contour,...]
(Facultatif)

Valeurs réelles auxquelles créer des isolignes.

Double
in_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 dans 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).

Double

Exemple de code

1er exemple d'utilisation de l'outil Créer des isolignes avec barrières (fenêtre Python)

Cet exemple crée des isolignes à partir d'un raster de grille Esri avec une entité interruption en entrée, ainsi qu'une base et un intervalle. La sortie crée des isolignes autour de la surface sous forme de polylignes dans un fichier de formes.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
ContourWithBarriers("elevation", "C:/sapyexamples/output/outcontourwithbarriers.shp", "elevation_barrier.shp", "POLYLINES",
                    "", "", 0, 300)
2e exemple d'utilisation de l'outil Créer des isolignes avec barrières (script autonome)

Cet exemple crée des isolignes à partir d'un raster de grille Esri avec une entité interruption en entrée, ainsi qu'une base et un intervalle. La sortie crée des isolignes autour de la surface sous forme de polylignes dans un fichier de formes.

# Name: ContourWithBarriers_Ex_02.py
# Description: Creates contours from a raster surface.
#           The inclusion of barrier features will allow one to independently generate contours on either side of a barrier.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

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

# Set local variables
inRaster = "elevation"
inBarrier = "elevation_barrier.shp"
inTextFile = ""
explicitValues = "NO_EXPLICIT_VALUES_ONLY"
contourInterval = 200
contourList = [600, 935, 1237.4]
baseContour = 0
outContours = "C:/sapyexamples/output/outcontourwithbarriers02.shp"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Contour
ContourWithBarriers(inRaster, outContours, inBarrier, "POLYLINES", inTextFile, 
                    explicitValues, baseContour, contourInterval, "", 
                    contourList, "")

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst ou 3D Analyst
ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst ou 3D Analyst
ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst ou 3D Analyst
5/10/2014