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.

Parámetros

EtiquetaExplicaciónTipo de datos
Superficie de entrada

La superficie de TIN, terreno o dataset LAS que se desea procesar.

LAS Dataset Layer; Terrain Layer; TIN Layer
Entidades de entrada

Las entidades poligonales que definen la región que se va a procesar.

Feature Layer
Campo de altura

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
Plano de Referencia
(Opcional)

La dirección desde el plano de referencia en la que se calcularán el área volumétrica y de superficie.

  • Calcular sobre el planoEl área volumétrica y de superficie se calculan por encima de la altura del plano de referencia de los polígonos.
  • Calcular bajo el planoEl á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
Campo Volumen
(Opcional)

Especifica el nombre del campo que contendrá los cálculos volumétricos. El valor predeterminado es Volume.

String
Campo Area de superficie
(Opcional)

Especifica el nombre del campo que contendrá los cálculos de área de la superficie. El valor predeterminado es SArea.

String
Resolución de nivel de pirámide
(Opcional)

La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa.

Double

Salida derivada

EtiquetaExplicaciónTipo de datos
Clase de entidad de salida

Las entidades de salida que se actualizarán.

Capa de entidades

arcpy.ddd.PolygonVolume(in_surface, in_feature_class, in_height_field, {reference_plane}, {out_volume_field}, {surface_area_field}, {pyramid_level_resolution})
NombreExplicació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 se utilizará. 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