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スキルのオープンソース版です。同じ「議論 → ケース → 実行 → レポート」のワークフロー、同じクエットの例、異なるソルバーであり、ライセンスシートもGUIも.msbファイルも不要です。代わりに、辞書ファイルを作成し、コマンドラインからソルバーを実行します。
ワークフロー(順序通り)
1. 議論(英語) -> どの流体、どの幾何形状、何を測定したいか?
2. case.yamlを作成 -> すべての数値を1つのファイルに単位付きで記述。ユーザーに表示し、承認を得る。
3. メッシュ生成 -> blockMeshDict:クエット用のくさびセクター。checkMeshで確認。
4. ケースをビルド -> テンプレートをコピーし、Omegaを置換。GUI不要。
5. スイープ / 実行 -> せん断速度ごとに1回のsimpleFoam実行、実行ごとにトルクCSVを出力。
6. 後処理 -> トルク → 応力、ω → せん断速度、流動曲線 + 検証。
7. レポート -> プロット + CSV + 仮定、確認済み項目、未検証項目を記載。
ステップ2を絶対にスキップしないこと。 M-StarおよびPalabosスキルと同じルールです:せん断速度範囲、流体モデル、または幾何形状が未確認のままシミュレーションを実行することは無駄な実行です。ユーザーが数値を指定していない場合は、質問してください。こちらで勝手に数値を決めて辞書に埋め込まないでください。例の中のデフォルト値にはdefault:というラベルが付いており、確認が必要です。
ここでの実行は無料ですが(ライセンスシート不要)、それでも無料ではありません:細かい解像度の3D実行には実際のCPU時間がかかります。最初は安価な実行(粗いメッシュ、1つのせん断速度)をデフォルトとし、その後でスイープしてください。
1. 議論 — 引き出すべき情報
M-Starスキルと同じチェックリストに加え、OpenFOAM固有の項目:
幾何形状
- 内側(回転)半径
R_i、外側(固定)半径R_o、浸漬長さL。単位はメートル。 - 最初のバージョンはくさびセクターであり、完全な環状部ではありません。 OpenFOAMは3D有限ボリュームであるため、クエットセルは薄いくさび(4°、軸はX方向、軸方向の厚さ1 mm、軸方向セル数1)としてモデル化され、2つのセクター面には
wedgeパッチ、2つの軸方向面にはemptyパッチが適用されます。くさび境界条件により解は軸対称になります:テイラー渦や端部効果はなく、解析的なトルクが仮定する理想的な無限長クエットセルです。どちらで実行するかを明示してください。完全な3D環状部はフォローアップであり、端部効果が加わり、臨界テイラー数Ta_c ≈ 41.3を超えるとトルクが解析的な層流値を超えるテイラー渦が発生し、検証ゲートを突破します。このケース(η = 1 Pa·s、ρ = 1000 kg/m³)では、Re ≤ 1.8、Ta ≤ 0.9であり、スイープ全体を通して環状部でも層流が維持されますが、くさびの方が安価でクリーンな検証手段です。
流体 — 数値を伴うレオロジーを1つ選択
OpenFOAMには、constant/transportPropertiesにレオロジーのドロップダウンがあります:transportModel Newtonian;が検証ケースであり、HerschelBulkley、BirdCarreau、Casson、powerLaw、CrossPowerLawは組み込みのgeneralisedNewtonianモデルです。Herschel-BulkleyとBird-Carreauは文書化されたフォローアップであり、検証ケースではありません。2つの落とし穴:
transportProperties内の粘度は動粘度nu= η/ρ(m²/s)であり、動的粘度ηではありません。η = 1.0 Pa·s、ρ = 1000 kg/m³の場合、nu = 1e-03— 1e-06(水の値、η = 1e-3 Pa·s)ではありません。このリポジトリの初期ドラフトでは1e-06を使用しており、速度プロファイルは正しく見えたもののトルクが正確に1000分の1になりました。ニュートンクエットプロファイルは粘度に依存しないため、プロファイルではこの間違いに気づきません。トルクは気づきます。- 非ニュートン係数も動粘度ベースです(
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%です。
測定対象
- クエット:回転ボブにかかるトルク → せん断応力、回転速度 → せん断速度。流動曲線。実行前に、そのデータの出典ファイル(
postProcessing/forces/0/moment.dat、forces関数オブジェクトが出力)の名前を明示してください。
2. case.yamlを作成
シミュレーションごとに1つのファイルをexamples/<name>/case.yamlに作成します。これは契約書です:スクリプトはこれを読み取り、チャットから数値を再導出しません。テンプレート:examples/couette/case.yaml。ビルド前にユーザーに表示し、承認を得てください。
3. メッシュ — M-Starが隠すステップ
OpenFOAMはメッシュを必要とします。ここではsystem/blockMeshDictからblockMeshを使用して構築します。クエットメッシュは単一の六面体ブロックです:
軸 = X(円筒軸)、半径方向 = Y、くさびはY-Z平面に開く
くさび角度 合計4度(OpenFOAMでは5度未満が必要)、半角2度
軸方向範囲 x = 0..0.001 m、1セル(軸方向変化なし)
半径方向:5 mmギャップを40セル、simpleGrading (1 1 1)
パッチ:innerWall、outerWall、back/front(タイプ wedge)、
left/right(タイプ empty)
計算前にcheckMeshで確認:Mesh OK.、くさび角度2°以下、非直交性0と報告される必要があります。1つのメッシュ内のempty + wedgeの組み合わせはv2412で受け入れられます(ここで確認済み)。将来のバージョンで拒否される場合は、軸方向面をsymmetryに変更してください。
トルクのスケーリング:セクターは60 mm円筒の1 mmスライスの4°スライスであるため、
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は「フィールド 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ではありません。
ステータス:定常ケースはこのVM(OpenFOAM v2412、2026-11-17)で実際に実行され、§6のニュートン検証に合格しています(γ̇ = 10 で解析トルク誤差0.03% — examples/couette/RUN_REPORT.md参照)。 過渡のpimpleFoamバリアント(case-transient/、スピンアップ動画用)も実行可能:1000ステップを約2秒で実行し、同じトルクに収束します。
非ニュートン:transportProperties内のtransportModelを変更(最初にHerschel-Bulkley、次にBird-Carreau)。ニュートンパスをデフォルトかつ検証ゲートとして維持してください — 未検証の幾何形状で非ニュートンモデルをデバッグしないでください。
5. 実行
./run-couette.sh --run # せん断速度ごとに1回実行、examples/couette/runs/ 内
# または、ポイントごとに:
python3 couette_build.py --gamma 10 --out runs/gamma_10
cd runs/gamma_10 && blockMesh && simpleFoam
各実行はtorque.csv(反復、セクターモーメント、全円筒トルク)とrun_info.json(収束フラグ、反復数、経過時間)を書き出します。実行が遅い場合は、最初にメッシュまたは実行時間を調整してください — 高速化のために幾何形状を黙って変更しないでください。Uz残差が1e-7未満に低下せずにendTimeに達した実行は、converged: falseとフラグが付けられます — トルクを信頼する前に診断してください(メッシュ、境界条件、緩和係数)。
6. 後処理 — トルクから流動曲線(クエット)へ
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%のサンプル)にわたってトルクを平均化し、その標準偏差を定常性のチェックとして報告します。
検証ゲート(新しい幾何形状の最初の実行には必須)。 既知の粘度ηのニュートン流体を最初に実行し、解析的なクエットトルクと比較します:
T_analytic = 4*pi*L*eta*Omega*Ri^2*Ro^2 / (Ro^2 - Ri^2)
シミュレーショントルクが約10%以上異なる場合は、非ニュートン流動曲線に進まないでください。 停止して診断:ギャップ内のメッシュ解像度、nu(動粘度と動的粘度 — §1参照)、実行時間/収束、回転壁境界、トルクスケーリング。検証番号をレポートに記録してください。couette_post.pyはこのゲートを強制し、失敗すると非ゼロで終了します。
その後、各スイープポイントが(gamma_i, tau_i)の1点を与えます。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はシェルコマンドを実行する前に、特に長時間のソルバー実行の前に、許可を求める必要があります。セッション中にスキルが追加された場合は、最初に/skills reloadを実行してください。
このスキルが行わないこと
scripts/install-openfoam.sh内のスクリプト化されたaptルートを超えて、OpenFOAMをインストールすることはしません:Debian/Ubuntuマシンとsudo権限が必要です。- インストールされたOpenFOAMに対して実行し、ニュートン検証に合格するまで、ケースが検証されたとは主張しません。
- タンク、インペラ、多相流、または粒子を含む流れに対してM-Starを置き換えるものではありません — これらはv0.1の範囲外です。このリポジトリは、有限ボリュームルートが機能する最初の証明として、クエット流動曲線をオープンに提供します。
このリポジトリのファイル
skills/openfoam-simulation/SKILL.md— このファイル。.github/skills/openfoam-simulation/SKILL.md(GitHub Copilot CLIが検出するコピー)にバイト単位でミラーリングされています。2つのコピーを同期させてください — 両方を同じコミットで編集してください。docs/openfoam-guide.md— インストール、メッシュ、境界条件、非ニュートンに関する注意事項、制限事項。examples/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ライセンス)