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ámetroExplicaciónTipo 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.

  • ABOVEEl área volumétrica y de superficie se calculan por encima de la altura del plano de referencia de los polígonos.
  • BELOWEl á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

NombreExplicaciónTipo 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)

Información de licenciamiento

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

Temas relacionados