| Etiqueta | Explicación | Tipo de datos |
Superficie de entrada | 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 resultados. | File |
Plano de referencia (Opcional) | Especifica la dirección desde el plano de referencia que se utilizará para calcular los resultados.
| 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. Esto se utiliza generalmente para convertir las unidades lineales z 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 |
Resumen
Calcula el área y el volumen de la región entre una superficie y un plano de referencia.
Ilustración
Uso
Utilice el parámetro Factor Z para garantizar la precisión de los cálculos de volumen cuando los valores Z de la superficie estén en una unidad de medida diferente a las unidades X e Y. El parámetro Z Factor no modificará los datos originales. La herramienta determinará automáticamente el factor z adecuado cuando se definan sistemas de coordenadas x,y 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, como se muestra en el siguiente ejemplo:
Dataset Altura del plano Referencia Factor Z Área 2D Área 3D Volumen 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
Cuando la región para los cálculos no sea rectangular, utilice un polígono para definirla. A continuación, utilice la herramienta Volumen de polígono para determinar los cálculos.
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
arcpy.ddd.SurfaceVolume(in_surface, {out_text_file}, {reference_plane}, {base_z}, {z_factor}, {pyramid_level_resolution})| Nombre | Explicación | Tipo de datos |
in_surface | 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 resultados. | File |
reference_plane (Opcional) | Especifica la dirección desde el plano de referencia que se utilizará para calcular los resultados.
| 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. Esto se utiliza generalmente para convertir las unidades lineales z 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
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)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())Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst