Apilar perfil (3D Analyst)
Resumen
Crea una tabla y un gráfico opcional que denota el perfil de las entidades de línea sobre una o más superficies de multiparche, ráster, TIN o terreno.
Ilustración
Uso
-
Si el parámetro Nombre del gráfico de salida está relleno y la herramienta se ejecuta en ArcMap, ArcScene o ArcGlobe, el gráfico resultante se visualizará en la pantalla.
El gráfico se almacenará en la memoria, pero se puede guardar como un archivo de gráfico con la herramienta Guardar gráfico.
La tabla de salida proporciona la información necesaria para generar el gráfico de perfil. Cada entidad de línea se densifican a lo largo de sus objetivos de perfil superpuestos de una manera que captura las características del perfil al introducir nuevos vértices a lo largo de la línea. La elevación y la distancia a lo largo de las líneas de entrada creadas por esta densificación se almacena en la tabla de salida junto con la información adicional sobre las entidades de línea y objetivos de perfil. Los valores en los campos se pueden utilizar para crear gráficos en una amplia variedad de aplicaciones externas. Los campos representan:
- FIRST_DIST: distancia al primer vértice en el segmento del perfil.
- FIRST_Z: altura del primer vértice en el segmento del perfil.
- SEC_DIST: distancia del segundo vértice en el segmento del perfil.
- SEC_Z: altura del segundo vértice en el segmento del perfil.
- LINE_ID: la Id. única de la entidad de línea que se utilizan para definir el perfil.
- SRC_TYPE: tipo de datos de la fuente del perfil, que es una superficie o multiparche.
- SRC_ID: Id. única de la entidad multiparche perfilada. No aplicable para las entradas de superficie.
- SRC_NAME nombre y ruta a la fuente del perfil.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_line_features |
Las entidades de línea que se perfilarán sobre las entradas de superficie. | Feature Layer |
profile_targets [profile_targets,...] |
Datos que se están perfilando, que pueden estar formados por cualquier combinación de entidades multiparche y modelos de superficie, como datasets de ráster, TIN, terreno y LAS. | Feature Layer; LAS Dataset Layer; Raster Layer; Terrain Layer; TIN Layer |
out_table |
Tabla de salida que almacenará las mediciones interpoladas para cada perfil. | Table |
out_graph (Opcional) |
Nombre del gráfico de salida que se puede visualizar en ArcMap, ArcScene o ArcGlobe. | Graph |
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.StackProfile_3d('profile_line.shp', 'dem.tif; buildings.shp',
'profile_values.dbf', 'Surface Profile')
El siguiente ejemplo muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python:
'''**********************************************************************
Name: Save Profiles to Graph Files
Description: Creates profile graphs of multipatch and surface features,
which are then saved as graph files.
**********************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
# Set Local Variables
profileLine = arcpy.GetParameterAsText(0)
profileTargets = arcpy.GetParameterAsText(1) # input las files
profileTable = arcpy.CreateUniqueName('profile_table', 'in_memory')
graphName = "Sample Graph"
outGraph = arcpy.GetParameterAsText(2) # output graph file
try:
arcpy.CheckOutExtension('3D')
# Execute StackProfile
arcpy.ddd.StackProfile(profileLine, profileTargets, profileTable, graphName)
# Execute SaveGraph
arcpy.management.SaveGraph(graphName, outGraph)
arcpy.CheckInExtension('3D')
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)