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.
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
StackProfile_3d (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 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
Ejemplo 1 StackProfile (ventana de Python)
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de 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')
Ejemplo 2 StackProfile (secuencia de comandos independiente)
En el siguiente ejemplo se 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)
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere 3D Analyst
- ArcGIS for Desktop Standard: Requiere 3D Analyst
- ArcGIS for Desktop Advanced: Requiere 3D Analyst