OpenFOAM 仿真
OpenFOAM (openfoam.com, ESI/OpenCFD) 是开源有限体积CFD的标准,采用GPL许可证,C++编写,支持MPI。它不是像M-Star或Palabos那样的格子玻尔兹曼代码:它是在网格上求解Navier-Stokes方程的,内置多种粘度模型(牛顿、幂律、Herschel-Bulkley、Bird-Carreau、Cross、Casson),具有 rotatingWallVelocity 边界条件,以及稳态(simpleFoam)和瞬态(pimpleFoam)求解器。扭矩来自 forces 功能对象。本技能是私有 mstar-skill 仓库中 mstar-simulation 技能以及 palabos-simulation 技能的开源对应:相同的工作流程(讨论 → 案例 → 运行 → 报告),相同的Couette示例,但使用不同的求解器——无需许可证席位,没有GUI,没有 .msb 文件。取而代之的是,您需要编写字典文件并从命令行运行求解器。
工作流程(按顺序)
1. 讨论(英语) -> 什么流体,什么几何形状,要测量什么?
2. 编写 case.yaml -> 所有数值放在一个文件中,带单位。展示给用户,获得确认。
3. 网格 -> blockMeshDict:Couette的楔形扇区。使用checkMesh检查。
4. 构建案例 -> 复制模板,替换Omega。无需GUI。
5. 循环/运行 -> 每个剪切速率一次simpleFoam运行,每次运行产生扭矩CSV。
6. 后处理 -> 扭矩 -> 应力,omega -> 剪切速率,流动曲线 + 验证。
7. 报告 -> 图表 + CSV + 假设、已检查项和未验证项。
不要跳过第2步。 与M-Star和Palabos技能同样的规则:如果剪切速率范围、流体模型或几何形状未经确认,仿真就是浪费。如果用户没有指定某个数值,请询问——不要自行捏造一个并埋在字典中。示例中的默认值标注为 default:,必须经过确认。
在这里运行是免费的(无需许可证席位),但并非没有代价:精细分辨率的3D运行会消耗大量CPU时间。默认先进行一次廉价的首次运行(粗网格、单一剪切速率),然后再进行扫描。
1. 讨论——需要获取哪些信息
与M-Star技能相同的检查清单,加上OpenFOAM特有的项目:
几何形状
- 内(旋转)半径
R_i,外(固定)半径R_o,浸入长度L。单位:米。 - 第一个版本是楔形扇区,而不是完整的环形。
OpenFOAM是3D有限体积法,因此Couette单元被建模为一个薄楔形(4°,轴线沿X方向,轴向切片1 mm,轴向1个网格单元),两个扇区面使用
wedge类型面,两个轴向面使用empty类型面。楔形边界条件使得解具有轴对称性:没有泰勒涡,没有端部效应——即理想的无限长Couette单元,与解析扭矩假设完全一致。请明确说明您正在运行哪种设置。完整的3D环形是后续步骤:它会引入端部效应,并且当泰勒数超过临界值 Ta_c ≈ 41.3 时,会产生泰勒涡,使扭矩高于解析层流值,从而破坏验证标准。对于本案例(η = 1 Pa·s, ρ = 1000 kg/m³),整个扫描范围内 Re ≤ 1.8,Ta ≤ 0.9,因此完整的环形也会保持层流——但楔形仍然是更便宜、更清晰的验证方式。
流体——选择一种流变模型,并给出数值
OpenFOAM 具有流变模型下拉菜单,位于 constant/transportProperties 中:transportModel Newtonian; 是验证案例,而 HerschelBulkley、BirdCarreau、Casson、powerLaw、CrossPowerLaw 是内置的 generalisedNewtonian 模型。Herschel-Bulkley 和 Bird-Carreau 是已记录的后续步骤,不是验证案例。两个陷阱:
transportProperties中的粘度是运动粘度nu= η/ρ (m²/s),而不是动力粘度 η。 对于 η = 1.0 Pa·s 和 ρ = 1000 kg/m³,nu = 1e-03—— 不是 1e-06(水的值,η = 1e-3 Pa·s)。本仓库的早期草稿使用了 1e-06,结果扭矩恰好小了1000倍,而速度分布看起来是正确的——牛顿Couette分布与粘度无关,因此速度分布无法捕获这个错误,但扭矩可以。- 非牛顿系数也是运动粘度(
nu0= η0/ρ,k= K/ρ);屈服应力tau0的单位是Pa。在信任非牛顿运行结果之前,请对照模型源代码进行验证。如果用户指定了真实材料,不要自行编造参数:请询问实测流动曲线、流变拟合结果或文献值,或者从牛顿流体开始。
操作条件——扫描参数
- 剪切速率范围和间距,例如 0.1 → 100 s⁻¹,对数均匀分布。
- 网格分辨率:间隙内的网格单元数(默认40,即 dx = 0.125 mm)。更多网格单元 = 更精确的壁面剪切,但成本也更高。
- 运行长度:
simpleFoam按迭代次数运行,而不是秒。endTime 3000配合residualControl1e-8 —— 求解器在收敛时会提前停止(γ̇ = 10 时约需2050次迭代,约2秒)。用于平均扭矩的稳态窗口是moment.dat样本的最后20%。
测量什么
- Couette:旋转柱体上的扭矩 → 剪切应力,旋转速率 → 剪切速率。流动曲线。在运行之前指定结果来自哪个文件(
postProcessing/forces/0/moment.dat,由forces功能对象写入)。
2. 编写 case.yaml
每个仿真对应一个文件,位于 examples/<name>/case.yaml。这是契约:脚本读取它,不会从对话中重新推导数值。模板:examples/couette/case.yaml。在构建之前向用户展示并获取确认。
3. 网格——M-Star隐藏的步骤
OpenFOAM需要网格,这里通过 system/blockMeshDict 使用 blockMesh 构建。Couette网格是一个单一的六面体块:
轴线 = X(圆柱轴线),径向 = Y,楔形在Y-Z平面内张开
总楔形角度 4 度(OpenFOAM 要求 < 5 度),半角 2 度
轴向范围 x = 0..0.001 m,一个网格单元(无轴向变化)
径向:5 mm间隙内40个网格单元,simpleGrading (1 1 1)
面:innerWall, outerWall, back/front(类型 wedge),
left/right(类型 empty)
在求解之前使用 checkMesh 检查:必须报告 Mesh OK.,每侧楔角2°,非正交性为0。一个网格中同时使用 empty 和 wedge 组合在v2412版本中是被接受的(此处已验证);如果未来版本拒绝,请将轴向面改为 symmetry。
扭矩缩放:扇区是60 mm圆柱体上一个4°的1 mm切片,因此
T_full = M_x(扇区) * (360/4) * (0.060/0.001) = M_x * 5400
其中 M_x 是来自 forces 功能对象(作用在 innerWall 上,CofR位于原点,在轴线上)关于X轴的力矩。符号为负(流体阻力抵抗旋转);驱动扭矩为绝对值。
4. 构建案例
OpenFOAM是一组应用程序,而不是一个库:您编写字典文件并运行它们。仓库布局:
bash scripts/install-openfoam.sh # 官方Debian仓库,v2412
source /usr/lib/openfoam/openfoam2412/etc/bashrc
bash scripts/check-setup.sh # simpleFoam, blockMesh, checkMesh, uv
./run-couette.sh # 试运行:仅构建网格 + checkMesh
couette_build.py 将模板(examples/couette/case/)复制到运行目录,并用剪切速率对应的角速度替换 0/U 中的 __OMEGA__:
Omega = gamma * (Ro^2 - Ri^2) / (2 * Ro^2)
边界条件(已验证与v2412教程一致):
innerWall:rotatingWallVelocity,axis (1 0 0),omega constant <Omega>(rad/s),origin (0 0 0)。 模式:采用climbingRod教程中的rotatingWallVelocity。outerWall:noSlip。back/front:wedge;left/right:empty。- 压力:两个壁面均使用
fixedFluxPressure(全壁面情况)。 constant/transportProperties:transportModel Newtonian;nu 1e-03;(见§1 — 运动粘度,非动力粘度)。constant/turbulenceProperties:simulationType laminar;。 v2412读取turbulenceProperties; 较新版本将其重命名为momentumTransport—— 如果您的求解器提示找不到另一个名称,请重命名文件及其内部object。system/fvSolution:SIMPLE配合pRefCell 0; pRefValue 0;(必需:所有边界都是壁面,因此压力需要一个参考单元——否则 simpleFoam 会退出并显示“Unable to set reference cell for field p”),p使用GAMG,U使用smoothSolver,residualControlp/U 1e-8。system/controlDict:simpleFoam,endTime 3000迭代,forces功能对象(patches (innerWall),rho rhoInf; rhoInf 1000;,CofR (0 0 0),writeInterval 5)。v2412写入force.dat和moment.dat(单独文件),而不是forces.dat。
状态:稳态案例已经在此虚拟机(OpenFOAM v2412,2026-11-17)中实际运行过,§6中的牛顿验证通过(γ̇ = 10时解析扭矩误差0.03%——参见 examples/couette/RUN_REPORT.md)。 瞬态 pimpleFoam 变体(case-transient/,用于启动视频)也已运行:约2秒内1000步,收敛到相同扭矩。
非牛顿:更改 transportProperties 中的 transportModel(首先是Herschel-Bulkley,然后是Bird-Carreau)。保持牛顿路径作为默认和验证标准——切勿在未经验证的几何上调试非牛顿模型。
5. 运行
./run-couette.sh --run # 每个剪切速率一次运行,输出在 examples/couette/runs/
# 或者,逐点运行:
python3 couette_build.py --gamma 10 --out runs/gamma_10
cd runs/gamma_10 && blockMesh && simpleFoam
每次运行写入 torque.csv(迭代次数、扇区扭矩、全圆柱扭矩)和 run_info.json(收敛标志、迭代次数、墙钟时间)。如果运行较慢,请先细化网格或缩短运行时间——不要为了加快速度而悄悄改变几何形状。如果运行达到 endTime 而Uz残差未降至1e-7以下,则标记为 converged: false —— 在相信其扭矩之前先进行诊断(检查网格、边界条件、松弛因子)。
6. 后处理——扭矩到流动曲线(Couette)
与M-Star和Palabos技能相同的转换:
内壁面剪切速率: gamma_i = 2*Omega*Ro^2 / (Ro^2 - Ri^2)
内壁面剪切应力: tau_i = T / (2*pi*Ri^2*L)
表观粘度: eta_app = tau_i / gamma_i
对 case.yaml 中指定的稳态窗口(最后20%的样本)内的扭矩进行平均,并报告其标准差作为稳态性检查。
验证标准(新几何的首次运行必须执行)。 首先使用已知粘度的牛顿流体运行,并与解析Couette扭矩进行比较:
T_analytic = 4*pi*L*eta*Omega*Ri^2*Ro^2 / (Ro^2 - Ri^2)
如果仿真扭矩差异超过约10%,则不要继续进行非牛顿流动曲线。停止并诊断:间隙内网格分辨率、nu(运动粘度 vs 动力粘度——见§1)、运行时间/收敛、旋转壁面边界、扭矩缩放。在报告中记录验证数值。couette_post.py 强制执行此标准,并在失败时返回非零退出码。
然后每个扫描点给出一个 (gamma_i, tau_i) 点。绘制 tau vs gamma(双对数)和 eta_app vs gamma,写入 flow_curve.csv,并且——如果用户想要参数——使用 rheofit(Herschel-Bulkley、Carreau等)在单独的步骤中拟合曲线。
7. 报告
每次运行交付:case.yaml(实际运行时的版本)、flow_curve.csv、flow_curve.png,以及一个简短说明,包括几何形状(楔形扇区、角度、间隙内网格单元数)、流体、扫描范围、验证结果、稳态判据以及任何未验证的内容。如果运行失败,请报告求解器日志尾部——不要悄悄地从曲线中删除该点。
使用 GitHub Copilot CLI 开始会话
与 mstar-skill 和 palabos-skill 相同设置:Copilot CLI 在 .github/skills/ 中发现项目技能,本技能也在那里进行了镜像。从仓库根目录开始:
git clone https://github.com/marcocaggioni/openfoam-skill.git
cd openfoam-skill
bash scripts/install-openfoam.sh
bash scripts/check-setup.sh
copilot
然后运行 /skills list(您应该看到 openfoam-simulation),然后:
/openfoam-simulation run the Couette example in examples/couette/case.yaml
本技能故意没有 allowed-tools 前置元数据:Copilot 必须在运行shell命令之前征求许可,尤其是在长时间求解运行之前。如果技能是在会话期间添加的,请先运行 /skills reload。
本技能不做的事情
- 它不会为您安装OpenFOAM,除非通过
scripts/install-openfoam.sh中脚本化的apt方式:您需要一台Debian/Ubuntu机器并拥有sudo权限。 - 在案例针对已安装的OpenFOAM实际运行并通过牛顿验证之前,它不会声称该案例已通过验证。
- 它不会取代M-Star处理罐体、叶轮、多相流或含颗粒流——这些超出v0.1的范围。本仓库是Couette流动曲线,以开放方式完成,作为开放有限体积路径有效的首个证明。
本仓库中的文件
skills/openfoam-simulation/SKILL.md— 本文件。在.github/skills/openfoam-simulation/SKILL.md(GitHub Copilot CLI发现的副本)处字节级镜像。保持两个副本同步——在同一个提交中编辑两者。docs/openfoam-guide.md— 安装、网格、边界条件、非牛顿注释、限制。examples/couette/— 完整的Couette示例:case.yaml、case/(稳态simpleFoam模板)、case-transient/(pimpleFoam启动模板)、couette_build.py、couette_sweep.py、couette_post.py、make_video.py、README.md。- OpenFOAM本身:https://www.openfoam.com (GPL)