Resumen
Calcula el área volumétrica y de superficie entre un polígono con una altura constante y una superficie.
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. A continuación, se calcula el área volumétrica y de superficie para todos los triángulos y las partes que caen dentro del polígono intersecado.
El volumen representa la región contenida entre la superficie y el espacio situado encima o debajo de las entidades poligonales en función de la selección realizada en el parámetro Plano de referencia.
- Calcular sobre el plano: el volumen se calcula entre el plano y la parte inferior de la superficie.
- Calcular bajo el plano: 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
arcpy.ddd.PolygonVolume(in_surface, in_feature_class, in_height_field, {reference_plane}, {out_volume_field}, {surface_area_field}, {pyramid_level_resolution})| Parámetro | Explicación | Tipo de datos |
in_surface | La superficie de TIN, terreno o dataset LAS que se desea procesar. | LAS Dataset Layer; Terrain Layer; TIN Layer |
in_feature_class | Las entidades poligonales que definen la región que se va a procesar. | 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) | La dirección desde el plano de referencia en la que se calcularán el área volumétrica y de superficie.
| String |
out_volume_field (Opcional) | Especifica el nombre del campo que contendrá los cálculos volumétricos. El valor predeterminado es Volume. | String |
surface_area_field (Opcional) | Especifica el nombre del campo que contendrá los cálculos de área de la superficie. El valor predeterminado 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 |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| output_feature_class | Las entidades de salida que se actualizarán. | Capa de entidades |
Muestra de código
Ejemplo 1 de PolygonVolume (ventana de Python)
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de 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")
Ejemplo 2 de PolygonVolume (script independiente)
En el siguiente ejemplo se muestra cómo usar esta herramienta en un script 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)
Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst