Communityコーディング&開発github.com

OpenFOAM シミュレーション

英語での議論から幾何形状、流体、操作条件を平易な言葉で引き出し、確認済みのケースファイルに変換、コマンドラインでOpenFOAMケースをビルド・実行し、壁トルクを物理結果(例:クエット流動曲線)に変換する、オープンソースの有限ボリュームCFDシミュレーションスキル。ユーザーが無料・ライセンス不要のCFDシミュレーション(クエットレオメータ、チャネル、攪拌槽)やM-Starのオープンソース版を求める場合に使用する。

OpenFOAM シミュレーション とは?

このスキルは、OpenFOAM(ESI/OpenCFD社のオープンソース有限ボリュームCFDソルバー)を使用して、クエット流動曲線を計算するためのエンドツーエンドのワークフローを提供します。ユーザーとの英語での対話を通じて幾何形状(内径、外径、浸漬長さ)、流体モデル(ニュートン流体、またはHerschel-BulkleyやBird-Carreauなどの一般化ニュートン流体)、および操作条件(せん断速度範囲)を引き出し、それらを確認済みのcase.yamlファイルにまとめます。その後、blockMeshでメッシュを生成し、simpleFoam(定常)またはpimpleFoam(過渡)ソルバーを実行し、forces関数オブジェクトからトルクを抽出します。最終的にトルクからせん断応力・せん断速度への変換を行い、流動曲線をプロット・CSV出力します。M-StarやPalabosのスキルと同様のワークフローですが、ライセンス不要でコマンドライン操作のみで完結します。スキルはCopilot CLIと統合されており、`.github/skills/`から自動検出されます。

対応✓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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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、residualControl 1e-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、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ではありません。

ステータス:定常ケースはこの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ライセンス)

関連スキル