生成楼层过渡 (Indoors)

摘要

用于创建或更新垂直连接楼层的过渡线要素。

所选过渡单元面用于在设施点中的各个级别之间生成垂直过渡线。 这些过渡要素将与路径要素结合使用，以生成用于路径选择的网络。

使用情况

• 用于输入设施点要素、输入设施点要素和过渡单元要素参数值的要素图层或要素类可以来自室内数据集或 Indoors 地理数据库。 用于路径要素和目标过渡参数值的要素图层或要素类可以来自原始 Indoor 网络数据集或 Indoors 地理数据库。

• 输入设施点要素参数值必须是符合 Facilities 要素类的 ArcGIS Indoors 信息模型的面要素图层或要素类。 通过在输入图层上进行选择或定义查询，可以将楼层过渡的生成限制为特定设施点。 如果没有选择或定义查询，则该工具将为输入图层上所有设施点中的所有级别生成楼层过渡。

• 过渡单元要素参数值必须是符合 Units 要素类的 Indoors 模型的要素图层或要素类。

  • 过渡单元要素参数用于定义将为其生成过渡的楼层规划区域，例如楼梯和电梯。
  • 如果过渡单元要素参数值是一个要素类，其中包含表示楼梯和电梯类型空间的多边形，请使用楼梯单元表达式和电梯单元表达式参数来标识表示相应类型过渡空间的要素。 在 Indoors 模型中，可以使用 USE_TYPE 字段的值。

• 路径要素参数值必须是符合 PrelimPathways 要素类的 Indoors 模型的折线要素图层或要素类，并且包含用于将由工具处理的空间的初步路径要素。 该工具可将生成的过渡要素捕捉到连接的可路由网络的这些初步路径。

• 目标过渡参数值必须是符合 PrelimTransitions 要素类的 Indoors 模型的折线要素图层或要素类。 将在此处写入新过渡，以用于创建网络数据集。

• 电梯延迟参数通过考虑电梯乘客的预期等待时间，并将延迟值应用于标识的电梯过渡空间中包含的现有路径要素值，从而改善路线选择和过渡时间计算。

  • 与步行相比，如果使用默认 Indoors 网络数据集模板，则包含预期电梯延迟可能会在轮椅模式下产生不同的结果。 这是因为电梯延迟可能会缩短使用楼梯的路径的总计算行驶时间。

• 该工具将在具有所选类型的多边形的中心找到每个楼层上路径要素值的最近折点。 将在此折点处的楼层之间创建垂直线。 生成的过渡要素的起始和结束折点的 z 值将与路径要素的 z 值匹配。

• 将针对所有输出过渡要素计算 LENGTH_3D 属性。 对于楼梯类型的过渡，其因子增加三倍，以反映走楼梯的途经时间。 如有必要，可以手动重新计算这些值。

  注：

  如果手动编辑过渡要素，则将重新计算该值，从而在进行路径选择时准确地反映行进时间。

• 对于输出过渡要素，将使用默认值填充以下属性：

  • TRANSITION_RANK
  • TRANSITION_TYPE
  • TRAVEL_DIRECTION

  注：

  在创建网络数据集之前，可以根据需要手动编辑这些值。

参数

对话框

标注	说明	数据类型
输入设施点要素	表示一个或多个设施点的输入面要素。 在 Indoors 模型中，此项将为 Facilities 图层。 系统将仅处理这些要素表示的设施点。	Feature Layer
过渡单元要素	表示设施点中的过渡空间的输入面要素。 在 Indoors 模型中，此项将为 Units 图层。	Feature Layer
路径要素	表示初步路径的输入折线要素。 新的过渡要素将捕捉到这些折线要素。 在 Indoors 模型中，此项为 PrelimPathways 图层。	Feature Layer
目标过渡	将使用新过渡更新的现有要素类或图层。 在 Indoors 模型中，此项将为 PrelimTransitions 图层。	Feature Layer
电梯延迟 (可选)	平均电梯过渡时间。 电梯乘客预期等待进入和离开电梯所花费时间的一半，以秒为单位。 使用此参数可以改善路径选择和过渡时间计算。 该值必须等于或大于零。	Long
删除现有过渡 (可选)	指定在创建新的过渡要素之前，是否将删除所选过渡空间中的现有过渡要素。 如果不使用此参数，则已更新的过渡值将包含现有过渡要素和新创建的过渡要素。 选中 - 将删除现有过渡要素。 这是默认设置。 未选中 - 将不删除现有过渡要素。	Boolean
楼梯单元表达式 (可选)	一个 SQL 表达式，用于定义表示基于台阶的过渡的过渡单元要素值，例如楼梯和自动扶梯。	SQL Expression
电梯单元表达式 (可选)	一个 SQL 表达式，用于定义表示基于提升的过渡的过渡单元要素值，例如电梯。	SQL Expression

派生输出

标注	说明	数据类型
已更新的过渡	已更新的目标过渡图层。	Feature Class

Python

arcpy.indoors.GenerateFloorTransitions(facility_features, transition_unit_features, pathway_features, target_transitions, {elevator_delay}, {delete_existing_transitions}, {stairway_unit_exp}, {elevator_unit_exp})

名称	说明	数据类型
facility_features	表示一个或多个设施点的输入面要素。 在 Indoors 模型中，此项将为 Facilities 图层。 系统将仅处理这些要素表示的设施点。	Feature Layer
transition_unit_features	表示设施点中的过渡空间的输入面要素。 在 Indoors 模型中，此项将为 Units 图层。	Feature Layer
pathway_features	表示初步路径的输入折线要素。 新的过渡要素将捕捉到这些折线要素。 在 Indoors 模型中，此项为 PrelimPathways 图层。	Feature Layer
target_transitions	将使用新过渡更新的现有要素类或图层。 在 Indoors 模型中，此项将为 PrelimTransitions 图层。	Feature Layer
elevator_delay (可选)	平均电梯过渡时间。 电梯乘客预期等待进入和离开电梯所花费时间的一半，以秒为单位。 使用此参数可以改善路径选择和过渡时间计算。 该值必须等于或大于零。	Long
delete_existing_transitions (可选)	指定在创建新的过渡要素之前，是否将删除所选过渡空间中的现有过渡要素。 如果不使用此参数，则 updated_transitions 值将包含现有过渡要素和新创建的过渡要素。 DELETE_FEATURES—将删除现有过渡要素。 这是默认设置。 NO_DELETE_FEATURES—将不删除现有过渡要素。	Boolean
stairway_unit_exp (可选)	一个 SQL 表达式，用于定义表示基于台阶的过渡的过渡单元要素值，例如楼梯和自动扶梯。	SQL Expression
elevator_unit_exp (可选)	一个 SQL 表达式，用于定义表示基于提升的过渡的过渡单元要素值，例如电梯。	SQL Expression

派生输出

名称	说明	数据类型
updated_transitions	已更新的目标过渡图层。	Feature Class

代码示例

GenerateFloorTransitions 示例 1（Python 窗口）

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

# Name: Indoors_GenerateFloorTransitions_example1
# Description: Generates floor transition line features for selected unit types without delay

import arcpy

arcpy.indoors.GenerateFloorTransitions(r"C:\Indoors\ExampleCampus.gdb\Indoor\Facilities", 
                                       r"C:\Indoors\ExampleCampus.gdb\Indoor\Units", 
                                       r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimPathways", 
                                       r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimTransitions", 
                                       None, "DELETE_FEATURES", 
                                       "USE_TYPE IN ('Stairs', 'Stairway')", 
                                       "USE_TYPE IN ('Elevator', 'Elevator Cab', 'Elevator Shaft')")

GenerateFloorTransitions 示例 2（独立脚本）

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

# Name: Indoors_GenerateFloorTransitions_example2
# Description: Generates floor transition line features for selected unit types 
#              and adds elevator delay

import arcpy

# Define inputs
facility_features = r"C:\Indoors\ExampleCampus.gdb\Indoor\Facilities"
transition_unit_features = r"C:\Indoors\ExampleCampus.gdb\Indoor\Units"
pathway_features = r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimPathways"
target_transitions = r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimTransitions"
elevator_delay = 20
stairway_unit_exp = "USE_TYPE IN ('Stairs', 'Stairway')"
elevator_unit_exp = "USE_TYPE IN ('Elevator', 'Elevator Cab', 'Elevator Shaft')"

# Run tool
arcpy.indoors.GenerateFloorTransitions(facility_features, 
                                       transition_unit_features, 
                                       pathway_features, target_transitions, 
                                       elevator_delay, 'NO_DELETE_FEATURES', 
                                       stairway_unit_exp, elevator_unit_exp)

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 否
• Standard: 否
• Advanced: 需要 ArcGIS Indoors Pro 或 ArcGIS Indoors Maps 和 3D Analyst