WEC-Sim 波浪能转换器水动力仿真:把多体动力学与频域边界元接进物理 AI 工作流
新一、简介
波浪能转换器要在 50 年一遇的恶劣海况中生存,同时从不规则海浪中提取能量。物理水池试验的规模与成本决定了它无法覆盖设计空间,这使得可靠时域仿真成为主力工具。WEC-Sim 由美国国家可再生能源实验室(NREL)与桑迪亚国家实验室团队发起,2014 年首次发布,采用 Apache-2.0 许可,源码托管在 GitHub 的 WEC-Sim/WEC-Sim 仓库。仓库创建于 2014 年 6 月 3 日,最近一次推送为 2026 年 10 月 12 日,主语言为 MATLAB,当前约 195 个 star 与 198 个 fork,公开 issue 数量维持在个位数的活跃水平。
它值得单独写一篇深度条目,原因有三层。第一,它是海洋能领域少数达到”事实标准”地位的开源仿真框架:2025 年 OMAE 会议上的一篇综述统计显示,围绕 WEC-Sim 展开或应用它的文献已超过 250 篇,其中大量由外部作者完成;国际海洋能源期刊 2022 年的发展综述同样把 WEC-Sim 的外部应用数量增长列为该工具被广泛接受的主要证据。第二,它的物理内核组织方式对做物理 AI 的人有直接参考价值:频域边界元求解器给出的线性水动力系数,经状态空间实现后进入时域卷积积分,与刚体多体动力学、系泊恢复力、PTO 阻尼一起在同一个 Simulink 模型里联立求解。第三,它已经越出波浪能本身:2025 年 OMAE 的《Beyond Wave Energy》一文系统梳理了它在浮式风机、混合平台等非波浪能方向的拓展,这一点让它从单一领域的专用工具变成了一个通用的海洋浮体多体动力学框架。
二、原理与工作方式
WEC-Sim 的建模思路由官方理论手册明确定义。它采用辐射与绕射方法:频域势流边界元求解器解出速度势,进而给出激励、附加质量、辐射阻尼与自由液面相关的一组线性水动力系数;时域仿真再把这些频域数据卷积回时间轴,与结构动力学联立求解运动方程。
坐标系是全部结果可复现的前提。手册规定正 X 轴对应零度波向(沿 +X 传播),Z 轴竖直向上,Y 轴按右手定则确定;六个自由度按平移在先、转动在后的顺序排列,摇艏(Ry)与艏摇(Rz)分列第五、第六位。单位体系统一为 MKS(米-千克-秒),角度量用弧度,唯独波向用度数表示。
水动力系数的来源有两条路径。主路径是导入外部边界元求解器生成的 *.h5 数据结构,支持 WAMIT、ANSYS Aqwa、NEMOH、Capytaine 四种求解器输出;备选路径是用户手工构造同一结构。读取完成后,WEC-Sim 按理论手册给出的公式对无量纲系数做缩放,还原出有量纲的激励力、附加质量矩阵、辐射阻尼矩阵与静水恢复系数。
时域方程本身是六自由度刚体运动方程,包含激励力与力矩、平均漂移力、辐射力、PTO 力、粘性阻尼力、Morison 元件力、浮力恢复力与系泊力等项。其中辐射项包含附加质量矩阵 A(ω) 与辐射阻尼矩阵 B(ω),两者都是角频率的函数。
流体记忆效应的处理是它的技术核心。手册给出两条路径:卷积积分表示法直接对冲激响应做积分,精度最高但计算量大;状态空间表示法通过实现理论把冲激响应表示成单输入零状态模型,从而以常系数微分方程替代卷积。实现理论部分给出标准做法——对冲激响应的 Hankel 矩阵做奇异值分解,再对奇异值取对数建立状态空间实现,Kühn 1978 年的论文是该算法的标准出处。
波浪激励侧覆盖了从规则波到全方向谱的完整范围。规则波部分给出色散关系与相速度推导;不规则波由大量不同幅值与周期的规则波线性叠加生成,波谱部分覆盖 Pierson-Moskowitz 谱、JONSWAP 谱(含峰值形状参数的表达式),并支持随频率变化的波向与方向扩散。浮力与激励侧另有非线性浮力与 Froude-Krylov 项,粘性侧提供线性阻尼、二次阻力与 Morison 元件。
三、适用边界与前提
WEC-Sim 的适用边界由它的物理假设划定,而这些假设直接决定它能回答什么问题。
最核心的边界是势流假设。边界元求解器求解的是 Laplace 方程,假定流动无粘、不可压、无旋。因此适用于大尺度、高雷诺数、几何相对规则的浮体。当装置细长比大、存在尖锐棱角或处于极浅水域时,势流解的偏差会显著放大,Morison 元件只能部分补偿这类误差。
第二个边界是刚体主导。手册的运动方程以刚体为基线,柔性体通过广义体模态(GBM)扩展,v7.0.0 才把前六个自由度的非线性水动力能力接入柔性体模型。非刚性结构动力学(单自由度等效)属于 2020 年后才引入的扩展特性,成熟度与刚体路径不在同一水平。
第三个边界是 MATLAB 生态依赖。官方入门文档明确列出所需组件为 MATLAB、Simulink、Simscape、Simscape Multibody 四项,并声明仅保证与最近四个 MATLAB 版本兼容;Simulink 库文件按 R2020b 保存以兼容更广版本区间。系泊模块(MoorDyn)、并行工具箱、Simscape Fluids 等属于额外依赖,未随主仓库默认提供。
第四个边界是工程口径。BEM 求解器给出的系数经过缩放后进入时域,缩放公式、坐标系约定、单位体系任一处不一致都会静默产生错误结果——v7.0.0 发布说明中”修复单位差异""修复深水标志位缺陷""修复大 xy 位移下的相位计算”等条目正说明这类问题在真实项目中确实出现过。
四、上手路径
官方入门文档给出了一条四步路径,对应实际使用顺序。
第一步是把源码目录加入 MATLAB 路径,有两种做法:把 source/addWecSimSource.m 的内容复制到新建的 startup.m 并放入 MATLAB 启动目录,使路径在每次启动时自动生效;或者每次手动执行 addWecSimSource,需要清理时执行 removeWecSimSource。使用 Git 大文件存储拉取仓库是必要的,因为水动力数据文件以 *.h5 形式存在仓库中,v7.1.0 的发布说明专门提到把这些 .h5 文件从 LFS 迁移回普通 Git 存储以简化获取流程。
第二步是验证路径,用 path 命令确认 $WECSIM/source 及其子目录已列出。第三步是在 Simulink 库浏览器中刷新,使 WEC-Sim 库可见。第四步是跑通冒烟测试:进入 examples/RM3 目录执行 wecSim,这是参考模型 3 点吸收器算例,会打开 Mechanics Explorer 窗口并输出图表;examples/OSWEC 同样开箱可跑。若出现 git-lfs 报错,说明 LFS 未正确安装,可手动执行 examples/RM3/hydroData/bemio.m 生成所需的 rm3.h5。
算例布局本身也有信息量。examples 下分 BEMIO、OSWEC、RM3 三块,BEMIO 目录按 AQWA、CAPYTAINE、NEMOH、WAMIT 四个求解器分目录存放输入样例,并配有 compareBEMIO.m 做跨求解器对比;source/objects 下是全部类实现,其中 bodyClass.m 约 91 KB、waveClass.m 约 53 KB、responseClass.m 约 53 KB,是代码量最大的三处;source/functions/BEMIO 集中了求解器读取、系数合并、冲激响应计算与谱处理函数,readCAPYTAINE.m、readNEMOH.m、readWAMIT.m、readAQWA.m 四个读取器各自独立。
走通冒烟测试之后还有两件值得先做的事。一是把 waveClass、bodyClass、ptoClass 三个类的手册页读完,它们的属性表就是 WEC-Sim 的输入契约,写批量参数扫描脚本时直接照着属性名填表,比读源码快得多。二是跑一次 tests 目录下的回归测试,wecSimTest.m 与 tests/RegressionTests 能确认当前 MATLAB 版本与库文件处于一致状态,避免把环境问题误判成模型问题。
配套的 WEC-Sim_Applications 仓库是第二步之后的最佳资源,它用三十余个目录覆盖了高级特性的示例:Body-to-Body_Interactions、Cable、Controls、Desalination、End_Stops、Free_Decay、Full_Directional_Waves、Generalized_Body_Modes、Load_Mitigating_Controls、MOST、Mean_Drift、Mooring、Morison_Element、Nonlinear_Hydro、OWC、PTO-Sim、Paraview_Visualization、Passive_Yaw、Variable_Hydro 等。
五、横向对比
在海洋浮体时域仿真这一层,WEC-Sim 的定位相当清晰,它的参照系主要有三类。
第一类是商业水动力软件。商业 BEM 求解器(WAMIT、Aqwa)本身功能更强,能覆盖更多几何与工况,但它们不提供多体动力学、PTO 与控制的联立仿真,也不提供可脚本化的批量运行接口。WEC-Sim 的角色是把这些求解器的输出接进完整装置模型,v7.1.0 的发布说明明确写到 BEMIO 示例已更新并增加了对 Capytaine 输入 NaN 数据的捕获,说明这种”以 BEM 求解器为上游、以 WEC-Sim 为下游”的分工是官方认可的常态。
第二类是同类开源方案。浮式风机领域有 OpenFAST,流体网格领域有 OpenFOAM,两者在各自方向上的成熟度与社区规模都与 WEC-Sim 相当,但三者面对的物理问题不同:OpenFAST 面向风力机尾流与叶片气动弹性,OpenFOAM 面向全体积 CFD,WEC-Sim 面向频域势流水动力与装置级多体动力学。值得注意的是,WEC-Sim 生态内部通过 MOST 扩展吸收了浮式风机能力——官方 MOST 手册说明该扩展使仿真可以覆盖浮式风机与风浪混合平台,并新增 windClass.m、windTurbineClass.m 两个类与 MOST_Lib.slx 库,同时改造了 initializeWecSim、mooringClass 与 postProcessWecSim 以输出风机功率、转子转速、桨距角与机舱加速度序列。
第三类是简化模型与实验数据。势流框架适合装置级概念设计与参数扫描,遇到需要自由液面破碎、飞溅、系泊-浮体强非线性耦合的工况时,CFD 或水池试验仍然是必要的补充手段。
六、基准与数据
WEC-Sim 的可信度主要建立在一条明确的验证与审查链条上,这套链条本身是可直接查阅的证据。
工程验证起点是 2014 年 OMAE 会议论文《Preliminary Verification and Validation of WEC-Sim, an Open-Source Wave Energy Converter Design Tool》,作者团队来自 NREL 与 Sandia,随后 2016 年有 Phase 1 验证测试论文《Numerical Modeling of Experiments》,对应国际水池实验模型的数值复现。
周期性审查由国际海洋能源期刊承担。2020 年《Introducing non-rigid body structural dynamics to WEC-Sim》记录了非刚性结构动力学的引入过程;2022 年《Review of WEC-Sim development and applications》(第 5 卷第 3 期,293–303 页)把相关文献归为特性开发、实验验证、装置建模、控制建模、PTO 与并网建模、新颖应用六个方向;2025 年 9 月《Review of recent WEC-Sim (v6.1) advanced features》对该版块的进阶特性做同类审查。
版本演进在功能层面留下清晰轨迹。v4.2 引入 Morison 元件法向/切向选项、拖曳体、WEC-Sim 并行执行与 PTO 端限位;v4.3 引入直接从 Simulink 运行、Capytaine 输出读取、更精确的高频附加质量计算,并把文档重构为引言、理论、用户、开发四部手册;v4.4 引入缆绳/球铰/球式 PTO 库块、自定义步长求解器修复与多版本文档;v5.0 完成类与属性重构、BEMIO 函数重构、新 PTO-Sim 库与警告/错误标志机制;v6.0 引入属性校验、大 xy 位移选项、产品惯量处理与平均漂移压力积分;v6.1 支持 MoorDyn v2 能力、PTO 扩展特性、NEMOH v3.0 兼容;v7.0.0 是改动量最大的一版,官方统计为关闭 68 个 issue、合并 52 个 PR,特性集中在全方向谱、变水动力、变质量、通用 PTO 关节、QTF 驻波 Newman 近似、柔性体非线性水动力与多波列支持;v7.1.0 继续补上按 IEC 标准处理全方向波、深水标志位缺陷、大 xy 位移相位计算与变水动力配合方向波等修正。
软件发布本身由 Zenodo 记录版本存档,概念 DOI 为 10.5281/zenodo.3924764,v7.0.0 的记录(10.5281/zenodo.16950906)标注资源类型为软件、许可为 Apache-2.0,并列出 31 位署名作者,覆盖 NREL 与 Sandia 两家机构及大量外部贡献者。
七、物理 AI 场景中的用法
对做物理 AI 的人,WEC-Sim 的价值不在于它自身有多强,而在于它提供一个参数化清晰、输出结构规整、可脚本批量运行的物理求解器,适合当数据源与验证环境。
代理模型训练数据是第一个直接用途。WEC-Sim 的输入是结构化的:装置几何与质量、系泊参数、PTO 系数、波谱参数、仿真时长与步长;输出同样是结构化的时序量,包括六自由度位移与速度、激励力、PTO 功率与力矩。这种”输入可枚举、输出可对齐”的形态很适合做参数扫描后训练降阶模型或神经算子,官方应用仓库的 Free_Decay、Multiple_Condition_Runs、Variable_Hydro 等目录正是这种用法的基础设施。
强化学习控制器验证是第二个用途。WEC-Sim 支持直接嵌入 Simulink 控制回路,Controls、Load_Mitigating_Controls、WECCCOMP 三个应用目录分别对应常规控制、载荷缓解控制与控制竞赛算例。控制器在仿真环境中训练后,WEC-Sim 提供带系泊与自由液面效应的物理响应作为验证基准。
工程设计空间探索是第三个用途。批量仿真给出极端响应统计量,用于可靠性评估与疲劳载荷初步筛选,这一流程与参数化有限元分析在代理模型上的做法完全同构,可参考经典求解器成本边界 2026中对”何时必须回到高保真求解器”的判断框架。
数据驱动建模本身已有公开尝试。arXiv 上 2023 年 6 月的《Data-driven modeling of an oscillating surge wave energy converter using dynamic mode decomposition》即以 WEC-Sim 为数据生成器,用动态模态分解从时域响应中提取低阶模态;2020 年 12 月的《Practical Optimal Control of a Wave-Energy Converter in Regular Wave Environments》则在规则波环境下讨论最优控制。
放到整个物理 AI 生态里看,WEC-Sim 承担的是”物理真值生成器”的角色,与流体仿真侧的OpenFOAM 多物理场、结构侧的桥梁结构分析、控制侧的HydroGym 流场控制属于同一类工具。代理建模与降阶合集与数值与求解器合集提供了方法层面的横向参照;神经算子合集与物理 AI 学习路径可用于组织跨领域的学习顺序。
八、不适用场景与失效模式
有几类场景使用 WEC-Sim 会得到不可信结果,需要明确避开。
需要自由液面非线性效应的场景。势流框架不解析破碎、飞溅、波浪增水与内波,重力波陡化这类强非线性现象不在其能力范围内。
需要全体积流场信息的场景。当研究目标涉及内部流动细节、阻流器局部效应、附加质量的物理成因时,频域系数只给出结果不给机理,必须转向 CFD。
需要精确捕获流体阻尼的场景。粘性阻力依靠线性阻尼与二次阻力参数近似,参数取值需要实验标定;未经标定的取值会直接改变系统阻尼比与共振响应。
超长时程与全生命周期场景。WEC-Sim 是时域仿真工具,几十年的疲劳寿命评估需要在设计域上做统计外推,把仿真跑满整个寿命并不现实。
系数来源不一致的场景最需要警惕。不同 BEM 求解器的输出自由度排列、相位约定、参考点选取可能不同,手工拼接多来源系数而不做一致性检查会引入难以定位的偏差。官方仓库提供 combineBEM、normalizeBEM、cleanBEM 等函数处理这类问题,但它们不能替代使用者的物理判断。
软件成熟度本身也是风险项。v7.0.0 与 v7.1.0 仍在持续修复缺陷(包括深水标志位、大位移相位计算、变水动力配合方向波等),且新特性与缺陷修复常在同一批发布中出现,说明接口仍在演进;跨版本复现历史结果时必须锁定版本号与系数文件。
九、版本与口径核对
撰写与复核本文时使用的口径如下,便于后续对齐。
版本状态取自 GitHub Releases 列表:共 12 个发布,最新为 v7.1.0(2026-06-30),此前为 v7.0.0(2025-08-26)、v6.1.2(2025-01-14)、v6.1.1(2024-09-20)、v6.1(2024-09-16)、v6.0(2023-10-20)、v5.0.1(2022-09-28)、v5.0(2022-05-16)、v4.4(2021-10-28)、v4.3(2021-07-22)、v4.2(2020-12-23)、v4.1(2020-07-01)。仓库默认分支为 main,开发在 dev 分支进行,采用 fork 工作流,新特性 PR 提交到 dev 分支,缺陷修复 PR 提交到 main 分支,发布时 dev 合并入 main 并打标签。
许可与归属依据仓库根目录的 COPYRIGHT 文件:版权标注为 2014 年桑迪亚国家实验室与 NTESS,在合同 DE-NA0003525 项下美国政府保留本软件的部分权利,采用 Apache License 2.0;LICENSE 文件为标准 Apache-2.0 全文。GitHub API 对该仓库的许可识别结果为 Apache-2.0,与文件内容一致。
归档引用使用 Zenodo 概念 DOI 10.5281/zenodo.3924764,v7.0.0 版本记录 DOI 为 10.5281/zenodo.16950906;早期版本另有 10.5281/zenodo.7121186(v5.0.1)与 10.5281/zenodo.3924765(v4.1)等记录。
软件与数据获取地址为 https://github.com/WEC-Sim/WEC-Sim ,文档站为 https://wec-sim.github.io/WEC-Sim ,配套应用仓库为 https://github.com/WEC-Sim/WEC-Sim_Applications 。
生态组织 WEC-Sim 在 GitHub 下共 9 个公开仓库,除主仓库外还包括 bemio(28 star)、WEC-Sim_Applications(34 star)、WDRT(11 star)、MoorDyn(12 star,GPL-3.0 许可,为独立仓库的系泊求解器)、WECCCOMP、FOSWEC、MECC、pioneerWEC。
需要说明的口径边界:主仓库之外的应用与教学案例各自维护,引用示例时应当指明具体应用仓库与目录;系泊能力依赖外部 MoorDyn 项目,其版本与许可独立于 WEC-Sim 主仓库。
还有三条核对经验值得记录。其一,版本号与 Zenodo 记录并非一一对应,v7.1.0 的发布说明正文没有附带新的 Zenodo 徽章,概念 DOI 指向版本概念本身,具体构建需另行确认,需要精确引用时应先在 Zenodo 上确认对应记录是否存在。其二,教程目录同时存在 main 与 dev 两套文档站路径,引用文档链接时须写明分支,避免读者拿到与所用版本不一致的接口描述。其三,仓库内 docs/most 目录托管的 MOST 手册来自合作机构 Politecnico di Torino,其许可条款与主仓库的 Apache-2.0 不同并单独声明,引用 MOST 相关内容时应按其独立许可处理。
数据口径方面还有一点:仓库内置算例的 BEM 系数文件属于示例性质,同样存在版本与来源依赖。跨项目复用时应随系数文件一并记录其生成所用的求解器、求解器版本与几何模型,否则复现时无从判断系数是否与当前代码的读取约定一致。
十、参考资料
- WEC-Sim 官方仓库与文档,https://github.com/WEC-Sim/WEC-Sim ,访问于 2026-11-11。
- WEC-Sim 理论手册(docs/theory/theory.rst),仓库内一手文档,含坐标系、单位约定、运动方程、卷积积分与状态空间实现推导。
- WEC-Sim 用户入门手册(docs/user/getting_started.rst),含 MATLAB 依赖清单与四步安装流程。
- WEC-Sim Releases 页面,https://github.com/WEC-Sim/WEC-Sim/releases ,含 v4.1 至 v7.1.0 全部发布说明。
- Ruehl 等,《Preliminary Verification and Validation of WEC-Sim, an Open-Source Wave Energy Converter Design Tool》,OMAE 2014,DOI 10.1115/omae2014-24312。
- Ruehl 等,《Beyond Wave Energy: Applications of the WEC-Sim Open-Source Software》,OMAE 2025,DOI 10.1115/omae2025-157631。
- Ogden 等,《Review of WEC-Sim development and applications》,International Marine Energy Journal,第 5 卷第 3 期,293–303 页,2022,DOI 10.36688/imej.5.293-303。
- Grasberger 等,《Review of recent WEC-Sim (v6.1) advanced features》,International Marine Energy Journal,2025,DOI 10.36688/imej.8.259-263。
- Scriven 等,《Introducing non-rigid body structural dynamics to WEC-Sim》,International Marine Energy Journal,2020,DOI 10.36688/imej.3.55-63。
- Tom 等,《New Developments and Capabilities Within WEC-Sim》,OMAE 2023,DOI 10.1115/omae2023-105030。
- So 等,《Development of PTO-Sim: A Power Performance Module for the Open-Source Wave Energy Converter Code WEC-Sim》,OMAE 2015,DOI 10.1115/omae2015-42074。
- Carrelhas 等,《WEC-Sim wave-to-wire model of a floating oscillating-water-column wave energy converter》,Ocean Engineering,2026,DOI 10.1016/j.oceaneng.2025.123893。
- Zenodo 概念归档,WEC-Sim v7.0.0,DOI 10.5281/zenodo.16950906,概念 DOI 10.5281/zenodo.3924764。
- WEC-Sim 官方 MOST 手册(docs/most),含浮式风机与风浪混合平台耦合说明。
- WEC-Sim_Applications 仓库,https://github.com/WEC-Sim/WEC-Sim_Applications ,含 30 余个高级特性应用目录。
- arXiv 2306.03861,《Data-driven modeling of an oscillating surge wave energy converter using dynamic mode decomposition》,2023。
- arXiv 2012.08049,《Practical Optimal Control of a Wave-Energy Converter in Regular Wave Environments》,2020。
- IEC 62600-2,《Marine energy - Wave, tidal and other water current converters》,海洋能标准系列。
- Cummins,《The Impulse Response Function and Ship Motions》,David Taylor Model Basin 报告,1962。
- Li 与 Yu,《A Synthesis of Numerical Methods for Modeling Wave Energy Converter-Point Absorbers》,Renewable and Sustainable Energy Reviews,2012。