Résumé
Construit un polygone 3D ou une polyligne délimitant la hauteur tout au long du contour d’une surface raster.
Illustration
Utilisation
L’outil est prévu pour être utilisé sur une surface raster et fonctionnera uniquement sur un raster monocanal ou sur le canal spécifié d’un raster multicanal. L’entité en sortie capture le contour des cellules contiguës contenant des valeurs de données ; leur valeur z est interpolée le long du périmètre de la surface. Le périmètre est défini en reliant le centre des cellules les éloignées du raster.
La géométrie en sortie est placée dans un seul enregistrement d'entité et peut comprendre une entité multipart si le raster possède des cellules de données discontinues, séparées par des cellules NoData.
Syntaxe
arcpy.ddd.RasterDomain(in_raster, out_feature_class, out_geometry_type)
Paramètre | Explication | Type de données |
in_raster | Raster à traiter. | Raster Layer; Mosaic Layer |
out_feature_class | Classe d'entités qui va être produite par cet outil. | Feature Class |
out_geometry_type | Géométrie de la classe d'entités en sortie.
| String |
Exemple de code
1er exemple d'utilisation de l'outil RasterDomain (fenêtre Python)
L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.RasterDomain_3d("dtm_grd", "raster_domain.shp", "POLYGON")
2e exemple d'utilisation de l'outil RasterDomain (script autonome)
L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.
'''*********************************************************************
Name: RasterDomain Example
Description: This script demonstrates how to use the
Raster Domain tool to generate polygon footprints for all
*.img rasters in a given workspace.
**********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
try:
# Create the list of IMG rasters
rasterList = arcpy.ListRasters("*", "IMG")
# Verify there are rasters in the list
if rasterList:
# Loop the process for each raster
for raster in rasterList:
# Set Local Variables
outGeom = "POLYGON" # output geometry type
# The [:-4] strips the .img from the raster name
outPoly = "domain_" + raster[:-4] + ".shp"
print "Creating footprint polygon for " + raster + "."
#Execute RasterDomain
arcpy.RasterDomain_3d(raster, outPoly, outGeom)
print "Finished."
else:
"There are no IMG files in the " + env.workspace + " directory."
except Exception as e:
# Returns any other error messages
print e.message
Environnements
Informations de licence
- Basic: Requiert 3D Analyst
- Standard: Requiert 3D Analyst
- Advanced: Requiert 3D Analyst