ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

WEC-Sim 安装教程与快速上手:3 步跑通第一个波浪能仿真示例

WEC-Sim 安装教程与快速上手:3 步跑通第一个波浪能仿真示例 WEC-Sim 安装教程与快速上手3 步跑通第一个波浪能仿真示例【免费下载链接】WEC-SimWave Energy Converter Simulator (WEC-Sim), an open-source code for simulating wave energy converters.项目地址: https://gitcode.com/gh_mirrors/we/WEC-SimWEC-SimWave Energy Converter Simulator是一款基于 MATLAB/Simulink 的开源波浪能转换器时域仿真工具。本指南带你 3 步完成环境配置、跑通 RM3 浮标示例并找到可调参数的位置适合首次接触 WEC-Sim 的新用户。项目概览WEC-Sim 能做什么用 Simscape 物理网络搭建波能装置浮体、铰链、PTO 功率装置、系泊在时域里模拟波浪激励下的装置运动与发电过程支持规则波与不规则波PM、JONSSPIRAP 等谱型激励可叠加线性水动力卷积积分CIC计算提供 BEMIO 预处理器把 WAMIT、NEMOH、Aqwa、Capytaine 等边界元方法BEM一种频域水动力学求解方法的结果转成 WEC-Sim 可读的*.h5水动力数据自带 RM3点吸收式浮标和 OSWEC摆式振荡水坝两个即开即用的完整算例外加一组 MATLAB 单元测试。WEC-Sim 获取与环境准备WEC-Sim 是 MATLAB 代码运行前请确认你的 MATLAB 装有Simulink、Simscape、Simscape Multibody四个工具箱官方支持最近 4 个 MATLAB 版本。在 MATLAB 命令窗口输入ver即可查看已安装工具箱。准备好后把仓库克隆到本地git clone https://gitcode.com/gh_mirrors/we/WEC-Sim仓库里含较大的.h5水动力数据文件如果拉取后文件内容异常需要先安装 Git LFSgit lfs install快速上手3 步跑通第一个示例第 1 步把 WEC-Sim 加入 MATLAB 路径在 MATLAB 中把当前目录切换到仓库根目录然后运行addWecSimSource脚本它会把source/及子目录全部加入 MATLAB 搜索路径。之后输入path确认能看到…/WEC-Sim/source说明路径添加成功。如果希望每次启动 MATLAB 自动加载可以照 官方文档 的方法把内容写进startup.m。第 2 步打开 RM3 算例目录在命令窗口执行cd examples/RM3。这个算例模拟一个双体点吸收式浮标RM3包含几何文件、水动力数据和 Simulink 模型开箱即跑。你也可以换成cd examples/OSWEC体验摆式振荡水坝模型。第 3 步运行 wecSim直接输入wecSim并回车。运行后你会看到MATLAB 内弹出 SimMechanics 物理模型窗口浮体随波浪起伏、绕铰链摆动的三维动画运行结束后自动生成若干结果图浮体位移、响应谱等由算例目录里的userDefinedFunctions.m绘制若想自检安装是否完整可回到仓库根目录运行wecSimTest它会执行一组单元测试并在命令窗口打印结果表格。WEC-Sim 目录地图新手先看哪些目录目录 / 文件作用新手关注点examples/可直接运行的示例RM3、OSWEC以及 BEMIO 各 BEM 软件算例⭐ 从这里开始source/核心代码对象类objects/、函数functions/、Simulink 库lib/⭐ 理解原理时看tutorials/RM3 与 OSWEC 的教学算例含谱数据与波浪数据文件想换个工况试试tests/MATLAB 单元测试与回归测试验证代码改动没破坏功能docs/完整文档源文件RST 格式含安装、工作流、高级特性章节遇到问题的第一站addWecSimSource.m一键把source/加入 MATLAB 路径⭐ 安装时必用wecSimTest.m测试主脚本可逐开关选择要跑的测试套件自检安装用4 个关键文件导读examples/RM3/wecSimInputFile.m—— 整个算例的配置文件也是你日后最常改的文件。它按对象方式定义仿真时长、波浪条件、浮体质量惯量、PTO 刚度阻尼等文件名必须是wecSimInputFile.m且放在算例目录下。source/wecSim.m—— 仿真入口。它读取输入文件、启动对应 Simulink 模型.slx跑完再调用后处理正常情况下你只需运行它无需修改。examples/RM3/userDefinedFunctions.m—— 后处理与绘图脚本定义运行结束后画哪些图。想自定义结果图时改这里。source/objects/—— 各类对象类的实现如waveClass.m波浪、bodyClass.m浮体、ptoClass.m功率装置。输入文件里写的属性就是在这里定义的想知道某个参数能取什么值就来这里查。参数调整指南改哪里、影响什么所有工况参数集中在算例目录的wecSimInputFile.m中修改改完重新运行wecSim即可生效。建议从以下四处入手波浪条件waves.height波高米和waves.period周期秒控制激励强度。文件里已用注释给出规则波、PM/JONSSPIRAP 谱不规则波等多种写法把注释打开、对应行注释掉就能切换海况。仿真时长simu.endTime是总时长simu.rampTime是波浪从 0 爬升到设定幅值的时间simu.dt是时间步长。研究瞬态响应时可调长endTime追求速度时可将simu.mode改为accelerator加速求解。PTO 参数pto(1).stiffness与pto(1).damping控制功率装置的刚度与阻尼直接决定装置吸能效率是做控制策略或参数扫掠时最关键的旋钮。浮体质量属性body(i).mass与body(i).inertia定义每个浮体的质量与转动惯量mass equilibrium表示自动配平到静水位置换成具体数值则会引入静偏移。注意水动力特性附加质量、辐射阻尼、兴波力不在这个文件里改它来自hydroData/下的*.h5文件需要用 BEMIO 从 BEM 软件重新生成几何形状则对应geometry/下的*.stl网格文件。下一步WEC-Sim 进阶方向把 RM3 算例的规则波切换成不规则波对比simu.stateSpace状态空间求解选项体会不同求解方式的效率差异用 BEMIO 章节 介绍的流程为自己的几何生成*.h5水动力文件并搭建新算例结合 tests/ 里的回归测试方法为自己修改过的模型建立改动前后结果一致性检查。【免费下载链接】WEC-SimWave Energy Converter Simulator (WEC-Sim), an open-source code for simulating wave energy converters.项目地址: https://gitcode.com/gh_mirrors/we/WEC-Sim创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表