基于Revit二次开发的电气设备族平台的搭建

1、第 7 卷卷 第 4 期Vol 7 No42015 年 8 月Aug220155基于 eviit 二次开开发的电电气设备备族平台台的搭建建钱海马小军来侃（南京工业业大学电气工程与与控制科科学学院院，南京2100000）【摘要】BIMM 技术中中面向电电气设计计的应用用研究相相对较少少，针对这种种情况，以国内外外广泛使使用的 eviit软件件为基础础 ，构建基于 BIIM 的电气气设备族族平台 。对电电气设备备参数化化信息模模型进行行了研究究，利用 eviitAPPI 外部功功能扩展展方式 ，实现 eevitt对象的的访问 、过滤滤、编辑辑与创建建 ，利用 FammilyyAPI 实实现电气气设

2、备族族类型获获取、族创建和和族编辑辑 ，结合 SQLLServeer，对 evvit模模型元素素实现基基于关系系数据库库的数据据存储，该平台实实现电气气设备族族统计 、电气气设备拖拖动和族族属性导导入。通过实际案案例，。验证平台的的可行性性与可靠靠性【关键词】BIM ；IFC 标准；参数化 ；电气设备族 ；API【中图分类类号 】TP33【文献标识识码 】A【文章编号号 】16774 74661（20115）04 00660 05【DOI 】10166670/jcnkii cn111 58223 /tu 201150409引言BIM 技技术在建建筑设计计、结构构计算、建建筑能耗耗分、析 设备管

3、管理虚拟施工等等专业已已取得一一定的研研究成果1 ，然而而目前针针对BIM 技技术中电电气设计计的应用用研究相对较较少 。在 BIMM 应用过过程中 ，所产产生的 BIIM模型有很多多类型 。目前前针对特特定的BIM 软软件平台台已经出现了了一些第第三方BIM 模模型构件件库管理理软件工具2 ，但是 eviit中只只有少量量电气设设备族，难以满足电气工工程设计计的需求求； 电气气设计人人员在建建模，时 需要从从本地族族库载入入想要的的电气设设备族工作效率低下 ； eviit明细细表功能能能实现现具体实实例及其其属性的统计计，。但需要花费费不少时时间来设设置参数数本文基于开开放 IFFC 标准

4、，结合 BIMM 协同设设计过程参考模型型 ，首先先基于 eviit平台台研究电电气设备备参，数化模型分析不同电电气设备备族的共共性与特特性并研究了 BBIM 电气设设备族的的创建方方法与使使用现状状。接着分析 eviitAPPI 两种外外部功能能扩展方方式 ，研究究了 eviit对象象的访问问 、过滤 、编辑辑与创建建等方法法 。然后后研究 Faamilly AAPI 关于族族类型获获取 、族创创建和族族编辑的的方法 。最后后构建基基于 eviit二次次开发的的电气设设备族平平台 ，实现 项目已已加载及及本地电电气设备备族的快快速统计计查询 ，且电电气设备备族可直直接拖动动到项目目中使用用，

5、大大大提高建建模效率率 ； 对于协协同设计计平台下下存储在云端的的项目模模型，通通过本文文开发的的族属性性导入模块可将所所有实例例及其属属性导入入到本地地SQLL Seeverr数据库，并统计出系系统族实实例和构构件族实实例的个个数。本文研研究内容容的技术术路线图图如图1 所示。图 1技术术路线图图1电气设备备参数化化模型建立 BIIM 电气设设备族库库，需要要对项目目全生命命周期电气设计计信息进进行整理理，、按照主要参参数关键属性，结合实实际电气气业务需需要对电电气设备备BIM 模模型的资源进行分分类 ，完成成对 BIMM 模型资资源的通通用化 、系列列化、模模块化整整合 ，保证证在 BIM

6、M 模型族族库中存存储的模模型及 构 件在 实际 设计 过程中 具 有良 好 的 通 用3，同时具备备良好的的可维护护和可扩扩展性 ，适应应建筑电电气设计计领域不不断发展展的需要要 。【作者简介介 】钱海（119911 ），男男，硕士士生 。主要要研究方方向 ：BIMM 技术应应用 。基于 eviit二次次开发的的电气设设备族平平台的搭搭建61电气设备参参数化设设计模型型构件整整理的内内容主2电气设备族族创建与与分析，；要有两方面面一是电气设设备族的的系列化化整理二是电气设备族族的模块块化整理理。以格栅吊灯灯为例，在 eviit基础础上说明明照明设设（1）电气气设备族族的系列列化整理理备族的创

7、建建思路 、其他他参数设设置及创创建过程程。格栅系列化整理理，吊灯族为嵌嵌套族。通过对同一一类电气气设备族族规律性性，21照明设备族族的创建建思路的分析研究究进行合理的的基础建建模可根据模型型主要参数的驱驱动，（1）创建建几何形形体：用公制照照明设备备族样板板创自动生成该该类构件件各类型型尺寸的的模，、用公建灯罩 含吊杆杆吊杆法兰并作为主体体族性等从模型型中剥离离形成系系列化构构件模型型。制常规模型型族样板板创建内内置格栅栅，并作为嵌套套族装电气设备族族的基本本参数是是其基本本性能或或基本在灯罩中 ，并且且运用 “阵列 ”功能 ，将内内置格栅栅沿长技术特性的的标志，、，“” “”4 。电电气设

8、备备族基本本参数系系列化度方向阵列列同时将吊灯灯长度 和和 格栅片片数两个尺寸的基本本依据参数值通过过公式相相关联。是系列化的的首要环环节，。（2 ）吊吊灯类型型设置：根据要求求 ，创建建三种不不同的是进行系列列化设计计的基础础对于一类电电气设备备族，：、吊灯透光类类型上部透光下部透光和和上下部部均透并确定其上上下限 。光。根据遮遮罩的不不同材质质进行设设置。建立电气设设备族的的参数系系列表。先基于模模型构（3 ）添添加照明明设备参参数：照明设备备参数的的设置件的基本参参数 ，形成成该类构构件的参参数系列列，之后增加加用来满足设设备工程程师对灯灯具参数数的要求求，重点配置置其他所需的的属性（、

9、）。6。如类型名称称 编码 关键属属性等电气连接件件和选择择相对应应的光域域网文件件完成电气设设备族的的参数化化建模过过程，22照明设备族族的创建建步骤基于基本， eviit中格格栅吊灯灯族创建建过程主主要有：第 1步，参数 并并充分考考虑到尺尺寸系列列变化可可能对模模型产生生，的影响 通过公公式的方方式描述述其他几几何参数数逐步创建格栅嵌嵌套族；第 2步，创建格格栅吊灯灯族 ；第 3步，完成模型构构件的建建模5 。 之后对对参数系系列表中中的添加照明设设备参数数 ；第 4步，保存并并应用于于项目文文各项逐一生生成模型型，。检查模型造造型是否否正确件。具体创创建过程程如图2所示 。1 所示 。

10、系列化整理理流程如如图图 2 电气设设备模型型构件的的系列化化整理（2）电气气设备族族的模块块化整理理模块化整理理 ，按照照标准化化原则 ，基于于实际电电气，、，业务需要 对已有有的电气气设备模模型进行行拆分整理将电气设备备模型的的部分构构件组合合在一起起，最终形成一系列通用用性较强强的电气气设备模模型单元元。图 3格栅栅吊灯创创建过程程23电气设备族族分析初步整理出出电气设设计中基基本需要要的族有有：消防；端子箱明装 配配电箱暗装 三三管格栅栅荧光灯灯疏散指示灯；三联开关二三孔插座座感烟探测器器感温探测器；火警电话插插孔消防广播消防报警电电；话 消防启启泵按钮钮半球形摄像像机电视插孔电话和网

11、络插孔孔等 4 。3 eviit AAPI方法31 eviit AAPI功能扩展方方式 eviitAPPI 通过两两种方式式扩展 eviit功能能，Exxterr- eviitAPPI62nal CCommmandd和 Exxterrnall Apppliicattionn 。 Exxterrnall Coom-mmandd 实现现外部命命令的功功能 ，使用用外部工工具加载载 ，Ex-terrnall Apppliicattionn 实现现外部应应用的功功能 ，都需需要引用用 eviitAPPIdlll 和 eviitAPPIUII dlll文文件 。 eviitAPPIdlll包含了在数数据

12、库层层控制 eviit的应应用 、文档 、对象象和参数的 方方法，而而 eviitAPPIUII dlll 包含 了在 操作 和 eviit用户户界面层层的所有有自定义义APII 接口 。Exterrnall Coommaand 和 Exxterrnall Apppliicattionn 的实实现方法是不不同的 。Extternnal Commmannd通过过重载 Exee-cuute（）方方法实现现 ，而 EExteernaal AAppllicaatioon 是是通过 On-Staartuup（）和和 OnnShuutdoown（）方方法的配配合使用用 ，才能能实现功功能扩展展 7 。本文

13、使用 IExxterrnall Apppliicattionn 完成电电气设备备族统计计人机界界面面板板的功能能 。族属属性导入入模块不不添加面面板，直直 接 用 外 部工 具 加 载 实 现。使 用 IExxterrnallCommaand完完成电气气设备族族统计及及族属性性导入的的功能。使用 EExteernaal CCommmandd 和 Extternnal Apppliccatiion两种方式进进行编译译与测试试时， eviit eexe 启动后 ，addinn 文件件中的命命令会被被加载。本本文构建建的电气气设备族平台的的 adddin 文件如如下 ：？xmll veersiion

14、 = ”10”enccodiing = ”utff 8” eviitAdddInnsAddIIn TTypee = ”Apppliccatiion ”Namee FammliyyVieews Apppliccatiion /Naame AsseembllyE：viisuaal sstuddio 20110PProjjecttsFaamillyViiewss FaamillyViiewssbin DDebuug FFamiilyVViewws dlll /Asssemmblyy AddIInIdd 0544e0ee25 adcc5 46557 b0ee0 d8331acc1c440c00 /Ad

15、ddInnId FulllClaassNNamee FammilyyVieews CSExtternna-lApp /FuullCClasssNaame VenddorIId ADSSK /VeendoorIdd VenddorDDesccripptioon Auttodeesk，wwwwauttodeeskccom/VVenddorDDesccripptioon/AdddIn / eviitAdddInns32 eviit AAPI 对象访访问中有两种方方式根据据标识来来识别区区分和访问不同同对象。第第一种方方式，只只使用类类名来判判断，能 容容纳 其 它 对象 或 特 定 用 途 的 类，

16、如如：Waall 、Flooor、Connt Foootinng、Ceiilinng 等等系统族族的实例例 。第二二种方式 ，如如果通过过类名无无法分别别出来，需需联合对对象的类别 （Cattegoory）来来判断 。但是 ，门、窗窗、柱等等对象没没有专用用的类来来表示 ，都是 FammilyyInsstannce 的实例 。本文采用CCateegorry 来来判断其其类别，用用枚举型型的BuilttInCCateegorry 来来创建 EllemeentCCateegorryFiilteer对象 。33 eviit AAPI 对象过过滤 eviit平台台中所有有的对象象遍历都都必须要要使用

17、Fill-teereddEleemenntCoolleectoor类，它它提供了了对文档档中的对对象过滤的所有功功能 ，在过过滤操作作时至少少需要添添加一个个过滤条条件，也也可被赋赋予多个个过滤条条件 。添加加过滤条条件后 ，满足条件的的对象集集合立即即就可以以从这个个类访问问 。 e-vvit 可以通通过三种种用法实实现 FFilttereedEllemeentCColllecttor过过滤，过滤的的方法 、条件件、范围围、特点点及实例例如表11 所示 。表 1 FillterredEElemmenttColllecctorr的三种方法法方法一方法二方法三名称构造函数初初步添加快捷添加任意过

18、滤过滤条件过滤条件、快捷方法可可以对文档 指指定视图图中逻辑组合过过滤条特点、并联连续添添加可见对象 指定对对象件任何过滤滤条件集合等进行行过滤多个条件FilteereddEleemenntFilteereddEleemenntCool-OfClaass（Typpe）OfColleectoor 示例lectoor（Doccumeent）Categgoryy（BuiiltIInCateggoryy）WhereePasssessElemeentFFiltter4FamiilyAAPI 方法41加载载族 、创建建族实例例LoadFFamiily（）加加载整个个族和族族所有的的类型或或者标签到项目目中

19、 。文档档类别提提供类似似的方法法 LoaadFaam-iilySSymbbol（），加加载特定定的族标标签 。 LooadFFamiilySSymbbol（）只从族族文件中中加载特特定的族族标签到到项目中中。42族、类类别、族族文档创创建 eviitAPPI 中 Fammilyy Crreattionn 函数可可以创建建和编辑族和族类类型 ，但是 eviitAPPI 不能编编辑系统统族。如如果外部系统统有已存存可用的的数据要要传入到到 eviit族库库中，可以使使用此函函数有效效地实现现。（1）获取取族类别别FamillyBaase FammilyyCattegoory属性表表示族的的类别

20、，如Colummns、Furrnitturee、Strructturaal FFrammingg、Winndowws。通通过如下代码确确定一个个开放的的 eviit族文文件的族族类别 ：strinng ccateegorryNaame = fammilyyDocc OOwneerFaamilly FamillyCaateggoryy Naame；（2）获取取族参数数基于 eviit二次次开发的的电气设设备族平平台的搭搭建633可以通过族族文档的的OwnnerFFamiily 属性得得到族参参设备族 ，如图 4 右边部部分 。数，代码如如下 ：Familly ffamiily= faamilly

21、Dooc OOwneerFaamilly；Parammeteer pparaam =familly gett_Paarammeteer（BuiiltIInPaarammeteer FFAMIILY_WO K_PPLANNE_BBASEED ）；（3）创建建族文档档由 IsFFamiilyDDocuumennt（）属属性确定定文档是是否是族族文档。如果果文档是是族文档档 ，修改 eviit族文文档 、获取取族类型和参数数可通过过族文档档类别获获取。在在一个项项目文档中编辑一一个已有有族 ，可以以使用文文档类别别的 EdiitFaam-iily （）函函数，编编辑完成成之后 ，使用用 LooadF

22、Famiily（）重重新加载载族到所所有者文文档 。本文文使用 Apppliccatiion NewwFammi-lyyDoccumeent（）创创建一个个新族文文档 ，代码码如下 ：strinng ttempplatteFiileNNamee = C： Doocummentts aand Setttinngs Alll Usserss Apppliicattionn Daata Auttodeesk ST220144Immperriall TTempplattesGenneriic MModeelrftt ；Docummentt faamillyDoocummentt=apppliicatt

23、ionnNeww-FamillyDoocummentt（temmplaateFFileeNamme）；if （nnulll= = faamillyDoocummentt）throww neew EExceeptiion（ CCannnot opeen ffamiily doccu-ment ）；（4）嵌套套族标签签使用Familly SSymbbol从族文档中中过滤族族标签，获取加载到族族中的所所有族标标签。5基于 BBIM 的电气气设备族族平台构构建使用 IEExteernaal AAppllicaatioon 完成添添加电气气项目视视图、电气设设备族统统计两个个模块人人机界面面面板的的功能

24、。族属性导入入模块不不添加面面板，直接用外部部工具加加载实现。图 4电气气设备族族统计项目已加载载的电气气设备族族拖动模模块可以以从已统统计出的的项目电电气设备备族列表表视图中中 ，拖动动相关族族直接放放置于当当前项目目中 ，方便便电气设设计中设设备族的的加载与与使用 ，提高高工作效效率 。52族属属性导入入本模块用外外部命令令方式实实现。将将adddinn 文件放放置于 C：PrrogrramDDataaAuutoddeskk eviitAAddiins 20014 。首先 ，归归纳 eviit20014 系统族族有 ：门、窗窗、柱、屋顶、楼板 、天花花板 、Connt Foootinng、

25、风风管 、风管管附件、管、。，件 管路附附件接着 过过滤出族族实例提取属性插入数据表 。然后 ，找出出模型中中的系统统族和构构件族的的，实例 分分别提取取系统族族实例的的属性和和构件族族实例的的属性。，。最后 分别别插入到到系统族族表和构构件族表表打开 SQQL SServver 20008 数据库库链接 ，保证证外部数数据可以插入入到数据据库中已已建立的的表SysteemFaamilly和8。执行 外外部 命令“FammilyyProoperr-CompoonenntFaamillyties”，族属属性导入入入口位位置如图图5（a）所所示 。插件完成当当前项目目的族属属性数据据插入后后，自动

26、统计出 已已 插入 到数 据库 中的系 统 族实 例 个 数 为141，构构件族实实例的个个数为8813，如如图 55（b ）所所示 。51电气气设备族族统计与与拖动本模块使用用IExxterrnall Coommaand 的继承承类Drra-gAndDDroppCommmannd实现现，使用用 evvitAAPI 过滤器器获取项项目已加加载的电电气设备备族和本本地族库库中电气气设备族的类别 ，并做做相关显显示处理理。笔者者选用电电气项目目文件“某建建筑地下下二层变变电室rvtt”作为案案例 ，对平平台的可行性性和可靠靠性进行行验证。项目已加载载的电气气设备族族统计模模块显示示项目中中所有用用

27、到的电电气设备备族 ，如图 4 左边部部分 。本地地电气设设备族统统计模块块显示本本地族库库中所有有的电气气图 5族属属性导入入入口与与结果查询数据库库系统族族表和构构件族表表。分别别对表SysteemFaamilly 和和表 CCompponeent-Fammilyy 进行行查询 。使用用查询语语句如下下 ：64图 6构件件族表查查询结果果（1）seelecct iinsttancceNaame，cattegooryNNamee，cattegoo-ryNamme ffromm SyysteemFaamilly；（2）seelecct iinsttancceNaame，cattegooryNN

28、amee，cattegoo-ryyNamme ffromm CoompoonenntFaamilly。查询结果如如图6 所示 ，表 SSysttemFFamiily中中有 1141行属性数据据 ，表 CommponnenttFammilyy中有 8133 行属性性数据。通通过对比比之前的的族实例例插入个个数统计计结果可可知，族族属性导导入模块块在对当当前项目目的族属属性数据据进行导导入是可可靠的 。6结语实验结果表表明，基基于 IFFC 标准的的电气设设备族平平台进行项目目相关项项统计、电气设备族族的统计计与拖动动是可行的 ，可以以提高工工作效率率。经过与 SQQL SSeveer数据库查询询

29、结果的的对比，表明族属性性数据导导入功能能是可靠的 。由于 eviitAPPI 数量和和功能随随着版本本的更新越来越越丰富和和完善，短时间内无无法将其其功能充充分发挥 ，因 此 可 以进 一 步 加强 eviitAPPI 的 应 用研究究。参考文献1 李宁宁基于于 BIIM 与与 IFFC 的的混凝土土坝施工工仿真信信息模型型构建方方法研究究 D天天津：天天津大学学 ，20112 2 TaanyeerAlli MMuraat，AouuadGGhasssann MoovinngBeeyonndthhe Foourtth DDimeensiionwwithh ann IFFC-bbaseedSii

30、ngllePrrojeectDDataabasseJAuu-toomattionnin Connstrructtionn，20005，14（1）：155-3223 朱立立红 ，杨鹤鹤标海海量结构构化数据据查询系系统的研研究与实实现JJ计计算机应应用与软软件 ，20114，31（2）：299-322 4 Liipmaan， obberttDeetaiils of thee maappiing bettweeen ttheCIS/22 aand IFCCproduuct dattamoodells fforstruccturral stteellJ EleectrroniicJournnal of

31、 Innforrmattionn Teechnnoloogy inConsttrucctioon 220099（144）：1-135 满庆鹏鹏 ，孙成成双 基于 IFCC 标准的的建筑施施工信息息模型J土土木工程程学报 ，20111，44（S1）：2399-2443 6 来侃，马马小军 ，朱亮亮电气气设备族族在 BIIM 照明设设计中的的应用J电气气应用 ，20115，34（2）：300-344 7 林林良帆 BIMM 数据存存储与集集成管理理研究D上上海：上上海交通大学学 ，20113 8 陆宁宁，马智智亮利利用面向向对象数数据库与与关系数数据库管管IFC 数数据的比比较 J清清华大学学学报

32、 ，20112，52 （6）：836-8842BuilddinggPlaatfoormoof EElecctriicallEquuipmmenttFammilyy bbaseed oon BBIMQian Haii，Ma Xiaaojuun ，Laii Kaan（Colllegee off Ellecttriccal Enggineeeriing andd Coontrrol Sciiencce，Nannjinng TTechh Unniveersiity，Nannjinng 22100000，Chiina）Abstrractt ：Eleectrricaal ddesiign oriientted apppliccatiion re