Dualsphysics安装指南

本章只提供软件下载链接，不提供具体安装包

编写c++程序方式：DualSPHysics

dualsphysics软件项目链接：github网址；项目核心代码：https://dual.sphysics.org/downloads/

如果需要改变或者研究SPH计算方法，建议下载visual studio，选择安装c++编译器组建安装，并且下载cmake和git软件对项目进行本地部署。

⚠️ 注意

• 目前2025年10月10日，最新版本的核心代码为 5.4 版本

• 在GUI软件中选择2d版本进行运算的时候会有bug，程序会停止在初始化进程结束但是不会报错。

• 当采用 bash 运行核心代码的时候会报错，展示GPU的内存过大，导致接口不可用。

• 如果要使用2d方式进行模拟建议采用低版本 5.0 进行模拟，3d 版本还是可以继续使用 5.4 版本

ℹ️ 5.4版本和5.0版本升级比较

• VRes：支持可变分辨率功能

• FlexStruc：支持灵活的结构

• 测量系统

• 粒子输出过滤器

• 来自几何体的 mDBC 法线

• 高级绘图模式

• 支持使用文件定义物理运动的轨迹

• 辅助对象显示入口区域、可变分辨率区域、仪表、粒子过滤器和流量等工具盒的位置大小和方向

• 为 Windows 和 Linux 生成脚本

GUI界面软件：freeCAD

freeCAD下载链接：https://www.freecad.org/downloads.php?lang=zh_CN

freeCAD仅仅提供GUI界面，不提供任何数值分析方法，所以需要添加宏。

⚠️ 注意

• 1. freeCAD版本必须大于0.18

• 2. 如果要使用GPU进行运算需要确保CUDA版本大于12.3

• 3. 如果计算机比较老，报错OpenGL版本过低，经过更行显卡驱动仍未解决可以看 OpenGL强制更新方法

• 4. 如果遇到其他问题可以参考GitHub英文文档

可以点击菜单栏的macro进行查看用户宏路径，该地址为默认软件检索宏的地址。根据需要自行更改

宏安装方式可以分为手动安装和自动安装：

• 手动安装
             手动安装宏（GitHub项目）：下载链接
             解压压缩包到默认软件读取的宏路径上即可

• 自动安装
             点击下载按钮，并且进行筛选，点击 DesignSPHysics 进行下载
  

FreeCAD的插件和路径设置

启动FreeCAD的插件：

启动后界面会多了一个内容，则代表启动成功。在点击右边蓝色圆圈处Setup Plugin,将下载好的二进制文件依次输入到插件设置中。

⚠️ 注意

从 0.8.0 版本开始，DesignSPHysics 不再包含DualSPHysics 二进制文件。这些二进制文件必须单独下载。
安装步骤如下：
1. dualsphysics.zip从DualSPHysics 官方网站下载链接
2. 将文件移动到你所解压的DesignSPHysics文件夹中
3. 提取内容

💡 小提示

• 如果先下载了c++程序的核心代码，可以直接将二进制文件复制到GUIDesignSPHysics文件夹中

后处理可视化软件：paraview/blender

paraview下载地址

blender的作用是动画渲染，将液体渲染成高清动画并且添加泡沫等特效，与仿真数据分析无关，在此不做过多讲述。

具体情况可以参考“VisualSPHysics: advanced fluid visualization for SPH models” 这篇论文，注意由于blender的更新该插件只能在老版本的blender上使用，若有使用需求详细查看论文中的版本，以免下载错误版本。