Volume du polygone (3D Analyst)

Synthèse

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

Utilisation

  • Tout d’abord, chaque polygone va intersecter la surface. Le volume et la surface de tous les triangles de surface et portions de triangles contenus dans le polygone intersecté seront ensuite calculés. Si les calculs reposant sur une étendue répondent à vos besoins, vous pouvez utiliser l’outil Volume de surface pour des résultats plus rapides.

  • La superficie représente les portions de la surface qui se trouvent au-dessus ou en dessous de la hauteur des entités surfaciques. Le volume représente la région entre la surface et l’espace au-dessus ou en dessous de la hauteur de l’entité surfacique. Lorsque les calculs sont effectués au-dessus du plan, le volume représente la région entre le plan et la partie inférieure de la surface. Lorsque les calculs sont effectués sous le plan, le volume représente la région entre le plan et la partie supérieure de la surface.

  • La surface en entrée est évaluée en tant que réseau triangulé irrégulier (TIN). Un jeu de données LAS est traité en tant que surface en construisant un TIN à partir du jeu de données LAS. Puisque les jeux de données LAS contiennent généralement une grande quantité de points, la construction de la surface intermédiaire utilisée pour l’analyse peut nécessiter beaucoup de temps de traitement lorsque le polygone en entrée couvre un grand nombre de points. Dans un tel cas, vous pouvez exporter, un TIN affiné à partir du jeu de données LAS à l’aide de l’outil Jeu de données LAS vers TIN.

Paramètres

ÉtiquetteExplicationType de données
Surface en entrée

Surface du jeu de données TIN, de MNT ou LAS qui sera traitée.

LAS Dataset Layer; Terrain Layer; TIN Layer
Polygones en entrée

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

Feature Layer
Champ de hauteur

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

String
Plan de référence
(Facultatif)

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

  • Calculer au-dessus du planLe volume et la superficie seront calculés au-dessus de la hauteur du plan de référence des polygones.
  • Calculer en dessous du planLe volume et la superficie seront calculés au-dessous de la hauteur du plan de référence des polygones. Il s’agit de l’option par défaut.
  • Calculer au-dessus et en dessous du planLe volume et la superficie seront calculés au-dessus et en dessous de la hauteur du plan de référence des polygones.
String
Champ de volume
(Facultatif)

Le nom du champ qui contiendra les calculs volumétriques. La valeur par défaut est Volume.

String
Champ de superficie
(Facultatif)

Le nom du champ qui contiendra les calculs de superficie. La valeur par défaut est SArea.

String
Résolution des niveaux de pyramide
(Facultatif)

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

Double
Champ de volume
(Facultatif)

Le nom du champ qui contiendra le volume calculé au-dessus de la hauteur du polygone. La valeur par défaut est Above_Vol.

String
Champ de volume
(Facultatif)

Le nom du champ qui contiendra le volume calculé en dessous de la hauteur du polygone. La valeur par défaut est Below_Vol.

String
Champ Superficie au-dessus
(Facultatif)

Le nom du champ qui contiendra la superficie calculée au-dessus de la hauteur du polygone. La valeur par défaut est Above_SA.

String
Champ Superficie en dessous
(Facultatif)

Le nom du champ qui contiendra la superficie calculée au-dessous de la hauteur du polygone. La valeur par défaut est Below_SA.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités en sortie

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

Feature Layer

arcpy.ddd.PolygonVolume(in_surface, in_feature_class, in_height_field, {reference_plane}, {out_volume_field}, {surface_area_field}, {pyramid_level_resolution}, {out_volume_above_field}, {out_volume_below_field}, {surface_area_above_field}, {surface_area_below_field})
NomExplicationType de données
in_surface

Surface du jeu de données TIN, de MNT ou LAS qui sera traitée.

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

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

String
reference_plane
(Facultatif)

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

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

Le nom du champ qui contiendra les calculs volumétriques. La valeur par défaut est Volume.

String
surface_area_field
(Facultatif)

Le nom du champ qui contiendra les calculs de superficie. 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. La valeur par défaut est 0 (ou résolution maximale).

Double
out_volume_above_field
(Facultatif)

Le nom du champ qui contiendra le volume calculé au-dessus de la hauteur du polygone. La valeur par défaut est Above_Vol.

String
out_volume_below_field
(Facultatif)

Le nom du champ qui contiendra le volume calculé en dessous de la hauteur du polygone. La valeur par défaut est Below_Vol.

String
surface_area_above_field
(Facultatif)

Le nom du champ qui contiendra la superficie calculée au-dessus de la hauteur du polygone. La valeur par défaut est Above_SA.

String
surface_area_below_field
(Facultatif)

Le nom du champ qui contiendra la superficie calculée au-dessous de la hauteur du polygone. La valeur par défaut est Below_SA.

String

Sortie obtenue

NomExplicationType de données
output_feature_class

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

Feature Layer

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.ddd.PolygonVolume("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.ddd.PolygonVolume(inSurface, inPoly, zField, refPlane, volFld, sAreaFld)

Rubriques connexes