Stack Profile (3D Analyst)
Summary
Creates a table and optional graph denoting the profile of line features over one or more multipatch, raster, TIN, or terrain surfaces.
Illustration
Usage
-
If the Output Graph Name parameter is populated and the tool is executed in ArcMap, ArcScene, or ArcGlobe, the resulting graph will be displayed on-screen.
The graph will be stored in memory, but can be saved as a graph file using the Save Graph tool.
The output table provides the information needed for generating the profile graph. Each line feature is densified along its overlapping profile targets in a manner that captures the profile's characteristics by introducing new vertices along the line. The elevation and distance along the input lines created by this densification gets stored in the output table along with the additional information about the line features and profile targets. The values in its fields can be used to create graphs in a wide variety of external applications. The fields represent:
- FIRST_DIST—Distance to the first vertex in the profile segment.
- FIRST_Z—Height of the first vertex in the profile segment.
- SEC_DIST—Distance of the second vertex in the profile segment.
- SEC_Z—Height of the second vertex in the profile segment.
- LINE_ID—Unique ID of the line feature used to define the profile.
- SRC_TYPE—Data type of the profile's source, which is either a surface or multipatch.
- SRC_ID—Unique ID of the multipatch feature being profiled. Not applicable for surface inputs.
- SRC_NAME—Name and path to the profile's source.
Syntax
| Parameter | Explanation | Data Type |
in_line_features |
The line features that will be profiled over the surface inputs. | Feature Layer |
profile_targets [profile_targets,...] |
The one or more multipatch features and raster, terrain, or TIN datasets that contribute to the surface model being profiled. | Feature Layer; Raster Layer; Terrain Layer; TIN Layer |
out_table |
The output table containing the values obtained from interpolating the input line features over the stack targets. | Table |
out_graph (Optional) |
The in-memory name of the optional output graph that can be saved to disk with the Save Graph tool. | Graph |
Code Sample
The following sample demonstrates the use of this tool in the Python window:
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')
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''**********************************************************************
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)