重叠剖面 (3D Analyst 工具)

汇总

创建表格和可选图表，用于说明一个或多个多面体、栅格、TIN 或 terrain 表面上的线要素的剖面。

用法

将对每条输入线进行增密，以沿其重叠的剖面目标插值高度。沿此增密方法创建的输入线的高程和距离，和有关线要素及剖面目标的信息一起存储在输出表中。
在 ArcGIS Pro 3.7 中，输出表已更改为支持创建用于描绘剖面的专门折线图。目前，此折线图只能通过运行该工具进行创建。表格包含以下字段，用于创建折线图：
- DISTANCE—距要创建剖面的位置起点的距离。
- Z—折点高度。
- LINE_ID—用于定义剖面的线要素的唯一 ID。
- SRC_NAME—高度源的名称。
- LINE_TARG—用于对图表中的数据进行分组的标识符。
也可以生成输出旧版表格以创建较旧格式的表格。虽然该表格无法在 ArcGIS Pro 中创建折线图，但它可以支持针对其方案设计的工作流。旧版表格包含以下字段：
- FIRST_DIST—到剖面段中第一个折点的距离。
- FIRST_Z—剖面段中第一个折点的高度。
- SEC_DIST—到剖面段中第二个折点的距离。
- SEC_Z—剖面段中第二个折点的高度。
- LINE_ID—用于定义剖面的线要素的唯一 ID。
- SRC_TYPE—剖面源的数据类型，即表面或多面体。
- SRC_ID—要描绘剖面的多面体要素的唯一 ID。不适用于表面输入。
- SRC_NAME—到剖面源的名称和路径。
剖面图可通过指定输出图形名称进行创建。当将表格加载到地图或场景中时，该图表将在目录窗格中该表格的下方显示，但如果生成的线系列超过 100 条，则不会创建该图表。
当为多面体要素创建剖面时，每个剖面段的两端各有一行，对应折点位置，另一行的 Z 值为 NULL，表示段间存在间隙。

标注	说明	数据类型
输入线要素	将在表面输入上描绘剖面的线要素。	Feature Layer
剖面目标	剖面的数据，可由多面体要素、栅格和三角化表面模型的任意组合组成。	Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
输出表	将存储与输入线相交的每个剖面目标的插值高度的输出表。	Table
输出图形名称（可选）	将要创建的输出折线图的标题。要生成图表，必须提供名称。	Graph
多面体粒度（可选）	指定输出图表中如何定义代表多面体要素的线系列。该参数仅在至少提供一个多面体要素类作为剖面目标时可用。 Feature Class—All the features in a multipatch feature class will be represented by one line series. This reduces the number of line series created in the chart and is a suitable option when one symbol is acceptable for all features. This is the default. Feature—Each feature in a given feature class will be represented by a unique line series. This provides the flexibility of symbolizing each feature with a different color in the output chart.	String
输出旧版表格（可选）	该可选表格使用 ArcGIS Pro 3.7 之前使用的字段提供剖面高度信息。	Table

arcpy.3d.StackProfile(in_line_features, profile_targets, out_table, {out_graph}, {multipatch_granularity}, {out_legacy_table})

名称	说明	数据类型
in_line_features	将在表面输入上描绘剖面的线要素。	Feature Layer
profile_targets [profile_targets,...]	剖面的数据，可由多面体要素、栅格和三角化表面模型的任意组合组成。	Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_table	将存储与输入线相交的每个剖面目标的插值高度的输出表。	Table
out_graph （可选）	将要创建的输出折线图的标题。要生成图表，必须提供名称。	Graph
multipatch_granularity （可选）	指定输出图表中如何定义代表多面体要素的线系列。该参数仅在至少提供一个多面体要素类作为剖面目标时可用。 `FEATURE_CLASS`—All the features in a multipatch feature class will be represented by one line series. This reduces the number of line series created in the chart and is a suitable option when one symbol is acceptable for all features. This is the default. `FEATURE`—Each feature in a given feature class will be represented by a unique line series. This provides the flexibility of symbolizing each feature with a different color in the output chart.	String
out_legacy_table （可选）	该可选表格使用 ArcGIS Pro 3.7 之前使用的字段提供剖面高度信息。	Table

代码示例

StackProfile 示例 1（Python 窗口）

下面的示例演示了如何在 Python 窗口中使用此工具：

arcpy.env.workspace = 'C:/data'
arcpy.ddd.StackProfile('profile_line.shp', profile_targets=['dem.tif', 'buildings.shp'],
                      out_table='profile_values.dbf')

StackProfile 示例 2（独立脚本）

下面的示例演示了如何在独立 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

# Run StackProfile
arcpy.ddd.StackProfile(profileLine, profileTargets, profileTable, graphName)

# Run SaveGraph
arcpy.management.SaveGraph(graphName, outGraph)

环境

当前工作空间, 范围

许可信息

基本: 需要 3D Analyst
标准: 需要 3D Analyst
高级: 需要 3D Analyst

重叠剖面 (3D Analyst 工具)

汇总

用法

参数

环境

许可信息

相关主题