GIBBON

GIBBON

MATLAB生物工程建模与有限元分析开源工具箱

GIBBON是开源MATLAB工具箱,集成图像处理、几何建模和有限元分析功能。支持高级分割、CAD设计、网格生成和晶格结构设计。与TetGen和FEBio等开源软件兼容,为生物工程提供灵活建模环境。适用于复杂几何、多物理场仿真和逆向工程,支持反向有限元分析。

GIBBONMATLAB工具箱生物工程有限元分析图像处理Github开源项目
<img src="https://yellow-cdn.veclightyear.com/0a4dffa0/427569c0-5f31-4b7f-bfe2-8fc36590b8bc.png" href="https://gibboncode.org" alt="GIBBON" width="100%">

引用 GIBBON: DOI

许可证: License

加入聊天: 在 https://gitter.im/GIBBONchat/Lobby 加入聊天

目录

项目概述 <a name="Summary"></a>

GIBBON(几何和基于图像的生物工程附加组件)是一个开源 MATLAB 工具箱,包含一系列图像和几何可视化及处理工具,并与免费开源软件如 TetGen(用于稳健的四面体网格划分)和 FEBio(用于有限元分析)相连接。这种组合提供了一个高度灵活的基于图像的建模环境,并支持高级反向有限元分析。

GIBBON 概览

应用亮点 <a name="Application"></a>

分割 <a name="Segmentation"></a>

GIBBON 提供图像滤波和平滑方法,并有用于 3D 图像分割的图形用户界面(HELP_imx.m)。分割后的图像数据可以转换为 3D 表面模型(DEMO_imx_levelset_surface_compare),然后可以进行网格划分用于有限元分析(HELP_runTetGen)。

<div> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/8a2b29b3-06a1-4507-bb33-a9fa8a6ef21d.gif" width="50%"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/29391920-b22b-44e0-a11a-5964454fee4a.gif" width="25%"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/21d73106-f9b4-4e93-b536-de64912231f3.png" width="15%"> </div>

计算机辅助设计(CAD)工具 <a name="CAD"></a>

使用 GIBBON,可以从常见的基于网格的 CAD 文件(如 STL,HELP_import_STL)导入几何。为了在 MATLAB® 内生成几何,GIBBON 还提供了几种 CAD 风格的命令,如多边形圆角(HELP_filletCurve)、旋转(HELP_polyRevolve)、拉伸(HELP_polyExtrude)以及扫描和放样(HELP_polyLoftLinearHELP_sweepLoft)。简单的几何体,如球体(HELP_geoSphere)、立方体(HELP_quadBox)、柏拉图立体(HELP_platonic_solid)和菱形十二面体(HELP_rhombicDodecahedron)也可以直接使用 GIBBON 创建。

表面网格划分工具<a name="SurfaceMeshing"></a>

2D 多区域三角形网格划分(如 HELP_regionTriMesh2DHELP_multiRegionTriMeshUneven2D),测地线重采样网格(DEMO_geodesic_remeshing),平滑(DEMO_surface_smooth_methods),和表面网格细化(如 HELP_subtriHELP_subTriDualHELP_subQuad),网格类型转换(如 HELP_tri2quadHELP_quad2tri),以及网格对偶计算(HELP_patch_dual)。几何体还可以导出为 STL 格式,用于计算机辅助制造和 3D 打印。

体积网格划分 <a name="Meshing"></a>

多区域域的四面体网格划分(和约束Delaunay剖分)通过与TetGen包的接口实现(HELP_runTetGenHELP_constrainedDelaunayTetGen)。某些几何类型的六面体网格可以直接编码(例如球体HELP_hexMeshSphere、立方体HELP_hexMeshBox和晶格HELP_element2HexLattice)。对于一般输入表面,还可以使用多区域混合四面体-六面体网格划分(例如DEMO_MixedTetHexMeshing)。

<div> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/866c32b0-0702-4a9d-acb8-e88335710a05.gif" width="40%"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/23708752-ae66-4853-90b6-1e591361f925.png" width="40%"> </div>

晶格结构 <a name="Lattice"></a>

生成晶格表面几何的一种方法是使用三周期函数(HELP_triplyPeriodicMinimal)。还实现了将元素描述(如四面体和六面体元素)转换为晶格结构的函数(HELP_element2latticeHELP_element2HexLattice)。这些允许在任意输入几何上创建3D边界适应晶格结构。还支持导出六面体元素,允许对创建的晶格结构进行有限元分析(DEMO_febio_0026_hexlattice_compression)。

<div> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/d33806a6-48b8-416d-a76b-52612fdf3ab3.gif" width="40%"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/b686df34-0442-40dc-a028-76480d45764a.gif" width="40%"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/c6011871-021f-407f-a499-b1c569d04209.gif" width="40%"> </div>

有限元分析 <a name="FEA"></a>

对于有限元分析,GIBBON目前可以链接免费开源软件FEBio或Simulia ABAQUS。FEBio和ABAQUS接口都基于MATLAB®结构。下图显示了在MATLAB®结构中编码材料部分(上排)以及这些组件在FEBio或ABAQUS输入文件中的表示(下排)。通过这种结构到输入文件的转换过程,任何FEBio或ABAQUS功能都可以直接在MATLAB®中编码

<div> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/2f4c7049-4f9e-4727-9c38-e1974f64f2f4.jpg" width="100%"> </div>
FEBio

GIBBON可以用作FEBio的预处理和后处理工具,因为它能够基于代码开发网格、边界条件和输入文件。可以直接基于专用MATLAB®结构导出FEBio文件(HELP_febioStruct2xml)。此外,GIBBON可用于启动和控制FEBio模拟。因此,也可以进行迭代和反向有限元分析(例如基于MATLAB®优化例程)。所有DEMO_febio_...文件都是FEBio演示,例如DEMO_febio_0001_cube_uniaxial是一个简单的单轴加载示例,而DEMO_febio_0042_inverse_FEA_cube_uniaxial是反向有限元分析的示例。

下图展示了扭转杆的大变形分析,源自演示DEMO_febio_0004_beam_twist。其他演示涵盖了拉伸、压缩、剪切、施加力、施加压力、施加位移、弯曲、孔弹性、动态和粘弹性分析、接触和压痕问题、用于预加载分析的多代材料。

<div> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/c8662d7f-6f29-4414-a3ea-454813ad4738.gif" width="40%"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/89de790c-31d8-4d4d-84e7-09bec42c565a.gif" width="40%"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/7192c98f-160d-4ba4-9424-79ffb6747280.gif" width="40%"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/a348f8c8-dba0-4e1d-9342-9269b7d229da.gif" width="40%"> </div> #### Abaqus Abaqus的接口是最近开发的。用户可以查看`HELP_abaqusStruct2inp`来了解输入文件的编码方式。演示`DEMO_abaqus_0001_cube_uniaxial`展示了立方体的单轴加载,包括几何创建、设置Abaqus结构、保存.inp文件、运行作业以及导入结果进行可视化。数据通过`importAbaqusDat`导入MATLAB®,该函数解析Abaqus的`.DAT`文件。

可视化 <a name="Visualization"></a>

GIBBON扩展了MATLAB®的标准可视化功能,增加了3D图像和体素可视化(HELP_im2patchHELP_sliceViewer)、网格几何体(HELP_gpatchHELP_meshView)、有限元模型(HELP_element2patch)以及带颜色映射的矢量数据(HELP_quiverVec)。所有可视化方法都允许在每个图形或坐标轴窗口中使用多个颜色映射。此外,GIBBON提供了自定义图形窗口cFigure,包含模仿CAD行为的3D旋转选项(HELP_vcw)和高质量图形导出选项(HELP_efw)。还通过基于图形窗口的GUI实现了高级图形动画创建和导出功能(HELP_anim8)。

安装 <a name="Installation"></a>

概要

  1. 下载GIBBON
  2. 只需运行:installGibbon.m(位于GIBBON的主文件夹中),并在安装过程中提供FEBio安装位置的链接

详细安装说明

以下步骤将指导您使用installGibbon.m函数进行简化的安装过程<sup>*</sup>

*<sub>如果您更喜欢手动安装,请执行以下操作:1) 将GIBBON文件夹(包括子文件夹)添加到路径并保存路径定义,2) 运行createHelpDemoDocumentation.m以集成帮助和文档,3) 对于第三方软件包:进入_../GIBBON/config_的config文件夹,编辑_FEBioPath.txt_文件,使其包含FEBio可执行文件的完整路径</sub>

1. 获取GIBBON副本

要使用GIBBON,您需要在本地目录中创建一个副本。您可以通过下载并解压最新的zip文件来获取副本,或者使用以下命令克隆GIBBON:git clone https://github.com/gibbonCode/GIBBON.git。您可以将GIBBON文件夹放在计算机的任何位置,但是MATLAB(以及下面列出的第三方软件包)可能对某些位置有文件权限限制,您可能需要解决这些问题<sup>*</sup>

<sup>* 例如,GIBBON的一些功能,如与TetGen和FEBio相关的功能,会定期创建和删除临时文件。因此,MATLAB(和第三方软件包)应对这些文件夹具有完全权限。首先,用户应确保MATLAB对整个GIBBON文件夹(及其子文件夹)具有完全(例如读/写/删除)权限。在某些平台上,第三方软件包可能需要特殊处理。例如,一些OSX用户发现有必要为tetGen或FEBio授予特定的文件权限。比如,对于TetGen相关功能,使用git update-index --chmod=+x path/to/tetgen</sup>

2. 设置第三方软件包

以下是完整功能所需的第三方软件包列表。除了FEBio之外,所有软件包都包含在GIBBON中,用户需要下载并安装FEBio。如果不需要有限元分析(使用FEBio),可以跳过FEBio的安装。

软件包描述是否包含?下载
FEBio <br/> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/01abb6f8-763f-4678-8621-444361437396.png" href="https://febio.org" alt="FEBIO" width="100%">FEBio是一个有限元求解器,在GIBBON中用于所有有限元分析。FEBio的使用在许多DEMO_FEBio...文件中有所展示。推荐使用FEBio 2.5.0或更新版本。FEBio网站
export_fig <br/> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/0325617d-3cd5-44db-974a-31b4409f5fe1.jpg" href="https://github.com/altmany/export_fig" alt="export_fig" width="100%">export_fig有助于导出出版质量的图像(如.png、.jpg、.pdf、.eps),在GIBBON中,它被集成到导出图形小部件efw中,可以直接从cFigure窗口导出此类图像。export_fig还用于导出图像以创建.gif动画,这可以通过GIBBON的anim8函数实现。GitHub上的export_fig页面
TetGen <br/> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/db3d39d7-ff1e-4d0c-a1cd-e15dc093453c.gif" href="http://wias-berlin.de/software/tetgen/" alt="TetGen" width="100px">用于四面体网格划分(可能还包括受约束的3D Delaunay剖分)。例如,请参见HELP_runTetGen.m其他版本:TetGen网站

2. 安装GIBBON

通过运行installGibbon.m,GIBBON、FEBio和export_fig的路径定义将被添加并保存到MATLAB中。帮助和文档也将被集成。完成后,系统会要求您重新启动MATLAB。installGibbon.m可以在GIBBON的主文件夹中找到。

开始使用 <a name="Start"></a>

访问集成帮助

  • 要从MATLAB访问帮助文档,只需输入:gdoc,这将在MATLAB的帮助浏览器中打开GIBBON文档页面。该文档可以搜索,并像MATLAB的其他帮助和文档一样集成。您也可以在"补充软件"下手动找到此页面,如下所示。
  • 要打开特定函数的GIBBON文档,可以使用gdoc <函数名>(类似于MATLAB的doc函数)。例如,要获取im2patch的帮助,使用gdoc im2patch。这将在集成帮助中搜索im2patch并显示结果。
<img src="https://yellow-cdn.veclightyear.com/0a4dffa0/66b5d4c5-ae39-4550-88b2-6c1c0cdade3f.gif" alt="Help integration" width="100%">

在哪里找到函数和可执行的帮助和演示文件

  • lib文件夹包含所有GIBBON的函数。

  • lib_ext文件夹包含由他人开发的外部函数和库。

  • docs文件夹包含帮助和文档文件,以及演示文件,这些文件在"发布"时(使用MATLAB的发布功能)会创建.html文档文件(位于docs/html中),这些文件被集成到MATLAB中。

  • 任何函数functionName的帮助信息源文件名为HELP_functionName,演示的源文件名中包含DEMO_。因此,如果对重现或从帮助和文档中的代码开始感兴趣,只需在MATLAB命令窗口中输入以HELP_DEMO_开头的代码名称,例如,HELP_ind2patch可用于生成ind2patch函数的帮助信息。用户可以通过在命令窗口中输入open HELP_ind2patch来开始编辑文件。通过发布(使用gpublish <HELP_functionName>)HELP_或DEMO_文件,会在docs\html文件夹中创建.html文件。因此,如果用户修改或贡献lib文件夹中的代码并生成相关的HELP_DEMO_文件,新的帮助和文档就会被添加并在网站上呈现。要使新的帮助和文档集成到MATLAB中,请运行createHelpDemoDocumentation函数并重启MATLAB。

  • 许多DEMO_文件都集中于FEBio的使用。例如,DEMO_febio_0001_cube_uniaxial演示了一个简单的立方体受单轴载荷的情况。其他演示则关注不同的载荷类型、单步与多步分析、不同材料和反向分析(例如DEMO_febio_0042_inverse_FEA_cube_uniaxial)。

测试 <a name="Test"></a>

可以通过运行 testGibbon('all','test'); 来测试 GIBBON 的核心功能。使用 testGibbon('demo','test');testGibbon('help','test'); 仅运行演示或帮助文件。

GIBBON 目前使用最新版本的 MATLAB(或最新预发布版)进行开发和测试,并已在 Windows 10、Ubuntu 20.04 和 Mac OS 上进行了测试。GIBBON 的大部分功能与旧版 MATLAB 兼容,特别是 MATLAB R2014a 及更新版本(Delaunay 剖分和工具箱帮助集成等功能已经发生了重大变化)。如果某个特定功能不适用于您的 MATLAB 环境,请告知开发人员(或提出问题)。代码很可能可以轻松修改以适用于您的版本。

GIBBON 的大部分功能不依赖于特殊的 MATLAB 工具箱。但是有些函数确实需要。以下是 GIBBON 中使用的工具箱列表:

  • 图像处理工具箱
  • 统计和机器学习工具箱
  • 符号数学工具箱
  • 曲线拟合工具箱
  • 并行计算工具箱

许可证 <a name="License"></a>

GIBBON 的使用遵循以下许可: License许可证文件可在 GitHub 存储库中找到。

引用 GIBBON <a name="Cite"></a>

如果您在工作中使用了 GIBBON,应引用以下论文: DOI

Moerman, (2018). GIBBON: The Geometry and Image-Based Bioengineering add-On. Journal of Open Source Software, 3(22), 506, https://doi.org/10.21105/joss.00506

贡献 <a name="Contributing"></a>

我们非常欢迎您为 GIBBON 做出贡献,甚至加入开发团队!我们欢迎各种形式的贡献,包括技术内容、文档开发或网站改进。请阅读我们的贡献指南

您也可以通过 Gitter 聊天提出问题并了解更多关于贡献的信息:加入 https://gitter.im/GIBBONchat/Lobby 的聊天

行为准则 <a name="CodeOfConduct"></a>

请参阅 CODE_OF_CONDUCT

路线图 <a name="RoadMap"></a>

请参阅 ROADMAP

编辑推荐精选

Manus

Manus

全面超越基准的 AI Agent助手

Manus 是一款通用人工智能代理平台,能够将您的创意和想法迅速转化为实际成果。无论是定制旅行规划、深入的数据分析,还是教育支持与商业决策,Manus 都能高效整合信息,提供精准解决方案。它以直观的交互体验和领先的技术,为用户开启了一个智慧驱动、轻松高效的新时代,让每个灵感都能得到完美落地。

飞书知识问答

飞书知识问答

飞书官方推出的AI知识库 上传word pdf即可部署AI私有知识库

基于DeepSeek R1大模型构建的知识管理系统,支持PDF、Word、PPT等常见文档格式解析,实现云端与本地数据的双向同步。系统具备实时网络检索能力,可自动关联外部信息源,通过语义理解技术处理结构化与非结构化数据。免费版本提供基础知识库搭建功能,适用于企业文档管理和个人学习资料整理场景。

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

TraeAI IDE协作生产力转型热门AI工具
酷表ChatExcel

酷表ChatExcel

大模型驱动的Excel数据处理工具

基于大模型交互的表格处理系统,允许用户通过对话方式完成数据整理和可视化分析。系统采用机器学习算法解析用户指令,自动执行排序、公式计算和数据透视等操作,支持多种文件格式导入导出。数据处理响应速度保持在0.8秒以内,支持超过100万行数据的即时分析。

使用教程AI工具酷表ChatExcelAI智能客服AI营销产品
DeepEP

DeepEP

DeepSeek开源的专家并行通信优化框架

DeepEP是一个专为大规模分布式计算设计的通信库,重点解决专家并行模式中的通信瓶颈问题。其核心架构采用分层拓扑感知技术,能够自动识别节点间物理连接关系,优化数据传输路径。通过实现动态路由选择与负载均衡机制,系统在千卡级计算集群中维持稳定的低延迟特性,同时兼容主流深度学习框架的通信接口。

DeepSeek

DeepSeek

全球领先开源大模型,高效智能助手

DeepSeek是一家幻方量化创办的专注于通用人工智能的中国科技公司,主攻大模型研发与应用。DeepSeek-R1是开源的推理模型,擅长处理复杂任务且可免费商用。

KnowS

KnowS

AI医学搜索引擎 整合4000万+实时更新的全球医学文献

医学领域专用搜索引擎整合4000万+实时更新的全球医学文献,通过自主研发AI模型实现精准知识检索。系统每日更新指南、中英文文献及会议资料,搜索准确率较传统工具提升80%,同时将大模型幻觉率控制在8%以下。支持临床建议生成、文献深度解析、学术报告制作等全流程科研辅助,典型用户反馈显示每周可节省医疗工作者70%时间。

Windsurf Wave 3

Windsurf Wave 3

Windsurf Editor推出第三次重大更新Wave 3

新增模型上下文协议支持与智能编辑功能。本次更新包含五项核心改进:支持接入MCP协议扩展工具生态,Tab键智能跳转提升编码效率,Turbo模式实现自动化终端操作,图片拖拽功能优化多模态交互,以及面向付费用户的个性化图标定制。系统同步集成DeepSeek、Gemini等新模型,并通过信用点数机制实现差异化的资源调配。

AI IDE
腾讯元宝

腾讯元宝

腾讯自研的混元大模型AI助手

腾讯元宝是腾讯基于自研的混元大模型推出的一款多功能AI应用,旨在通过人工智能技术提升用户在写作、绘画、翻译、编程、搜索、阅读总结等多个领域的工作与生活效率。

AI 办公助手AI对话AI助手AI工具腾讯元宝智能体热门
Grok3

Grok3

埃隆·马斯克旗下的人工智能公司 xAI 推出的第三代大规模语言模型

Grok3 是由埃隆·马斯克旗下的人工智能公司 xAI 推出的第三代大规模语言模型,常被马斯克称为“地球上最聪明的 AI”。它不仅是在前代产品 Grok 1 和 Grok 2 基础上的一次飞跃,还在多个关键技术上实现了创新突破。

下拉加载更多