基于Revit二次开发的独立基础参数化建模方法研究

doi:10.11996/JG.j.2095-302X.2026010194

摘要/Abstract

摘要：

随着建筑信息模型(BIM)技术在工程设计领域的广泛应用，由Revit平台驱动的三维正向设计在上部结构中已形成了较为成熟的解决方案。然而，独立基础作为结构的重要组成部分，其三维建模与出图仍存在效率低、信息完整性差等问题，且因主流的结构分析软件数据接口封闭，直接提取基础数据库文件的配筋信息并同步至Revit构件属性也极具挑战。为此，利用Revit API与MVVM架构模式，提出了一种基于AutoCAD图层与字段识别的独立基础参数化建模算法。将YJK结构分析软件生成的基础平面布置与配筋标注图导入至Revit平台，通过图层识别方法计算基础中心定位坐标与平面尺寸，再根据基础与配筋标注的相对位置关系，建立两者间的匹配逻辑，进而利用字段识别获取基础对应标注中的编号、高度及配筋信息，并将其自动写入模型的族属性中。此外，通过提取模型属性与几何面参照，还实现了基础尺寸与配筋自动标注等功能。最后，以某冷柜自制厂房为工程案例开展了独立基础参数化建模及出图应用实践，并与常规方法进行了对比。结果表明，该算法能显著提高独立基础三维建模与标注出图效率，且对PKPM软件导出的计算文件具有良好的适配性。

关键词: 独立基础, 参数化建模, Revit, 二次开发, 建筑信息模型

Abstract:

With the widespread application of Building Information Modeling (BIM) technology in the field of engineering design, the Revit platform-driven 3D forward design has developed into a relatively mature solution for superstructure. However, as a critical structural component, isolated foundations still face challenges such as low efficiency and poor information integrity in 3D modeling and drawing generation. Moreover, due to the closed data interfaces of mainstream structural analysis software, it is extremely challenging to directly extract reinforcement information from fundamental database files and synchronize to the properties of Revit elements. To address this limitation, a new parametric modeling algorithm for isolated foundations based on AutoCAD layer and text recognition was proposed, utilizing the Revit Application Programming Interface (API) and the Model-View-ViewModel (MVVM) design pattern. By importing foundation layout and reinforcement annotation drawings generated by structural analysis software (e.g., YJK) into Revit, the algorithm calculated the center coordinates and planar dimensions of foundations using layer-recognition methods. Then, a matching logic was established between foundations and reinforcement annotations according to their relative positions. Subsequently, text recognition was employed to extract the corresponding annotations’ numbering, height, and reinforcement information, which were then automatically written into the family properties of the model. Additionally, the extraction of model attributes and geometric face references enabled automatic annotation of foundation dimensions and reinforcement. Finally, the proposed method was applied to the parametric modeling and drafting of isolated foundations for a self- built cold storage factory and was compared against conventional methods. The results demonstrated that this algorithm significantly improved the efficiency of three-dimensional modeling and annotation drawing for isolated foundations, while exhibiting excellent compatibility with calculation files exported from PKPM software.

Key words: isolated foundation, parametric modeling, Revit, secondary development, building information modeling

中图分类号:

TU17

邓鹏, 谭文正, 罗慧明, 李帅, 杨斌. 基于Revit二次开发的独立基础参数化建模方法研究[J]. 图学学报, 2026, 47(1): 194-203.

DENG Peng, TAN Wenzheng, LUO Huiming, LI Shuai, YANG Bin. Research of parametric modeling methods for isolated foundation based on Revit secondary development[J]. Journal of Graphics, 2026, 47(1): 194-203.

图/表 14

表1 Revit API中的部分方法与功能

Table 1 Partial methods and their functions in Revit API

方法名称	功能
GetOutline()	获取边界框的最大和最小坐标点
ZoomAndCenterRectangle()	居中缩放显示当前视图指定区域
NewFamilyInstance()	创建新的Revit族实例
Set()	修改Revit元素参数值
Delete()	删除指定的Revit元素
get_Geometry()	获取Revit元素的几何信息
NewDimension()	创建线性尺寸标注
Create()	创建结构基础标记

图1 Revit二次开发流程

Fig. 1 Revit secondary development process

图2 MVVM架构逻辑

Fig. 2 MVVM architecture logic

图3 独立基础类型((a) 锥形单阶；(b) 阶形单阶；(c) 阶形二阶；(d) 阶形三阶)

Fig. 3 Isolated foundation types ((a) Tapered single-stage; (b) Stepped single-stage; (c) Stepped two-stage; (d) Stepped three-stage)

图4 二阶独立基础几何计算简图

Fig. 4 Simplified geometric calculation diagram for two-stage isolated foundation ((a) θ=0; (b) 0<θ<π/2)

图5 平法配筋标注样式((a) 详细标注；(b) 简单标注)

Fig. 5 Reinforcement annotation style based on the Flat Method ((a) Detailed annotation; (b) Simple annotation)

表2 独立基础集中标注内容

Table 2 Isolated foundation centralized annotation content

图6 独立基础模型创建流程

Fig. 6 Isolated foundation model creation process

图7 自制厂房三维模型

Fig. 7 Three dimensional model of self-made factory building

图8 独立基础常规建模方法

Fig. 8 Isolated foundation conventional modeling method

图9 Revit二次开发插件界面

Fig. 9 Revit secondary development plugin interface

图10 独立基础局部建模结果

Fig. 10 Partial modeling results of isolated foundation

图11 独立基础局部标注结果

Fig. 11 Partial annotation results of isolated foundation

表3 不同方法下独立基础建模与标注出图时间/min

Table 3 Modeling and drafting time for isolated foundation under different methods/min

方法	参数化建模			标注出图
方法	模型生成	建模处理	总耗时	标注出图
手动方法	120.0		120.0	90.0
TSRS	1.1	35.0	36.1	90.0
Revit-YJKS	0.8	35.0	35.8	25.0
本文方法	1.2	17.0	18.2	15.0

参考文献 22

[1]	徐照, 李启明. BIM技术理论与实践[M]. 北京: 机械工业出版社, 2020: 11-12.
	XU Z, LI Q M. BIM technology: theory and practice[M]. Beijing: China Machine Press, 2020: 11-12 (in Chinese).
[2]	崔青玉, 孙晗凌, 吴洋. 基于模型数据驱动的城际铁路工程自动化计量研究与实践[J]. 建筑经济, 2023, 44(S2): 319-323.
	CUI Q Y, SUN H L, WU Y. Research and practice of automatic calculation for intercity railway engineering based on model data driven[J]. Construction Economy, 2023, 44(S2): 319-323 (in Chinese).
[3]	张兴军. 基于建筑信息模型的数字化交付在城市轨道交通工程中的应用[J]. 城市轨道交通研究, 2023, 26(7): 236-240, 245.
	ZHANG X J. Application of digital delivery based on BIM in urban rail transit engineering[J]. Urban Mass Transit, 2023, 26(7): 236-240, 245 (in Chinese).
[4]	王海俊, 宦国胜, 沈国华, 等. 信息模型技术在挡土墙设计中的应用与研究[J]. 重庆交通大学学报(自然科学版), 2017, 36(6): 75-79. DOI
	WANG H J, HUAN G S, SHEN G H, et al. Application and research of information model technology in retaining wall design[J]. Journal of Chongqing Jiaotong University (Natural Science), 2017, 36(6): 75-79 (in Chinese).
[5]	YANG X, KOEHL M, GRUSSENMEYER P. Parametric modelling of as-built beam framed structure in BIM environment[C]// 3D Virtual Reconstruction and Visualization of Complex Architectures. Nafplio: The International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences, 2017: 651-657.
[6]	LIU J P, XU C R, WU Z, et al. Intelligent rebar layout in RC building frames using artificial potential field[J]. Automation in Construction, 2020, 114: 103172. DOI URL
[7]	刘世龙, 马智亮. 基于BIM的钢筋骨架语义设计点云自动生成算法[J]. 图学学报, 2021, 42(5): 816-822.
	LIU S L, MA Z L. BIM-based algorithm for automatic generation of semantic as-designed point cloud of reinforcement skeleton[J]. Journal of Graphics, 2021, 42(5): 816-822 (in Chinese).
[8]	朱致远, 牛志伟, 张宇, 等. Revit二次开发在水闸工程挡土墙设计中的应用[J]. 人民长江, 2021, 52(2): 117-121.
	ZHU Z Y, NIU Z W, ZHANG Y, et al. Application of Revit secondary development in retaining wall design of sluice engineering[J]. Yangtze River, 2021, 52(2): 117-121 (in Chinese).
[9]	卞明月, 陈鑫, 谈丽华, 等. 摇摆钢支撑快速建筑信息模型建模技术及其Revit模块开发[J]. 科学技术与工程, 2021, 21(26): 11280-11288.
	BIAN M Y, CHEN X, TAN L H, et al. Rapid building information modeling (BIM) modeling technology for rocking steel truss and its Revit module development[J]. Science Technology and Engineering, 2021, 21(26): 11280-11288 (in Chinese).
[10]	牛立军, 梁燕迪, 王程. 基于Revit二次开发的水利工程BIM正向设计研究[J]. 人民黄河, 2022, 44(3): 155-159.
	NIU L J, LIANG Y D, WANG C. Research on BIM forward design of hydraulic engineering projects based on Revit secondary development[J]. Yellow River, 2022, 44(3): 155-159 (in Chinese).
[11]	陈菁, 余芳强, 易思坤, 等. 基于BIM的施工深化自动出图系统设计与开发[J]. 图学学报, 2023, 44(4): 801-809. DOI
	CHEN J, YU F Q, YI S K, et al. Design and development of automatic drawing system for construction deepening based on BIM[J]. Journal of Graphics, 2023, 44(4): 801-809 (in Chinese). DOI
[12]	陈泽云, 陈鑫, 谈丽华, 等. 基于Revit平台的隔震支座快速建模模块开发与应用[J]. 科学技术与工程, 2024, 24(2): 706-714.
	CHEN Z Y, CHEN X, TAN L H, et al. Development and application of rapid modeling module for isolators based on Revit platform[J]. Science Technology and Engineering, 2024, 24(2): 706-714 (in Chinese).
[13]	LI J, SONG H X, ZHOU Z W, et al. A Revit-Midas/Civil conversion approach for bridge superstructures analysis[J]. Engineering Research Express, 2024, 6(1): 015109. DOI
[14]	张维锦, 陈五琴. 基于Revit的桩基承台自动设计算法[J]. 图学学报, 2019, 40(4): 771-777. DOI
	ZHANG W J, CHEN W Q. Automatic design algorithm of pile foundation cap based on Revit[J]. Journal of Graphics, 2019, 40(4): 771-777 (in Chinese).
[15]	孙祥. 桩基设计计算的BIM应用及有限元分析[D]. 石家庄: 石家庄铁道大学, 2019.
	SUN X. BIM application and finite element analysis of pile foundation design and calculation[D]. Shijiazhuang: Shijiazhuang Tiedao University, 2019 (in Chinese).
[16]	贺林. 基于Revit和Tekla结构基础的BIM模型创建方法研究[D]. 沈阳: 沈阳建筑大学, 2021.
	HE L. Research on BIM model creation method based on Revit and Tekla structure foundation[D]. Shenyang: Shenyang Jianzhu University, 2021 (in Chinese).
[17]	贾诗颖. 基于Revit的独立基础参数化设计的研究[D]. 大连: 大连理工大学, 2018.
	JIA S Y. Research on parametric design of independent foundation based on Revit[D]. Dalian: Dalian University of Technology, 2018 (in Chinese).
[18]	王晓宇. 基于RevitAPI的桩基础参数化设计[D]. 大连: 大连理工大学, 2020.
	WANG X Y. Parametric design of pile foundation based on RevitAPI[D]. Dalian: Dalian University of Technology, 2020 (in Chinese).
[19]	苗雨轩. 基于Revit的条形基础参数化设计[D]. 大连: 大连理工大学, 2021.
	MIAO Y X. Parametric design of strip foundation based on Revit[D]. Dalian: Dalian University of Technology, 2021 (in Chinese).
[20]	李浩然. 基于Revit的筏形基础参数化设计的研究[D]. 大连: 大连理工大学, 2021.
	LI H R. Research on parametric design of raft foundation based on Revit[D]. Dalian: Dalian University of Technology, 2021 (in Chinese).
[21]	Autodesk Asia Pte Ltd. Autodesk Revit二次开发基础教程[M]. 上海: 同济大学出版社, 2015: 5-10.
	Autodesk Asia Pte Ltd. Autodesk Revit secondary development basic tutorial[M]. Shanghai: Tongji University Press, 2015: 5-10 (in Chinese).
[22]	SMITH J. WPF apps with the Model-View-ViewModel design pattern[J]. MSDN Magazine, 2009, 24(2): 72-81.