Volumen en superficie (3D Analyst)
Resumen
Calcula el área y el volumen de una superficie de ráster, de red irregular de triángulos (TIN) o de dataset de terreno por encima o debajo de un plano de referencia dado.
Obtenga más información sobre cómo funciona Volumen en superficie
Ilustración
 |
Uso
-
Considere usar la herramienta Volumen del polígono para determinar el volumen de una parte especificada de una superficie de TIN o dataset de terreno.
-
El uso de un Factor Z es fundamental para corregir los cálculos de volumen cuando las unidades z de superficie se expresan en una unidad de medida que no sea la unidad de terreno. El uso del Factor Z no modifica los datos originales.
Un DEM de ráster está compuesto por puntos separados por espacios regulares y no por celdas, como una imagen. El cálculo del área informado por la herramienta Volumen en Superficie se basa en los puntos separados por espacios regulares del DEM y no en la extensión de las celdas. Debido a que este cálculo se basa en los puntos, y no en las celdas, el área de datos para el DEM de ráster se reduce a la mitad de una celda en relación con el área de datos que se muestra como una imagen ráster.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_surface |
Superficie de dataset de terreno, de TIN o de ráster de entrada utilizada para calcular el área y el volumen. | Raster Layer; Terrain Layer; TIN Layer |
out_text_file (Opcional) |
El archivo de texto de salida opcional que contiene los resultados. | File |
reference_plane (Opcional) |
Elija si desea realizar el cálculo por encima o por debajo de una altura determinada.
| String |
base_z (Opcional) |
La elevación del plano que se utilizará para calcular el área y el volumen. | Double |
z_factor (Opcional) |
El factor por el cual se multiplicarán las alturas de la superficie de entrada para calcular el volumen de la superficie; se utiliza para convertir unidades Z a fin de que coincidan con las unidades XY. | Double |
pyramid_level_resolution (Opcional) |
La resolución del nivel de pirámide del dataset de terreno a utilizar para el geoprocesamiento. El valor predeterminado es 0, o resolución completa. | Double |
Ejemplo de código
El siguiente ejemplo muestra cómo usar de esta herramienta en la ventana Python:
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SurfaceVolume_3d("sample.gdb/featuredataset/terrain", "surf_vol.txt",
"ABOVE", 300, 1, 5)
El siguiente ejemplo 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
from arcpy import env
import exceptions, sys, traceback
try:
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inSurface = "elevation_tin"
#Execute SurfaceVolume
result = arcpy.SurfaceVolume_3d(inSurface, "", "ABOVE", "300", "1", "5")
print result.GetMessage(0)
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)