Volumen en superficie (3D Analyst)

Resumen

Calcula el área y el volumen de la región entre una superficie y un plano de referencia.

Ilustración

Plano de referencia por encima; la altura del plano interseca la superficie
Plano de referencia por debajo; la altura del plano interseca la superficie

Uso

  • Aplica un Factor Z para garantizar la precisión de los cálculos de volumen cuando los valores Z de la superficie se expresan en una unidad de medida distinta de las unidades XY. El uso del Factor Z no modificará los datos originales. La herramienta determinará automáticamente el factor Z adecuado cuando se definan sistemas de coordenadas XY y Z.

  • El archivo de texto de salida almacenará la ruta completa a la superficie, los parámetros utilizados para generar los resultados y las mediciones de área y volumen que se han calculado. Si se especifica el mismo archivo de salida en varias ejecuciones de la herramienta, se mantendrán los registros preexistentes y los resultados se incorporarán a la tabla.

    DatasetAltura del planoReferenciaFactor ZÁrea 2DÁrea 3DVolumen

    C:\data\tin

    100.00

    Encima

    1

    15984467.82

    16354331.40

    1886012931.05

    C:\data\raster.tif

    250.5

    Debajo

    3,28084

    0

    0

    0

    C:\data.gdb\fd\terrain

    1250

    Encima

    0,3048

    1854238.36

    1970550.88

    1099221466.89

  • Si la región para la que va a calcular el volumen y el área de la superficie está definida con una extensión no rectangular, plantéese la posibilidad de crear un polígono para delinear el límite del área de interés y, a continuación, utilice la herramienta Volumen de polígono para determinar los cálculos de la región entre el plano definido por el polígono y una determinada superficie.

  • Una superficie de ráster se evalúa utilizando la extensión del punto central de cada celda, en lugar de la extensión del área completa de la celda. El análisis resultante reducirá el área de datos del ráster a la mitad de una celda en relación con el área de datos que se muestra para el ráster.

Parámetros

EtiquetaExplicaciónTipo de datos
Superficie de entrada

La superficie de ráster, TIN o terreno que se procesará.

Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Archivo de texto de salida
(Opcional)

Un archivo de texto ASCII delimitado por comas que contiene los cálculos de área y volumen. Si el archivo ya existe, se incorporarán los nuevos resultados.

File
Plano de referencia
(Opcional)

La dirección del plano de referencia para la que se van a calcular los resultados.

  • Por encima del planoLos cálculos de volumen y área representarán la región de espacio entre la altura del plano especificada y las partes de la superficie que están por encima del plano. Esta es la opción predeterminada.
  • Por debajo del planoLos cálculos de volumen y área representarán la región de espacio entre la altura del plano especificada y las partes de la superficie que están por debajo del plano.
String
Altura del plano
(Opcional)

El valor Z del plano que se utilizará para calcular el área y el volumen.

Double
Factor Z
(Opcional)

El factor por el que se multiplicarán los valores z. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada.

Double
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

arcpy.ddd.SurfaceVolume(in_surface, {out_text_file}, {reference_plane}, {base_z}, {z_factor}, {pyramid_level_resolution})
NombreExplicaciónTipo de datos
in_surface

La superficie de ráster, TIN o terreno que se procesará.

Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_text_file
(Opcional)

Un archivo de texto ASCII delimitado por comas que contiene los cálculos de área y volumen. Si el archivo ya existe, se incorporarán los nuevos resultados.

File
reference_plane
(Opcional)

La dirección del plano de referencia para la que se van a calcular los resultados.

  • ABOVELos cálculos de volumen y área representarán la región de espacio entre la altura del plano especificada y las partes de la superficie que están por encima del plano. Esta es la opción predeterminada.
  • BELOWLos cálculos de volumen y área representarán la región de espacio entre la altura del plano especificada y las partes de la superficie que están por debajo del plano.
String
base_z
(Opcional)

El valor Z del plano que se utilizará para calcular el área y el volumen.

Double
z_factor
(Opcional)

El factor por el que se multiplicarán los valores z. Generalmente se utiliza para convertir unidades lineales para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada.

Double
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

Muestra de código

Ejemplo 1 de SurfaceVolume (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.SurfaceVolume("sample.gdb/featuredataset/terrain", "surf_vol.txt", 
                       reference_plane="ABOVE", base_z=300, z_factor=3.24, 
                       pyramid_level_resolution=5)
Ejemplo 2 de SurfaceVolume (secuencia de comandos independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.

'''****************************************************************************
Name: Surface Volume Example
Description: This script demonstrates how to use the
             Surface Volume tool.

****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set Local Variables
inSurface = "elevation_tin"

# Execute SurfaceVolume
result = arcpy.ddd.SurfaceVolume(inSurface, "", "ABOVE", "300", "1", "5")
print(result.getMessages())

Información de licenciamiento

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

Temas relacionados