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 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
PolygonVolume_3d (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 | El terreno o superficie TIN que se va a evaluar. | Tin Layer; Terrain Layer |
in_feature_class | Las entidades poligonales que determinan las regiones de la superficie que se van 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) | Determina cómo se calcula el volumen y el área de superficie.
| String |
out_volume_field (Opcional) | Especifica el nombre del campo que contendrá los cálculos volumétricos. La predeterminada es Volume. | String |
surface_area_field (Opcional) | Especifica el nombre del campo que contendrá los cálculos de área de la superficie. La 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
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 (secuencia de comandos independiente)
En el siguiente ejemplo se 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)
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere 3D Analyst
- ArcGIS for Desktop Standard: Requiere 3D Analyst
- ArcGIS for Desktop Advanced: Requiere 3D Analyst