Domaine raster (3D Analyst)

Synthèse

Construit un polygone 3D ou une polyligne délimitant la hauteur tout au long du contour d’une surface raster.

Illustration

Entrée et sortie d'un domaine raster

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.

    Remarque :

    Les polygones 3D contiennent seulement des valeurs d'altitude le long du périmètre des entités, car les portions intérieures du polygone ne contiendront pas de sommets. En cas de dessin en 3D avec une zone de remplissage, les sommets de limite sont connectés arbitrairement aux triangles pour l'affichage. A moins que le polygone soit plane, incliné ou horizontal, il est peu probable que le remplissage représente précisément la surface intérieure. Pour cette raison, il est recommandé de dessiner des polygones 3D non planaires sans symbologie de remplissage.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Raster à traiter.

Raster Layer; Mosaic Layer
Classe d’entités en sortie

Classe d’entités qui va être produite.

Feature Class
Type de classe d'entités en sortie

Géométrie de la classe d'entités en sortie.

  • LigneLa sortie sera une classe d'entités linéaires prenant en charge les valeurs z.
  • PolygoneLa sortie sera une classe d'entités surfaciques prenant en charge les valeurs z.
String

arcpy.ddd.RasterDomain(in_raster, out_feature_class, out_geometry_type)
NomExplicationType de données
in_raster

Raster à traiter.

Raster Layer; Mosaic Layer
out_feature_class

Classe d’entités qui va être produite.

Feature Class
out_geometry_type

Géométrie de la classe d'entités en sortie.

  • LINELa sortie sera une classe d'entités linéaires prenant en charge les valeurs z.
  • POLYGONLa sortie sera une classe d'entités surfaciques prenant en charge les valeurs z.
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.

arcpy.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

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

# 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:
    print("There are no IMG files in the " + env.workspace + " directory.")

Informations de licence

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