Volumen de polígono (3D Analyst)
Resumen
Calcula el área volumétrica y de superficie entre una superficie de polígono y de terreno o TIN.
Uso
-
Los cálculos solo se realizarán para las partes de los polígonos de entrada y la superficie de dataset de terreno o TIN que se superpone.
Cada límite del polígono primero se interseca con la zona de interpolación de la superficie. Así se identifica el área en común entre los dos. Entonces, se calcula el volumen y área de superficie para todos los triángulos y las partes que caen dentro del polígono intersecado.
El volumen representa el área cúbica entre la parte seleccionada de la superficie y un plano horizontal ubicado a la altura especificada en el parámetro Campo de altura.
- ABOVE: El volumen se calcula entre el plano y la parte inferior de la superficie.
- BELOW: El volumen se calcula entre el plano y la parte superior de la superficie. También se calcula el área de superficie para la misma parte de la superficie.
Sintaxis
Parámetro | Explicación | Tipo de datos |
in_surface |
La superficie TIN o de terreno de entrada. | Tin Layer; Terrain Layer |
in_feature_class |
La clase de entidad poligonal de entrada. | Feature Layer |
in_height_field |
El campo en la tabla de atributos del polígono que define la altura del plano de referencia que se utiliza para determinar los cálculos volumétricos. | String |
reference_plane (Opcional) |
Determina cómo se calcula el volumen y el área de superficie.
| String |
out_volume_field (Opcional) |
El nombre del campo en la salida que contendrá el volumen calculado en el análisis. La opción predeterminada es Volumen. | String |
surface_area_field (Opcional) |
El nombre del campo en la salida que contendrá el área de superficie calculada en el análisis. La opción predeterminada es SArea. | String |
pyramid_level_resolution (Opcional) |
La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que utilizará esta herramienta. El valor predeterminado es 0, o resolución completa. | Double |
Ejemplo de código
El siguiente ejemplo muestra cómo usar de esta herramienta en la ventana 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")
El siguiente ejemplo muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python:
'''****************************************************************************
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)