Available for an ArcGIS organization licensed with the Indoors extension.
描述
用于创建或更新垂直连接楼层的过渡线要素。
所选空间(单位)面用于在建筑物楼层(级别)之间生成垂直线。这些过渡要素将与路径要素结合使用,以生成用于路径选择的网络。
使用方法
输入设施点要素参数必须是符合 Facilities 要素类的 Indoors Model 的要素图层或要素类。通过在输入图层上进行选择或定义查询,可以将楼层过渡的生成限制为特定建筑物。如果没有选择或定义查询,则该工具将为输入图层上所有建筑物中的所有楼层生成楼层过渡。
过渡单元要素参数必须是符合 Units 要素类的 Indoors Model 的要素图层或要素类。
- 过渡单元要素参数用于定义应为其生成过渡的楼层规划区域,例如楼梯和电梯。
- 如果过渡单元要素是一个要素类,其中包含表示楼梯和电梯类型空间的面,或者包含不应生成过渡的其他空间,请使用楼梯单元表达式和电梯单元表达参数来标识表示相应类型过渡空间的要素。在 Indoors Model 中,可以使用 USE_TYPE 字段的值。
输入路径要素参数必须是符合 PrelimPathways 要素类的 Indoors Model 的折线要素图层或要素类。该工具可将新的过渡要素捕捉到连接的可路由网络的这些初步路径。
目标过渡参数必须是符合 PrelimTransitions 要素类的 Indoors Model 的现有折线要素图层或要素类。将在此处写入新过渡,以用于创建网络数据集。
电梯延迟参数通过考虑电梯乘客的预期等待时间,并将延迟值应用于标识的电梯过渡空间中包含的现有路径要素,从而改善路线选择和过渡时间计算。
- 与步行相反,如果使用默认 Indoors 网络数据集模板,则包含预期电梯延迟可能会在轮椅模式下产生不同的结果。这是因为电梯延迟可能会缩短使用楼梯的路径的总计算行驶时间。
该工具将在具有所选类型的面的中心找到每个楼层上路径要素的最近折点。将在此折点处的楼层之间创建垂直线。新过渡要素中起始和结束折点的 z 值将与路径要素的 z 值匹配。
将针对所有输出过渡要素计算 LENGTH_3D 属性。对于楼梯类型的过渡,其因子增加三倍,以反映走楼梯的途经时间。如有必要,可以手动重新计算这些值。
注:
如果手动编辑过渡要素,则将需要重新计算该值。
对于电梯类型的过渡,ACCESS_WHEELCHAIR 字段值将设置为 TRUE。对于楼梯类型的过渡,该值将设置为 FALSE。
对于输出过渡要素,将使用默认值填充以下属性:
- ACCESS_PEDESTRIAN
- TRANSITION_RANK
- TRANSITION_TYPE
- TRAVEL_DIRECTION
注:
在创建网络数据集之前,可以根据需要手动编辑这些值。
语法
GenerateFloorTransitions(facility_features, transition_unit_features, pathway_features, target_transitions, {elevator_delay}, {delete_existing_transitions}, {stairway_unit_exp}, {elevator_unit_exp})
参数 | 说明 | 数据类型 |
facility_features | 表示一个或多个建筑物的输入面要素。在 ArcGIS Indoors Model 中,此项将为 Facilities 图层。该工具将仅处理这些要素表示的建筑物。 | Feature Layer |
transition_unit_features | 表示建筑物中的过渡空间的输入面要素。在 ArcGIS Indoors Model 中,此项将为 Units 图层。 | Feature Layer |
pathway_features | 表示初步路径的输入折线要素。新的过渡要素将捕捉到这些折线要素。在 Indoors Model 中,此项将为 PrelimPathways 图层。 | Feature Layer |
target_transitions | 将使用新过渡来更新现有要素类或图层。在 ArcGIS Indoors Model 中,此项将为 PrelimTransitions 图层。 | Feature Layer |
elevator_delay (可选) | 平均电梯过渡时间。电梯乘客预期等待进入和离开电梯所花费时间的一半,以秒为单位。使用此参数可以改善路径选择和过渡时间计算。该值必须等于或大于零。 | Long |
delete_existing_transitions (可选) | 指定在创建新的过渡要素之前,是否将删除所选过渡空间中的现有过渡要素。如果不使用此参数,则 updated_transitions 将包含现有过渡要素和新创建的过渡要素。
| Boolean |
stairway_unit_exp (可选) | 一个 SQL 表达式,用于定义表示基于台阶的过渡的过渡单元要素,例如楼梯和自动扶梯。 | SQL Expression |
elevator_unit_exp (可选) | 一个 SQL 表达式,用于定义表示基于提升的过渡的过渡单元要素,例如电梯。 | SQL Expression |
派生输出
名称 | 说明 | 数据类型 |
updated_transitions | 已更新的目标过渡图层。 | 要素类 |
代码示例
以下 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 函数。
# 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