Community编程与开发github.com

openfoam-simulation

运行开源OpenFOAM有限体积仿真:从自然语言讨论中提取几何、流体和工况参数,生成经过校验的案例文件,在命令行中构建并运行OpenFOAM案例,并将壁面扭矩转化为物理结果(例如Couette流动曲线)。适用于需要免费、无需许可证的CFD仿真场景——如Couette流变仪、通道、搅拌罐,或用户询问M-Star的开源替代方案时。

openfoam-simulation 是什么?

OpenFOAM Simulation 技能提供了一种从自然语言讨论到完整CFD仿真报告的工作流程,它利用开源OpenFOAM求解器(基于有限体积法、GPL许可、C++与MPI)来模拟Navier-Stokes方程,支持Newtonian及多种非牛顿流体模型(Herschel-Bulkley、Bird-Carreau等)。该技能是专有 `mstar-simulation` 和 `palabos-simulation` 技能的开源对应,遵循相同的“讨论→案例→运行→报告”工作流,并以Couette流变仪作为验证示例。它包含7个步骤:1) 用自然语言讨论流体、几何和目标;2) 编写 `case.yaml`(所有参数在一个文件中,带单位,需用户确认);3) 使用 `blockMesh` 生成网格(默认采用楔形扇区模拟无限长Couette单元);4) 构建案例(替换旋转角速度);5) 循环运行(每个剪切速率一次 `simpleFoam` 运行,生成扭矩CSV);6) 后处理(将扭矩转化为应力、剪切速率,验证牛顿流体分析解,绘制流动曲线);7) 输出报告(含验证结果和假设说明)。该技能要求用户确认所有数值,并且首先要运行一个廉价初始案例(粗网格、单一剪切速率)来验证设置。支持的平台包括Debian/Ubuntu Linux上的OpenFOAM v2412,可通过GitHub Copilot CLI发现和执行,但故意不设置 `allowed-tools` 前置元数据,以确保Copilot在执行长时间求解前征求用户许可。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/marcocaggioni/openfoam-skill/tree/HEAD/.github/skills/openfoam-simulation

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 配合 residualControl 1e-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,residualControl p/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)

相关技能