Volume du polygone (3D Analyst)

Résumé

Calcule le volume et la surface entre un polygone d'une hauteur constante et une surface.

Utilisation

  • Les calculs sont faits uniquement pour les portions des polygones en entrée et la surface du TIN ou du jeu de données de MNT en superposition.

  • Chaque limite de polygone est d'abord intersectée avec la zone d'interpolation de la surface. Cela permet d'identifier la zone commune aux deux. Un volume et une surface sont ensuite calculés pour tous les triangles et portions contenus dans le polygone intersecté.

  • Le volume représente la région entre la surface et l'espace au-dessus ou en dessous des entités surfaciques selon l'option du paramètre Plan de référence sélectionnée :

    • Calculer au-dessus du plan : le volume est calculé entre le plan et la partie inférieure de la surface.
    • Calculer en dessous du plan : le volume est calculé entre le plan et la partie supérieure de la surface. La zone surfacique pour la même portion de la surface est également calculée.

Syntaxe

arcpy.3d.PolygonVolume(in_surface, in_feature_class, in_height_field, {reference_plane}, {out_volume_field}, {surface_area_field}, {pyramid_level_resolution})
ParamètreExplicationType de données
in_surface

Surface du jeu de données TIN, de MNT ou LAS à traiter.

LAS Dataset Layer; Terrain Layer; TIN Layer
in_feature_class

Les entités surfaciques qui définissent la région en cours de traitement.

Feature Layer
in_height_field

Champ de la table attributaire du polygone qui définit la hauteur du plan de référence utilisé pour déterminer les calculs volumétriques.

String
reference_plane
(Facultatif)

La direction à partir du plan de référence dans laquelle le volume et la surface vont être calculés.

  • ABOVELe volume et la surface sont calculés au-dessus du plan de référence des polygones.
  • BELOWLe volume et la surface sont calculés au-dessous du plan de référence des polygones. Il s’agit de l’option par défaut.
String
out_volume_field
(Facultatif)

Spécifie le nom du champ qui contient les calculs volumétriques. La valeur par défaut est Volume.

String
surface_area_field
(Facultatif)

Spécifie le nom du champ qui contient les calculs de zone surfacique. La valeur par défaut est SArea.

String
pyramid_level_resolution
(Facultatif)

Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée par cet outil. La valeur par défaut est 0 (ou résolution maximale).

Double

Sortie dérivée

NomExplicationType de données
output_feature_class

Les entités en sortie qui seront mises à jour.

Couche d'entités

Exemple de code

1er exemple d'utilisation de l'outil PolygonVolume (fenêtre Python)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.

arcpy.env.workspace = "C:/data"
arcpy.PolygonVolume_3d("sample.gdb/featuredataset/terrain", "cut_off_plane.shp", 
                       in_height_field="Z", reference_plane="ABOVE", 
                       pyramid_level_resolution="5")
2e exemple d'utilisation de l'outil PolygonVolume (script autonome)

L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.

'''****************************************************************************
Name: PolygonVolume Example
Description: This script demonstrates how to use the 
             PolygonVolume tool.
****************************************************************************'''

# Import system modules
import arcpy
from arcpy import env

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


# Set Local Variables
inSurface = "sample.gdb/featuredataset/terrain"
inPoly = "floodplain_100.shp"
zField = "Height"
refPlane = "BELOW"
volFld = "Volume"
sAreaFld = "SArea"

#Execute PolygonVolume
arcpy.PolygonVolume_3d(inSurface, inPoly, zField, refPlane, volFld, sAreaFld)

Informations de licence

  • Basic: Requiert 3D Analyst
  • Standard: Requiert 3D Analyst
  • Advanced: Requiert 3D Analyst

Rubriques connexes