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 functionObject。此技能是私有 mstar-skill 儲存庫中 mstar-simulation 技能與 palabos-simulation 的開源對應方案:採用相同的「討論 → 案例 → 執行 → 報告」工作流程,相同的 Couette 範例,不同的求解器——沒有授權座位、沒有 GUI、沒有 .msb 檔案。取而代之的是,您需要撰寫字典檔案並從命令列執行求解器。
工作流程(依序)
1. 討論(英文) -> 什麼流體?什麼幾何?您想量測什麼?
2. 撰寫 case.yaml -> 所有數值集中在一個檔案,附帶單位。展示給使用者看。取得確認。
3. 網格 -> blockMeshDict:Couette 的楔形區域。使用 checkMesh 檢查。
4. 建置案例 -> 複製範本,替換 Omega。無 GUI。
5. 掃描 / 執行 -> 每個剪切率執行一次 simpleFoam,每次執行產生扭矩 CSV。
6. 後處理 -> 扭矩 -> 應力,角速度 -> 剪切率,流變曲線 + 驗證。
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。在信任非牛頓執行結果之前,請對照模型原始碼進行驗證。如果使用者指定了真實材料,不要自行發明其參數:請索取量測的流變曲線、rheofit 擬合結果或文獻值,否則從牛頓流體開始。
操作條件——掃描
- 剪切率範圍與間距,例如 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,由forcesfunctionObject 寫入)。
2. 撰寫 case.yaml
每個模擬一個檔案,位於 examples/<name>/case.yaml。這是合約:腳本會讀取它,而不會從對話中重新推導數值。範本:examples/couette/case.yaml。在建立案例前先展示給使用者看並取得確認。
3. 網格——M-Star 隱藏的步驟
OpenFOAM 需要網格,在此透過 blockMesh 從 system/blockMeshDict 建立。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(sector) * (360/4) * (0.060/0.001) = M_x * 5400
其中 M_x 是 forces functionObject 在 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迭代次數,forcesfunctionObject(patches (innerWall),rho rhoInf; rhoInf 1000;,CofR (0 0 0),writeInterval 5)。v2412 會寫入force.dat和moment.dat(分開的檔案),而非forces.dat。
狀態:穩態案例已在此 VM 中實際執行(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% 的樣本)上平均扭矩,報告其標準差作為穩定性檢查。
驗證關卡(新幾何的第一次執行為強制性)。 先執行已知黏度 eta 的牛頓流體,並與解析 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 frontmatter: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)