生成楼层过渡 (Indoors)

适用于具有 Indoors 功能许可的门户。​

描述

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

所选空间(单位)面用于在建筑物楼层(级别)之间生成垂直线。这些过渡要素将与路径要素结合使用,以生成用于路径选择的网络。

使用方法

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

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

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

  • 输入路径要素参数必须是符合 PrelimPathways 要素类的 Indoors 模型的折线要素图层或要素类。该工具可将新的过渡要素捕捉到连接的可路由网络的这些初步路径。

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

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

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

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

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

    注:

    如果手动编辑过渡要素,则将需要重新计算该值。

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

    • TRANSITION_RANK
    • TRANSITION_TYPE
    • TRAVEL_DIRECTION

    注:

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

语法

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

已更新的目标过渡图层。

要素类

代码示例

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\Indoors\Facilities", 
                                       r"C:\Indoors\ExampleCampus.gdb\Indoors\Units", 
                                       r"C:\Indoors\ExampleCampus.gdb\PrelimNetwork\PrelimPathways", 
                                       r"C:\Indoors\ExampleCampus.gdb\PrelimNetwork\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\Indoors\Facilities"
transition_unit_features = r"C:\Indoors\ExampleCampus.gdb\Indoors\Units"
pathway_features = r"C:\Indoors\ExampleCampus.gdb\PrelimNetwork\PrelimPathways"
target_transitions = r"C:\Indoors\ExampleCampus.gdb\PrelimNetwork\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: 需要 Indoors

相关主题