Résumé
Calcule le volume et la surface entre un polygone et une surface de MNT ou de TIN.
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
PolygonVolume_3d (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 TIN ou de MNT qui sera évaluée. | Tin Layer; Terrain Layer |
in_feature_class | Entités surfaciques qui permettent de déterminer les régions de surface à traiter. | 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) | Détermine la méthode de calcul du volume et de la surface.
| 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 |
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
- ArcGIS Desktop Basic: Requiert 3D Analyst
- ArcGIS Desktop Standard: Requiert 3D Analyst
- ArcGIS Desktop Advanced: Requiert 3D Analyst