运行作者的破坝验证案例
本页内容
此示例根据作者的固定源构建 DualSPHysics 5.4,将未更改的二维溃坝输入运行 2 秒,并将模拟前沿与作者捆绑的实验坐标进行比较。比较发现差异:MAE 0.2473 m,均方根误差 0.2637 m,最大绝对差 0.3347 m 横跨 14 个撞击前坐标。没有提供科学通过阈值,原始文章的缩放和前端定义也没有经过独立检查。这是一个已执行的验证案例,尚待人类科学审查。
实验参考是Koshizuka and Oka (1996), 不可压缩流体破碎的运动粒子半隐式方法,核科学与工程 123, 421–434。的 官方 DualSPHysics 测试用例文档 描述了撞墙前坝尖的比较。历史论文使用MPS;当前的实现使用 SPH。它不重现2015年DualSPHysics软件论文的历史算法或性能结果。
检索、构建和运行#
使用支持 Git、Python 3、GNU Make、GCC 和 OpenMP 的 Linux 计算机。测试的编译器是 x86-64 Linux 上的 GCC 13.3.0。在具有源文件、构建文件和粒子文件空间的目录中运行这些命令:
python3 bootstrap-dambreak.py --source DualSPHysics
python3 run-dambreak.py --source DualSPHysics --output dam-break-results --wall-seconds 300
python3 compare-dambreak.py \
--gauge dam-break-results/initial/GaugesSWL_Swl_z003.csv \
--experiment 'DualSPHysics/examples/main/01_DamBreak/EXP_X-DamTipPosition_Koshizula&Oka1996.txt' \
--output comparison
引导程序检索提交 ef3721a861fda961f0e2f9ec4cd317b19de99086 来自 作者的存储库。它构建了 CPU 求解器,提供了 GCC 的缺失 cstdint 包括并禁用本例未使用的可选 Chrono、波形发生器和 MoorDyn 组件。它保留上游快速数学设置。模型方程和输入 XML 保持不变。
运行程序使用两个 CPU 线程。如果其第一个 300 秒界限到期,它将保留该输出并从最后一个本机粒子文件恢复一次。在此主机上,初始运行在绑定前大约 1.44 秒达到;重新启动又用了 124.799 秒完成了 2 秒的范围。求解器警告从单精度粒子位置重新启动会带来微小差异。所有比较坐标均由初始、未重新启动的运行覆盖,因此重新启动不会影响报告的比较。更快的主机可能无需重新启动即可完成。
附带的包装器表达与记录的运行相同的命令;完整的干净引导程序尚未单独重播。保留他们的命令日志并 execution.json 当重复这个例子时。
比较可观察到的#
不变的 CaseDambreakVal2D_Def.xml 创建 21,001 个间距为 0.01 m 的颗粒、一个 1 m x 2 m 的水柱和一个 4 m x 3 m 的水箱。它使用重力 9.81 m/s²、人工粘度 0.02、Fourtakas 密度扩散 0.1、Wendland 核和 Verlet 积分。其原生水平 SWL 仪表在前端采样 z=0.03 m.
在执行之前,比较选择了实验坐标,其提供的前方位置最多为3.9,避免与4 m墙壁接触。该线束在这 14 个提供的时间对原始仪表进行线性插值,并将每个差异写入 front-comparison.csv。它报告错误而不发明接受容差。夹具以其提供的坐标比例使用;原始文章标准化和与该标准的一致性仍然是审查要求。确切的原纸人物定位器尚未解决。
可选地块需要以下包 plot-requirements.txt;将它们安装在隔离环境中并添加 --plot 到比较命令。数值比较本身仅使用Python的标准库。存档的 CSV、JSON 和 SVG 显示实际差异;它们不是协议的证据。
归属和组成术语#
求解器源是 LGPL-2.1 或更高版本。上游 GenCase 帮助程序是一个单独的仅二进制组件:它的运行时通知允许未经修改的二进制文件重新分发及其通知,但限制未经许可的源重新分发/修改。该捆绑包不分发帮助程序可执行文件;引导程序检索上游发行版,必须保留其组件通知。实验文本的作者是小什冢 (Koshizuka) 和冈 (Oka);没有找到单独的数据集许可证。该指南链接到它,而不是重新分发该参考文件。生成的解算器量规文件和紧凑比较作为运行证据包含在内。
本机粒子文件、重新启动文件、完整日志和源/构建失败证据仍保留在研究活动中。在将此案例解释为经过验证的预测之前,仍需要进行人类科学审查、原创文章方法检查和空间/时间步长收敛评估。
下载录制文件#
- front-comparison.csv — 与上游纸张相关固定装置的所有 14 个逐点差异。
- comparison.json — 字面数字比较和科学局限性。
- dambreak-comparison.svg — 可编辑的比较/错误图。
- dambreak-comparison.png — 比较预览。
- GaugesSWL_Swl_z003.csv — 本机未重启的模拟前表输出。
- run-record.json — 紧凑的执行、归属和出处记录。
- bootstrap-dambreak.py — 便携式驱动程序或环境/源记录。
- run-dambreak.py — 便携式驱动程序或环境/源记录。
- compare-dambreak.py — 便携式驱动程序或环境/源记录。
- plot-requirements.txt — 便携式驱动程序或环境/源记录。
- GUIDE.md — 便携式驱动程序或环境/源记录。