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

  • Primero, cada polígono intersecará la superficie. A continuación, se calcula el volumen y la superficie de todos los triángulos de superficie y las partes de los triángulos que caen dentro del polígono intersecado. Si los cálculos basados en una extensión son adecuados para sus necesidades, puede utilizar la herramienta Volumen en superficie para obtener resultados más rápidos.

  • El área de superficie representa las partes de la superficie que están por encima o por debajo de la altura de las entidades poligonales. El volumen representa la región entre la superficie y el espacio por encima o por debajo de la altura de la entidad poligonal. Cuando se realizan cálculos por encima del plano, el volumen representa la región entre el plano y la parte inferior de la superficie. Cuando se realizan cálculos por debajo del plano, el volumen representa la región entre el plano y la parte superior de la superficie.

  • La superficie de entrada se evalúa como una red irregular de triángulos (TIN). Un dataset LAS se procesa como una superficie construyendo un TIN a partir del dataset LAS. Dado que los datasets LAS suelen contener una gran cantidad de puntos, la construcción de la superficie intermedia que se utiliza para el análisis puede tardar un tiempo considerable para el procesamiento cuando el polígono de entrada abarca un gran número de puntos. En este caso, puede exportar una TIN simplificada desde el dataset LAS con la herramienta Dataset LAS a TIN.

Parámetros

EtiquetaExplicaciónTipo de datos
Superficie de entrada

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

LAS Dataset Layer; Terrain Layer; TIN Layer
Polígonos 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 utilizará para determinar los cálculos volumétricos.

String
Plano de referencia
(Opcional)

Especifica 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 calcularán por encima de la altura del plano de referencia de los polígonos.
  • Calcular bajo el planoEl área volumétrica y de superficie se calcularán por debajo de la altura del plano de referencia de los polígonos. Esta es la opción predeterminada.
  • Calcular por encima y por debajo del planoEl área volumétrica y de superficie se calcularán por encima y por debajo de la altura del plano de referencia de los polígonos.
String
Campo Volumen
(Opcional)

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

String
Campo de área de superficie
(Opcional)

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
Campo Volumen
(Opcional)

El nombre del campo que contendrá el volumen calculado por encima de la altura del polígono. El valor predeterminado es Above_Vol.

String
Campo Volumen
(Opcional)

El nombre del campo que contendrá el volumen calculado por debajo de la altura del polígono. El valor predeterminado es Below_Vol.

String
Campo de área de superficie por encima
(Opcional)

El nombre del campo que contendrá el área de superficie calculada por encima de la altura del polígono. El valor predeterminado es Above_SA.

String
Campo de área de superficie por debajo
(Opcional)

El nombre del campo que contendrá el área de superficie calculada por debajo de la altura del polígono. El valor predeterminado es Below_SA.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Clase de entidad de salida

Las entidades de salida que se actualizarán.

Feature Layer

arcpy.ddd.PolygonVolume(in_surface, in_feature_class, in_height_field, {reference_plane}, {out_volume_field}, {surface_area_field}, {pyramid_level_resolution}, {out_volume_above_field}, {out_volume_below_field}, {surface_area_above_field}, {surface_area_below_field})
NombreExplicaciónTipo de datos
in_surface

La superficie de TIN, terreno o dataset LAS que se 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 utilizará para determinar los cálculos volumétricos.

String
reference_plane
(Opcional)

Especifica 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 calcularán por encima de la altura del plano de referencia de los polígonos.
  • BELOWEl área volumétrica y de superficie se calcularán por debajo de la altura del plano de referencia de los polígonos. Esta es la opción predeterminada.
  • BOTHEl área volumétrica y de superficie se calcularán por encima y por debajo de la altura del plano de referencia de los polígonos.
String
out_volume_field
(Opcional)

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

String
surface_area_field
(Opcional)

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
out_volume_above_field
(Opcional)

El nombre del campo que contendrá el volumen calculado por encima de la altura del polígono. El valor predeterminado es Above_Vol.

String
out_volume_below_field
(Opcional)

El nombre del campo que contendrá el volumen calculado por debajo de la altura del polígono. El valor predeterminado es Below_Vol.

String
surface_area_above_field
(Opcional)

El nombre del campo que contendrá el área de superficie calculada por encima de la altura del polígono. El valor predeterminado es Above_SA.

String
surface_area_below_field
(Opcional)

El nombre del campo que contendrá el área de superficie calculada por debajo de la altura del polígono. El valor predeterminado es Below_SA.

String

Salida derivada

NombreExplicaciónTipo de datos
output_feature_class

Las entidades de salida que se actualizarán.

Feature Layer

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.ddd.PolygonVolume("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 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

# 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.ddd.PolygonVolume(inSurface, inPoly, zField, refPlane, volFld, sAreaFld)

Temas relacionados