返回顶部

将 BIM 导入室内数据集 (Indoors)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

可用于具有 Indoors 扩展模块许可的 ArcGIS 组织。

摘要

将要素从 BIM 文件导入符合 ArcGIS Indoors 信息模型的室内数据集。 可使用该工具的输出创建楼层感知型地图和场景，以用于楼层感知型应用程序，以及生成用于路由的室内网络。

使用情况

  • 您可以使用此工具将楼层平面图数据加载到使用创建室内数据集工具创建的室内数据集中，或加载到使用创建室内数据库工具创建的 Indoors 地理数据库中。

  • 源 BIM 数据必须在运行该工具之前进行地理配准。

    了解有关将 BIM 数据添加到 ArcGIS Pro 的详细信息

  • 输入 BIM 楼层平面图面图层参数值将是源 BIM 文件的 Floorplan 数据集中的 Floorplan_Polygon 要素图层。

    • 该工具使用 Floorplan_Polygon 图层构造“楼层”和“单元”要素。
    • 根据输入 BIM 楼层平面图面图层参数值，该工具会访问同一 Floorplan 数据集中的其他图层以构造室内数据集。 “覆盖区”图层用于构造“设施点”要素，而 Floorplan_Polyline 图层用于构造“细节”要素。

  • 目标单元要素、目标详细信息要素、目标楼层要素和目标设施点要素参数必须参考包含符合 Indoors 模型的单元、详细信息、楼层和设施点要素的要素类或要素图层。

    注：

    目标要素必须全部来自同一文件地理数据库、企业级地理数据库或要素服务。

  • 设施点 ID 参数用于为室内数据集中导入的设施要素填充 FACILITY_ID 字段。 在设置此参数时，请牢记以下内容：

    • 不允许输入空格。 可以使用下划线字符替换空格。 例如，将 Building XYZ 改为 Building_XYZ。
    • 要将输入 BIM 数据添加为现有室内数据集中的新设施点，请指定未分配给目标设施点要素中其他设施点的设施点 ID。
    • 要更新现有设施点，请使用目标设施点要素中该设施点要素的 FACILITY_ID 字段值。
      注：

      要更新现有设施点要素，设施点 ID 参数值必须与设施点要素的 FACILITY_ID 字段值匹配，而设施点名称参数值必须与设施点要素的 NAME 字段值匹配。 匹配区分大小写。

  • 设施点名称参数用于为室内数据集中导入的设施要素填充 NAME 字段。

  • 一楼名称参数用于确定建筑物的一楼。 目标楼层要素中每个楼层的垂直顺序、楼层编号和 z 值均派生自此输入。 将向高程小于标识的一楼的任何楼层分配负垂直顺序。

    注：
    • 无需将设置为一楼的楼层导入室内数据集。
    • 此参数仅接受可占用的楼层作为输入。

  • 如果您为目标要素参数设置的位置中存在数据，则会将源 BIM 文件中的“设施点”和“楼层”名称与要素中的“设施点”和“楼层”名称进行比较，以确定要更新的要素。

    • 如果设施点 ID 和设施点名称参数值分别与目标设施要素的 FACILITY_ID 和 NAME 字段值匹配，则将更新设施点要素。
    • 如果源 BIM 文件中楼层要素的 BldgLevel 字段值与目标楼层要素的 NAME 字段值匹配，则楼层要素及其关联的详细信息和单元要素将更新。
    注：

    如果设施点 ID 和设施点名称参数值与现有设施点要素的 FACILITY_ID 和 NAME 字段不匹配，并且 BIM 楼层平面图面不与现有设施点要素相交，则该工具会将 BIM 数据作为具有指定设施点 ID 和设施点名称值的新设施点导入。

  • 楼层平面图面使用类型字段参数定义 Floorplan_Polygon 要素图层中的字段，该字段将用于填充目标单元要素的 USE_TYPE 字段。 如果未提供任何字段，则将使用 Floorplan_Polygon 图层中的 RoomName 字段值。

  • 可以使用以下参数将其他属性从源 BIM 文件中的房间图层映射到目标单元要素的现有字段：

    • 输入 BIM 房间图层参数定义位于源 BIM 文件中建筑数据集中的房间图层。
    • 房间属性映射参数可用于将字段从输入 BIM 房间图层映射到目标单元要素字段。 运行该工具之前，字段必须存在。 建议将源 BIM 房间图层中的字段映射到具有相同数据类型的目标字段。

  • 如果以下字段存在于 Units 要素类中且无法使用房间属性映射参数进行映射，则默认情况下会对其进行映射：AREA_GROSS、AREA_NET、AREA_UM、ELEVATION_ABSOLUTE、ELEVATION_RELATIVE、FACILITY_ID、FACILITY_NAME、LEVEL_ID、LEVEL_NAME、LEVEL_NUMBER、NAME、UNIT_ID、USE_TYPE 和 VERTICAL_ORDER。

  • 要导入的楼层参数定义将导入的 BIM 文件中的楼层。 您可以使用此参数在室内数据中添加或更新特定楼层。 如果未填充此参数，则将导入 BIM 文件中的所有楼层。

  • 使用面积测量单位参数可指定“楼层”和“单元”要素类中 AREA_GROSS 字段的单位。

  • 使用允许插入新的重叠设施点参数来防止意外导入冲突的平面图数据。

    • 默认情况下，此参数处于未选中状态。 取消选中此参数时，该工具将测试输入 BIM 楼层平面图面是否与目标设施点要素中的任何现有设施点面相交。 如果检测到相交，该工具将检查指定的设施点 ID 和设施点名称参数值是否与相交设施点要素的 FACILITY_ID 和 NAME 字段值匹配。 如果值匹配，该工具将更新现有设施点。 如果值不匹配，该工具将发出警告消息并停止运行。
    • 选中此参数时，该工具将不会测试输入 BIM 楼层平面图面是否与目标设施点要素中的任何现有设施点面相交。 选中此参数以导入与现有设施点重叠或接触的建筑物。

参数

对话框Python

标注说明数据类型
输入 BIM 楼层平面图面图层

源 BIM 文件中已添加到当前地图的 Floorplan_Polygon 要素图层。

Feature Layer
目标单元要素

符合 ArcGIS Indoors 信息模型并与目标设施点、楼层和详细信息要素位于同一工作空间中的目标单元要素图层、要素类或要素服务。

Feature Layer
目标详细信息要素

符合 ArcGIS Indoors 信息模型并与目标设施点、楼层和单元要素位于同一工作空间中的目标详细信息要素图层、要素类或要素服务。

Feature Layer
目标楼层要素

符合 ArcGIS Indoors 信息模型并与目标设施点、单元和详细信息要素位于同一工作空间中的目标楼层要素图层、要素类或要素服务。

Feature Layer
目标设施点要素

符合 ArcGIS Indoors 信息模型并与目标楼层、单元和详细信息要素位于同一工作空间中的目标设施点要素图层、要素类或要素服务。

Feature Layer
设施点 ID

将分配给输出 Indoors 要素的唯一设施点 ID。 设施点 ID 不能包含空格。

String
设施点名称

建筑物常用名称。

String
一楼名称

建筑物的一楼。 楼层的垂直顺序派生自此输入。 将向高程小于指定的一楼的任何楼层分配负垂直顺序。

String
楼层平面图面使用类型字段
(可选)

Floorplan_Polygon 要素图层中的字段，将用于填充目标单元要素的 USE_TYPE 字段。 如果未提供任何字段，则将使用 Floorplan_Polygon 图层中的 RoomName 字段值。

String
要导入的楼层
(可选)

输入 BIM 文件中将导入目标要素的楼层。 如果未提供楼层，则将导入所有楼层。

String
面积测量单位
(可选)

指定将用于楼层和单元要素类中的面积字段的测量单位。

  • 平方米—面积单位将为平方米。
  • 平方英尺—面积单位将为平方英尺。 这是默认设置。
String
输入 BIM 房间图层
(可选)

来自输入 BIM 文件的建筑数据集的房间图层。 该图层将用于获取扩展字段值，这些值可以使用房间属性映射参数映射到 Units 要素类中的现有字段。

Feature Layer
房间属性映射
(可选)

控制将使用来自输入 BIM 房间图层的字段值填充 Units 要素类中的哪些属性字段。 运行该工具之前，字段必须存在。 建议将输入 BIM 房间图层中的字段映射到具有相同字段类型的 Units 要素类中的字段。

Field Mappings
允许插入新的重叠设施点
(可选)

指定如果在建筑物的楼层平面图和目标设施点要素中的现有设施点要素之间检测到相交，是否将导入来自输入 BIM 文件的建筑物。

  • 未选中 - 该工具将测试输入 BIM 楼层平面图面是否与目标要素中的任何现有设施点面相交。 如果检测到相交，该工具将检查指定的设施点 ID 和设施点名称参数值是否与相交设施点要素的 FACILITY_ID 和 NAME 字段值匹配。 如果值匹配，该工具将更新现有设施点。 如果值不匹配，该工具将发出消息并停止运行。 这是默认设置。
  • 选中此 - 该工具将不会测试输入 BIM 楼层平面图面是否与目标设施点要素中的任何现有设施点面相交。 可以使用此选项导入与现有设施点重叠或接触的建筑物。
Boolean

派生输出

标注说明数据类型
更新单元

更新的目标单元要素。

Feature Layer

arcpy.indoors.ImportBIMToIndoorDataset(in_bim_floorplan_layer, target_unit_features, target_detail_features, target_level_features, target_facility_features, facility_id, facility_name, ground_floor_name, {floorplan_polygon_use_type_field}, {floors_to_import}, {area_unit_of_measure}, {in_bim_rooms_layer}, {room_properties_mapping}, {allow_insert_new_facility})
名称说明数据类型
in_bim_floorplan_layer

源 BIM 文件中已添加到当前地图的 Floorplan_Polygon 要素图层。

Feature Layer
target_unit_features

符合 ArcGIS Indoors 信息模型并与目标设施点、楼层和详细信息要素位于同一工作空间中的目标单元要素图层、要素类或要素服务。

Feature Layer
target_detail_features

符合 ArcGIS Indoors 信息模型并与目标设施点、楼层和单元要素位于同一工作空间中的目标详细信息要素图层、要素类或要素服务。

Feature Layer
target_level_features

符合 ArcGIS Indoors 信息模型并与目标设施点、单元和详细信息要素位于同一工作空间中的目标楼层要素图层、要素类或要素服务。

Feature Layer
target_facility_features

符合 ArcGIS Indoors 信息模型并与目标楼层、单元和详细信息要素位于同一工作空间中的目标设施点要素图层、要素类或要素服务。

Feature Layer
facility_id

将分配给输出 Indoors 要素的唯一设施点 ID。 设施点 ID 不能包含空格。

String
facility_name

建筑物常用名称。

String
ground_floor_name

建筑物的一楼。 楼层的垂直顺序派生自此输入。 将向高程小于指定的一楼的任何楼层分配负垂直顺序。

String
floorplan_polygon_use_type_field
(可选)

Floorplan_Polygon 要素图层中的字段，将用于填充目标单元要素的 USE_TYPE 字段。 如果未提供任何字段，则将使用 Floorplan_Polygon 图层中的 RoomName 字段值。

String
floors_to_import
[floors_to_import,...]
(可选)

输入 BIM 文件中将导入目标要素的楼层。 如果未提供楼层，则将导入所有楼层。

String
area_unit_of_measure
(可选)

指定将用于楼层和单元要素类中的面积字段的测量单位。

  • SQUARE_METERS—面积单位将为平方米。
  • SQUARE_FEET—面积单位将为平方英尺。 这是默认设置。
String
in_bim_rooms_layer
(可选)

来自输入 BIM 文件的建筑数据集的房间图层。 该图层将用于获取扩展字段值，这些值可以使用房间属性映射参数映射到 Units 要素类中的现有字段。

Feature Layer
room_properties_mapping
(可选)

控制将使用来自输入 BIM 房间图层的字段值填充 Units 要素类中的哪些属性字段。 运行该工具之前，字段必须存在。 建议将输入 BIM 房间图层中的字段映射到具有相同字段类型的 Units 要素类中的字段。

Field Mappings
allow_insert_new_facility
(可选)

指定如果在建筑物的楼层平面图和目标设施点要素中的现有设施点要素之间检测到相交，是否将导入来自输入 BIM 文件的建筑物。

  • NO_ALLOW_INSERT_NEW_FACILITY—该工具将测试输入 BIM 楼层平面图面是否与目标设施点要素中的任何现有设施点面相交。 如果检测到相交，该工具将检查指定的 facility_id 和 facility_name 参数值是否与相交设施点要素的 FACILITY_ID 和 NAME 字段值匹配。 如果值匹配，该工具将更新现有设施点。 如果值不匹配，该工具将发出消息并停止运行。 这是默认设置。
  • ALLOW_INSERT_NEW_FACILITY—该工具将不会测试输入 BIM 楼层平面图面是否与目标设施点要素中的任何现有设施点面相交。 可以使用此选项导入与现有设施点重叠或接触的建筑物。
Boolean

派生输出

名称说明数据类型
updated_units

更新的目标单元要素。

Feature Layer

代码示例

ImportBIMToIndoorDataset 示例 1（Python 窗口）

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

import arcpy
arcpy.indoors.ImportBIMToIndoorDataset('C:/ExampleCampus.rvt/Floorplan/Floorplan_Polygon', 
                                        'C:/Indoors/ExampleCampus.gdb/Indoor/Units', 
                                        'C:/Indoors/ExampleCampus.gdb/Indoor/Details', 
                                        'C:/Indoors/ExampleCampus.gdb/Indoor/Levels', 
                                        'C:/Indoors/ExampleCampus.gdb/Indoor/Facilities', 
                                        'Building_A',
                                        'Building A',
                                        'LEVEL 01',
                                        'RoomName',
                                        ['BASEMENT', 'LEVEL 01', 'LEVEL 02'],
                                        'SQUARE_FEET',
                                        'C:/ExampleCampus.rvt/Architectural/Rooms',
                                       'UNIT_ID "Unit ID" true true false 255 Text 0 0,First,#,Rooms,ObjectId,0,255;'
                                       'NAME "Name" true true false 100 Text 0 0,First,#;'
                                       'NAME_LONG "Long Name" true true false 255 Text 0 0,First,#,Rooms,Department,0,255;LEVEL_ID "Level ID" true true false 255 Text 0 0,First,#;'
                                       'AREA_GROSS "Gross Area" true true false 8 Double 0 0,First,#;'
                                       'HEIGHT_RELATIVE "Relative Height" true true false 8 Double 0 0,First,#,Rooms,SourceHeight,-1,-1',
                                       'NO_ALLOW_INSERT_NEW_FACILITY')
ImportBIMToIndoorDataset 示例 2（独立脚本）

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

# Name: ImportBIMToIndoorDataset_example2.py
# Description: Imports features from a BIM file into the indoor dataset

import arcpy

# Set tool parameters 
in_bim_floorplan_fc = 'C:/ExampleCampus.rvt/Floorplan/Floorplan_Polygon'
arcpy.management.MakeFeatureLayer(in_bim_floorplan_fc, 'in_bim_floorplan_layer')

target_unit_features = 'C:/Indoors/ExampleCampus.gdb/Indoor/Units' 
target_detail_features = 'C:/Indoors/ExampleCampus.gdb/Indoor/Details' 
target_level_features = 'C:/Indoors/ExampleCampus.gdb/Indoor/Levels' 
target_facility_features = 'C:/Indoors/ExampleCampus.gdb/Indoor/Facilities' 
facility_id = 'BUILDING_A'
facility_name = 'Building A'
ground_floor_name = 'LEVEL 01'
floorplan_polygon_use_type_field = 'Category'
floors_to_import = ['BASEMENT', 'LEVEL 01', 'LEVEL 02']
area_unit_of_measure = 'SQUARE_FEET'
in_bim_rooms_layer = 'C:/ExampleCampus.rvt/Architectural/Rooms'
room_properties_mapping = ""
allow_insert_new_facility = 'NO_ALLOW_INSERT_NEW_FACILITY'

# Create field mapping object
room_properties_mapping = arcpy.FieldMappings()
#set target schema
TargetSchema = 'C:/Indoors/ExampleCampus.gdb/Indoor/Units'
room_properties_mapping.addTable(TargetSchema)

# Map the target field "NAME_LONG", using values from "RoomNumber" field from source BIM file
fldMap = arcpy.FieldMap()
fldMap.addInputField(in_bim_rooms_layer, 'RoomNumber')
RoomNumber = fldMap.outputField
RoomNumber.name, RoomNumber.aliasName, RoomNumber.type = 'NAME_LONG', 'Long Name', 'TEXT'
fldMap.outputField = RoomNumber
room_properties_mapping.addFieldMap(fldMap)

# Map the target field "HEIGHT_RELATIVE", using values from "SourceHeight"
fldMap = arcpy.FieldMap()
fldMap.addInputField(in_bim_rooms_layer, 'SourceHeight')
SourceHeight = fldMap.outputField
SourceHeight.name, SourceHeight.aliasName, SourceHeight.type = 'HEIGHT_RELATIVE', 'Relative Height', 'DOUBLE'
fldMap.outputField = SourceHeight
fldMap.addInputField(in_bim_rooms_layer, 'SourceHeight')
room_properties_mapping.addFieldMap(fldMap)

# Run the tool
arcpy.indoors.ImportBIMToIndoorDataset(in_bim_floorplan_layer, target_unit_features, target_detail_features,
                                       target_level_features, target_facility_features, facility_id, facility_name,
                                       ground_floor_name, floorplan_polygon_use_type_field, floors_to_import,
                                       area_unit_of_measure, in_bim_rooms_layer, room_properties_mapping,
                                       allow_insert_new_facility)

环境

当前工作空间

特殊情况

许可信息

  • Basic: 否
  • Standard: 否
  • Advanced: 需要 Indoors

相关主题

  • Indoors 工具箱概述
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息