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.ddd.PolygonVolume(in_surface, in_feature_class, in_height_field, {reference_plane}, {out_volume_field}, {surface_area_field}, {pyramid_level_resolution})
Paramètre | Explication | Type 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.
| 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
Nom | Explication | Type 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.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.PolygonVolume_3d("sample.gdb/featuredataset/terrain", "polygon.shp", "<None>", "ABOVE", "Volume", "SArea", "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
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# 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)
Environnements
Informations de licence
- Basic: Requiert 3D Analyst
- Standard: Requiert 3D Analyst
- Advanced: Requiert 3D Analyst