Available for an ArcGIS organization licensed with the Indoors extension.
描述
用于移除每个楼层上所选位置之间路径选择不需要的初步网络路径,从而减小网络数据集大小并改善其路径求解性能。
插图
使用方法
输入楼层要素参数必须是符合 Levels 要素类的 Indoors Model 的面要素图层或要素类。通过在输入图层上进行选择或者提供定义查询,可以将路径的稀疏化限制为特定楼层(级别)。如果没有选择或定义查询,则该工具将为输入图层中的所有楼层稀疏化路径。
输入路径要素参数必须是符合 PrelimPathways 要素类的 Indoors Model 的折线要素图层或要素类。可以使用生成室内路径工具生成初步路径。该工具将忽略此输入图层上的任何选择或定义查询。
输入过渡要素参数必须是符合 PrelimTransitions 要素类的 Indoors Model 的折线要素图层或要素类。可以使用生成楼层过渡工具生成初步过渡。
目标路径参数必须是符合 Pathways 要素类的 Indoors Model 的现有折线要素图层或要素类。将使用在创建网络数据集中使用的最终稀疏化路径来更新此数据集。
目标过渡参数必须是符合 Transitions 要素类的 Indoors Model 的现有折线要素图层或要素类。将使用在创建网络数据集中使用的最终稀疏化过渡来更新此数据集。
可路由位置参数必须至少包含一个符合 PointsOfInterest 要素类的 Indoors Model 的点要素图层或要素类。
- 在稀疏化输入路径和过渡要素时,将使用可路由位置来确定构成有效网络所需的要素。
- 搜索容差参数值以外的点将不包含在路径计算中。
- 在运行此工具之前,可以使用定义查询或按属性选择图层工具从图层中选择要处理的可路由位置。
- 如果网络容差范围内存在大量紧密邻近的点,则建议您过滤包含的要进行处理的可路由位置数量。
可以使用相邻要素求解计数参数,通过分别增大或限制可路由位置之间要计算的潜在路径数量来提高网络连通性或缩短处理时间。
- 如果存在大量紧密邻近的点,则建议您减小此值,从而以网络连通性为代价来缩短处理时间。
- 可以增大此值,从而以增加处理时间为代价来提供更加直接的路径。
在运行此工具之前,请使用输入路径和目标路径或过渡来删除所有网络数据集。
语法
ThinIndoorPathways(in_level_features, in_pathway_features, in_transition_features, routable_locations, target_pathways, target_transitions, {search_tolerance}, {neighbor_solve_count})
参数 | 说明 | 数据类型 |
in_level_features | 输入面要素,表示一个或多个建筑物(设施点)中的一个或多个楼层。在 Indoors 模型中,此项将为 Levels 图层。该工具将仅处理这些要素表示的楼层(级别)。 | Feature Layer |
in_pathway_features | 表示要稀疏化的初步路径的输入折线要素。在 Indoors 模型中,此项将为 PrelimPathways 图层。 | Feature Layer |
in_transition_features | 表示要稀疏化的初步过渡的输入折线要素。在 Indoors Model 中,此项将为 PrelimTransitions 图层。 | Feature Layer |
routable_locations [routable_locations,...] | 表示用于计算路径的位置的输入点要素。在 Indoors Model 中,此项将为 PointsOfInterest 图层。 | Feature Layer |
target_pathways | 将添加稀疏化路径的现有要素类或要素图层。在 Indoors Model 中,此项将为 Pathways 图层。 | Feature Layer |
target_transitions | 将添加稀疏化过渡的现有要素类或要素。在 Indoors Model 中,此项将为 Transitions 图层。 | Feature Layer |
search_tolerance (可选) | 该工具将搜索的距离(以米为单位),以查找输入路径附近的可路由位置要素。距离大于此值的可路由位置要素将不会用于稀疏化。默认值为 5。 注:该值必须大于等于 0。 | Long |
neighbor_solve_count (可选) | 在计算建筑物(设施点)中给定位置与其他可路由位置之间的路径时,要求解的最接近相邻位置数量。默认值为 50。 注:该值必须大于等于 1。 | Long |
派生输出
名称 | 说明 | 数据类型 |
updated_pathways | 已更新的目标路径图层。 | 要素类 |
updated_transitions | 已更新的目标过渡图层。 | 要素类 |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 ThinIndoorPathways 函数。
import arcpy
arcpy.indoors.ThinIndoorPathways(r"C:\Indoors\ExampleCampus.gdb\Indoors\Levels",
r"C:\Indoors\ExampleCampus.gdb\PrelimNetwork\PrelimPathways",
r"C:\Indoors\ExampleCampus.gdb\PrelimNetwork\PrelimTransitions",
"'C:/Indoors/ExampleCampus.gdb/Indoors/PointsOfInterest';'C:/Indoors/ExampleCampus.gdb/Indoors/Events'",
r"C:\Indoors\ExampleCampus.gdb\Network\Pathways",
r"C:\Indoors\ExampleCampus.gdb\Network\Transitions",
5, 50)
以下独立脚本演示了如何使用 ThinIndoorPathways 函数。
# Name: Indoors_ThinIndoorPathways_example2.py
# Description: Thins preliminary pathways for use with an Indoors network dataset
import arcpy
# Set tool parameters
in_level_features = r"C:\Indoors\ExampleCampus.gdb\Indoors\Levels"
in_pathway_features = r"C:\Indoors\ExampleCampus.gdb\PrelimNetwork\PrelimPathways"
in_transition_features = r"C:\Indoors\ExampleCampus.gdb\PrelimNetwork\PrelimTransitions"
routable_locations = [r"C:\Indoors\ExampleCampus.gdb\Indoors\PointsOfInterest",
r"C:\Indoors\ExampleCampus.gdb\Indoors\Events"]
target_pathways = r"C:\Indoors\ExampleCampus.gdb\Network\Pathways"
target_transitions = r"C:\Indoors\ExampleCampus.gdb\Network\Transitions"
search_tolerance = 7
neighbor_solve_count = 75
# Run the tool
arcpy.indoors.ThinIndoorPathways(in_level_features, in_pathway_features,
in_transition_features, routable_locations,
target_pathways, target_transitions,
search_tolerance, neighbor_solve_count)
环境
许可信息
- Basic: 否
- Standard: 否
- Advanced: 需要 Indoors, 3D Analyst, and Network Analyst