Volumen de polígono (3D Analyst)

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

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. ABOVE —El área volumétrica y de superficie se calculan por encima de la altura del plano de referencia de los polígonos. BELOW —El área volumétrica y de superficie se calculan debajo de la altura del plano de referencia de los polígonos. Esta es la opción predeterminada.	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.

arcpy.env.workspace = "C:/data"
arcpy.PolygonVolume_3d("sample.gdb/featuredataset/terrain", "cut_off_plane.shp", 
                       in_height_field="Z", reference_plane="ABOVE", 
                       pyramid_level_resolution="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

# 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

Espacio de trabajo actual, Transformaciones geográficas, Extensión, Uso de memoria de terreno

Información de licenciamiento

• Basic: Requiere 3D Analyst
• Standard: Requiere 3D Analyst
• Advanced: Requiere 3D Analyst