稀疏化室内路径 (Indoors)

适用于 ArcGIS Indoors Pro 或 ArcGIS Indoors Maps 扩展模块。

需要 3D Analyst 许可。

需要 Network Analyst 许可。

摘要

用于移除每个楼层上所选位置之间路径选择不需要的初步网络路径,从而减小网络数据集大小并改善其路径求解性能。

插图

“稀疏化室内路径”工具图示

使用情况

  • 输入楼层要素参数值可以是室内数据集(使用创建室内数据集工具创建)中的要素图层或要素类,也可以是 Indoors 地理数据库(使用创建室内数据库工具创建)。 以下输入参数值可以是室内网络数据集(使用创建室内网络数据集创建)或 Indoors 地理数据库中的要素图层或要素类:输入路径要素输入过渡要素目标路径目标过渡

  • 输入楼层要素参数值必须是符合 Levels 要素类的 Indoors 模型的面要素图层或要素类。 通过在输入图层上进行选择或者提供定义查询,可以将路径的稀疏化限制为特定楼层。 如果没有选择或定义查询,则系统将为输入图层中的所有楼层稀疏化路径。

  • 输入路径要素参数值必须是符合 PrelimPathways 要素类的 Indoors 模型的折线要素图层或要素类。 可以使用生成室内路径工具生成初步路径。 系统将忽略此输入图层上的选择或定义查询。

  • 输入过渡要素参数值必须是符合 PrelimTransitions 要素类的 Indoors 模型的折线要素图层或要素类。 可以使用生成楼层过渡工具生成初步过渡。

  • 目标路径参数值必须是符合 Pathways 要素类的 Indoors 模型的现有折线要素图层或要素类。 将使用在创建网络数据集中使用的最终稀疏化路径来更新此要素类。

  • 目标过渡参数值必须是符合 Transitions 要素类的 Indoors 模型的现有折线要素图层或要素类。 将使用在创建网络数据集中使用的最终稀疏化过渡来更新此要素类。

  • 可路由位置参数值必须至少包含一个点或面要素图层或要素类。 可路由位置可以来自以下类型的图层和要素类:

    • 室内数据集中的点或面要素图层或要素类
    • 来自 Indoors 地理数据库的点或面要素图层或要素类
    • 配置为楼层感知型对象的点或面要素图层或要素类
    • 具有可将要素与其所在楼层相关联的 LEVEL_ID 字段的点或面要素图层或要素类

    在设置可路由位置参数时,请牢记以下内容:

    • 在稀疏化输入路径和过渡要素时,将使用可路由位置来识别构成有效网络所需的要素。
    • 搜索容差参数值以外的要素将不包含在路径计算中。
    • 在运行此工具之前,可以使用定义查询或按属性选择图层工具从图层中选择将处理的可路由位置。
    • 如果网络容差范围内存在大量紧密邻近的点或面,请考虑过滤包含的要进行处理的可路由位置数量。

  • 可以使用相邻要素求解计数参数,通过分别增大或限制可路由位置之间要计算的潜在路径数量来提高网络连通性或缩短处理时间。

    • 如果存在大量紧密邻近的要素,请考虑减小此值,从而以网络连通性为代价来缩短处理时间。
    • 可以增大此值,从而以增加处理时间为代价来提供更加直接的路径。

  • 在运行此工具之前,请删除目标路径和过渡所在的同一要素数据集中的所有网络数据集。

  • 搜索容差参数值将以米为单位定义搜索容差。 默认值为 5。

参数

标注说明数据类型
输入楼层要素

输入面要素,表示一个或多个设施点中的一个或多个楼层。 在 ArcGIS Indoors 信息模型中,此项将为 Levels 图层。 系统将仅处理这些要素表示的楼层。

Feature Layer
输入路径要素

表示要细化的初步路径的输入折线要素。 在 Indoors 模型中,此项为 PrelimPathways 图层。

Feature Layer
输入过渡要素

表示要细化的初步过渡的输入折线要素。 在 Indoors 模型中,此项将为 PrelimTransitions 图层。

Feature Layer
可路由位置

表示用于计算路径的位置的输入点或面要素。 该要素可以是符合 Indoors 模型或配置为楼层感知型的任何点或面要素。

Feature Layer
目标路径

将添加细化路径的现有要素类或要素图层。 在 Indoors 模型中,此项将为 Pathways 图层。

Feature Layer
目标过渡

将添加细化过渡的现有要素类或要素。 在 Indoors 模型中,此项将为 Transitions 图层。

Feature Layer
搜索容差
(可选)

该工具将搜索的距离(以米为单位),以查找输入路径附近的可路由位置要素。 距离大于此值的可路由位置要素将不会用于稀疏化。 默认值为 5。

注:

该值必须大于等于 0。

Long
相邻要素求解计数
(可选)

在计算设施点中指定位置与其他可路由位置之间的路径时,将要求解的最接近相邻位置数量。 默认值为 50。

注:

该值必须大于等于 1。

Long

派生输出

标注说明数据类型
已更新的路径

已更新的目标路径图层。

Feature Class
已更新的过渡

已更新的目标过渡图层。

Feature Class

arcpy.indoors.ThinIndoorPathways(in_level_features, in_pathway_features, in_transition_features, routable_locations, target_pathways, target_transitions, {search_tolerance}, {neighbor_solve_count})
名称说明数据类型
in_level_features

输入面要素,表示一个或多个设施点中的一个或多个楼层。 在 ArcGIS Indoors 信息模型中,此项将为 Levels 图层。 系统将仅处理这些要素表示的楼层。

Feature Layer
in_pathway_features

表示要细化的初步路径的输入折线要素。 在 Indoors 模型中,此项为 PrelimPathways 图层。

Feature Layer
in_transition_features

表示要细化的初步过渡的输入折线要素。 在 Indoors 模型中,此项将为 PrelimTransitions 图层。

Feature Layer
routable_locations
[routable_locations,...]

表示用于计算路径的位置的输入点或面要素。 该要素可以是符合 Indoors 模型或配置为楼层感知型的任何点或面要素。

Feature Layer
target_pathways

将添加细化路径的现有要素类或要素图层。 在 Indoors 模型中,此项将为 Pathways 图层。

Feature Layer
target_transitions

将添加细化过渡的现有要素类或要素。 在 Indoors 模型中,此项将为 Transitions 图层。

Feature Layer
search_tolerance
(可选)

该工具将搜索的距离(以米为单位),以查找输入路径附近的可路由位置要素。 距离大于此值的可路由位置要素将不会用于稀疏化。 默认值为 5。

注:

该值必须大于等于 0。

Long
neighbor_solve_count
(可选)

在计算设施点中指定位置与其他可路由位置之间的路径时,将要求解的最接近相邻位置数量。 默认值为 50。

注:

该值必须大于等于 1。

Long

派生输出

名称说明数据类型
updated_pathways

更新的 target_pathways 图层。

Feature Class
updated_transitions

更新的 target_transitions 图层。

Feature Class

代码示例

ThinIndoorPathways 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 ThinIndoorPathways 函数。

import arcpy
arcpy.indoors.ThinIndoorPathways(r"C:\Indoors\ExampleCampus.gdb\Indoor\Levels", 
                                  r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimPathways", 
                                  r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimTransitions", 
                                  "'C:/Indoors/ExampleCampus.gdb/Indoor/Units';'C:/Indoors/ExampleCampus.gdb/Indoor/FloorAwarePoints';'C:/Indoors/ExampleCampus.gdb/Indoor/FloorAwarePolygons'", 
                                  r"C:\Indoors\ExampleCampus.gdb\IndoorNetwork\Pathways", 
                                  r"C:\Indoors\ExampleCampus.gdb\IndoorNetwork\Transitions", 
                                  5, 50)
ThinIndoorPathways 示例 2(独立脚本)

以下独立脚本演示了如何使用 ThinIndoorPathways 函数。

# Name: Indoors_ThinIndoorPathways_example2.py
# Description: Thins preliminary pathways for use with an indoor network dataset

import arcpy

# Set tool parameters
in_level_features = r"C:\Indoors\ExampleCampus.gdb\Indoor\Levels"
in_pathway_features = r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimPathways"
in_transition_features = r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimTransitions"
routable_locations = [r"C:\Indoors\ExampleCampus.gdb\Indoor\Units",  
                      r"C:\Indoors\ExampleCampus.gdb\Indoor\FloorAwarePoints", 
                      r"C:\Indoors\ExampleCampus.gdb\Indoor\FloorAwarePolygons"]
target_pathways = r"C:\Indoors\ExampleCampus.gdb\IndoorNetwork\Pathways"
target_transitions = r"C:\Indoors\ExampleCampus.gdb\IndoorNetwork\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: 需要 ArcGIS Indoors Pro 或 ArcGIS Indoors Maps、3D Analyst 以及Network Analyst

相关主题