Resumen
Crea una tabla y un gráfico opcional que denota el perfil de las entidades de línea sobre uno o más superficies de multiparche, ráster, TIN o terreno.
Uso
Cada línea de entrada se densifica para interpolar la altura a lo largo de sus objetivos de perfil superpuestos. La elevación y la distancia a lo largo de las líneas de entrada creadas por esta densificación se almacenan en la tabla de salida junto con la información sobre las entidades de línea y objetivos de perfil.
Los siguientes campos de la tabla de salida proporcionan la información necesaria para generar un gráfico en cualquier aplicación de creación de gráficos:
- 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: el Id. único de la entidad de línea que se utiliza para definir el perfil.
- SRC_TYPE: tipo de datos del origen del perfil, que es una superficie o multiparche.
- SRC_ID: Id. único de la entidad multiparche perfilada. No aplicable para las entradas de superficie.
- SRC_NAME: nombre y ruta al origen del perfil.
Sintaxis
arcpy.3d.StackProfile(in_line_features, profile_targets, out_table, {out_graph})
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, ráster y modelos de superficie triangulada. | Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer |
out_table | La tabla de salida que almacenará la altura interpolada para cada destino del perfil que se interseca con la línea de entrada. | Table |
out_graph (Opcional) | El gráfico de salida no es compatible con Pro. | Graph |
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.StackProfile_3d('profile_line.shp', profile_targets=['dem.tif', 'buildings.shp'],
out_table='profile_values.dbf')
En el siguiente ejemplo se muestra cómo usar esta herramienta en un script 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
# 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
# Execute StackProfile
arcpy.ddd.StackProfile(profileLine, profileTargets, profileTable, graphName)
# Execute SaveGraph
arcpy.management.SaveGraph(graphName, outGraph)
Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst