CommunityCodierung & Entwicklunggithub.com

OpenFOAM-Simulation

Führen Sie eine quelloffene OpenFOAM-Finite-Volumen-Simulation auf Basis einer englischsprachigen Diskussion durch: Ermitteln Sie Geometrie, Fluid und Betriebsbedingungen in einfacher Sprache, erstellen Sie daraus eine geprüfte Case-Datei, bauen Sie den OpenFOAM-Fall und führen Sie ihn über die Kommandozeile aus und wandeln Sie das Wanddrehmoment in ein physikalisches Ergebnis um (z. B. eine Couette-Fließkurve). Verwenden Sie dies, wenn der Benutzer eine kostenlose CFD-Simulation ohne Lizenz wünscht – einen Couette-Rheometer, einen Kanal, einen Rührkessel – oder nach der quelloffenen Entsprechung zu einem M-Star-Lauf fragt.

Was ist OpenFOAM-Simulation?

Das OpenFOAM-Simulation-Skill ermöglicht die vollständige Durchführung einer CFD-Simulation mit OpenFOAM (ESI/OpenCFD) – von der englischsprachigen Diskussion der Geometrie-, Fluid- und Betriebsparameter über die Erstellung einer geprüften Case-Datei bis hin zum Bau, der Ausführung und der Nachbereitung auf der Kommandozeile. Es ist das quelloffene Pendant zu den Skills `mstar-simulation` und `palabos-simulation` und folgt dem gleichen Ablauf: Diskussion → Case erstellen → ausführen → berichten. Im Gegensatz zu M-Star oder Palabos löst OpenFOAM die Navier-Stokes-Gleichungen auf einem Netz (kein Lattice-Boltzmann) und bietet eingebaute Viskositätsmodelle (Newton, Potenzgesetz, Herschel-Bulkley, Bird-Carreau, Cross, Casson) sowie die Randbedingung `rotatingWallVelocity`. Das Drehmoment wird über das `forces` functionObject ermittelt. Das Skill unterstützt sowohl stationäre (`simpleFoam`) als auch transiente (`pimpleFoam`) Löser und ist für den Einsatz mit GitHub Copilot CLI konzipiert. Es wird über das Repository `marcocaggioni/openfoam-skill` bereitgestellt und erfordert ein Debian/Ubuntu-System mit sudo-Rechten zur Installation von OpenFOAM. Das Skill erzeugt aus der Diskussion eine `case.yaml` als Vertrag, erstellt das Netz mit `blockMesh`, führt die Rechnungen durch und wandelt das Drehmoment in eine Fließkurve um. Eine Newton-Validierung (Abweichung < 10%) ist zwingend erforderlich, bevor nicht-newtonsche Modelle verwendet werden. Das Skill ist auf Couette-Strömungen spezialisiert, nicht auf Rührkessel oder Mehrphasenströmungen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/marcocaggioni/openfoam-skill/tree/HEAD/.github/skills/openfoam-simulation

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht OpenFOAM-Simulation?

OpenFOAM (openfoam.com, ESI/OpenCFD) ist der quelloffene Standard für Finite-Volumen-CFD, GPL, C++ mit MPI. Es ist kein Lattice-Boltzmann-Code wie M-Star oder Palabos: es löst die Navier-Stokes- Gleichungen auf einem Netz mit eingebauten Viskositätsmodellen (newtonsch, Potenzgesetz, Herschel-Bulkley, Bird-Carreau, Cross, Casson), einer rotatingWallVelocity-Randbedingung und stationären (simpleFoam) und transienten (pimpleFoam) Lösern. Das Drehmoment stammt aus dem forces functionObject. Dieses Skill ist das quelloffene Gegenstück zum mstar-simulation-Skill im privaten mstar-skill-Repo und zu palabos-simulation: gleicher Arbeitsablauf Diskussion → Fall → Ausführung → Bericht, gleiches Couette-Beispiel, anderer Löser – kein Lizenzsitz, keine GUI, keine .msb-Datei. Stattdessen schreiben Sie Dictionary-Dateien und führen die Löser von der Kommandozeile aus.

Der Arbeitsablauf, der Reihe nach

1. Diskutieren (Englisch)      -> welches Fluid, welche Geometrie, was soll gemessen werden?
2. case.yaml schreiben         -> jede Zahl in einer Datei, mit Einheiten. Zeigen. Einverständnis einholen.
3. Netz                         -> blockMeshDict: Keilsektor für Couette. Mit checkMesh prüfen.
4. Fall bauen                  -> Vorlage kopieren, Omega ersetzen. Keine GUI.
5. Sweep / ausführen           -> ein simpleFoam-Lauf pro Scherrate, Drehmoment-CSV pro Lauf.
6. Nachbereitung               -> Drehmoment -> Spannung, Omega -> Scherrate, Fließkurve + Validierung.
7. Bericht                     -> Diagramm + CSV + was angenommen, geprüft und nicht verifiziert wurde.

Schritt 2 niemals überspringen. Gleiche Regel wie bei den M-Star- und Palabos- Skills: Eine Simulation mit unbestätigtem Scherratenbereich, Fluidmodell oder Geometrie ist ein verschwendeter Lauf. Wenn der Benutzer keine Zahl genannt hat, fragen – nicht selbst eine erfinden und in einem Dictionary verstecken. Vorgaben in den Beispielen sind mit default: gekennzeichnet und müssen bestätigt werden.

Das Ausführen ist hier kostenlos (kein Lizenzsitz), aber es ist dennoch nicht kostenlos: Ein 3D-Lauf mit feiner Auflösung kostet echte CPU-Zeit. Standardmäßig zuerst einen günstigen Lauf durchführen (grobes Netz, eine Scherrate) und erst dann den Sweep.

1. Diskutieren – was zu ermitteln ist

Gleiche Checkliste wie beim M-Star-Skill, plus OpenFOAM-spezifische Punkte:

Geometrie

  • Innerer (rotierender) Radius R_i, äußerer (fester) Radius R_o, Eintauchlänge L. Meter.
  • Erste Version ist ein Keilsektor, kein vollständiger Ringraum. OpenFOAM ist 3D-Finite-Volumen, daher wird eine Couette-Zelle als dünner Keil (4°, Achse entlang X, 1 mm axialer Schnitt, 1 Zelle axial) mit wedge-Patches auf den beiden Sektorflächen und empty-Patches auf den beiden axialen Flächen modelliert. Die Keil-Randbedingung macht die Lösung achsensymmetrisch: keine Taylor-Wirbel, keine Endeffekte – die ideale unendlich lange Couette-Zelle, genau das, was die analytische Drehmomentformel annimmt. Sagen Sie, welche Sie ausführen. Ein vollständiger 3D-Ringraum ist die Folgemaßnahme: er fügt Endeffekte hinzu und, oberhalb der kritischen Taylor-Zahl Ta_c ≈ 41,3, Taylor-Wirbel, die das Drehmoment über den analytischen laminaren Wert erhöhen und das Validierungstor brechen. Für diesen Fall (η = 1 Pa·s, ρ = 1000 kg/m³) gilt Re ≤ 1,8 und Ta ≤ 0,9 über den gesamten Sweep, sodass ein vollständiger Ringraum laminar bliebe – aber der Keil ist dennoch der günstigere, sauberere Validierungsfall.

Fluid – eine Rheologie mit Zahlen auswählen

OpenFOAM hat ein Rheologie-Dropdown in constant/transportProperties: transportModel Newtonian; ist der Validierungsfall und HerschelBulkley, BirdCarreau, Casson, powerLaw, CrossPowerLaw sind eingebaute generalisedNewtonian Modelle. Herschel-Bulkley und Bird-Carreau sind die dokumentierten Folgeuntersuchungen, nicht der Validierungsfall. Zwei Fallen:

  • Die Viskosität in transportProperties ist die kinematische Viskosität nu = η/ρ (m²/s), nicht die dynamische Viskosität η. Für η = 1,0 Pa·s und ρ = 1000 kg/m³ gilt nu = 1e-03 – nicht 1e-06 (der Wert für Wasser, η = 1e-3 Pa·s). Ein früher Entwurf dieses Repos verwendete 1e-06, und das Drehmoment war exakt 1000× zu klein, während das Geschwindigkeitsprofil richtig aussah – das newtonsche Couette-Profil ist viskositätsunabhängig, daher fängt das Profil diesen Fehler nicht. Das Drehmoment schon.
  • Die nicht-newtonschen Koeffizienten sind ebenfalls kinematisch (nu0 = η0/ρ, k = K/ρ); die Fließspannung tau0 ist in Pa. Vor dem Vertrauen in einen nicht-newtonschen Lauf mit dem Quellcode des Modells abgleichen. Wenn der Benutzer ein reales Material nennt, dessen Parameter nicht erfinden: nach einer gemessenen Fließkurve, einem Rheofit-Fit oder einem Literaturwert fragen, oder mit newtonsch beginnen.

Betriebsbedingungen – der Sweep

  • Scherratenbereich und -abstand, z. B. 0,1 → 100 s⁻¹, logarithmisch verteilt.
  • Netzauflösung: Zellen über den Spalt (Standard 40, d. h. dx = 0,125 mm). Mehr Zellen = genauere Wandschubspannung, viel höhere Kosten.
  • Rechenzeit: simpleFoam läuft in Iterationen, nicht in Sekunden. endTime 3000 mit residualControl 1e-8 – der Löser stoppt frühzeitig, wenn konvergiert (γ̇ = 10 konvergiert in ~2050 Iterationen, ~2 s). Das stationäre Fenster zur Mittelung des Drehmoments sind die letzten 20 % der moment.dat-Proben.

Was gemessen wird

  • Couette: Drehmoment am rotierenden Bob → Schubspannung, Rotationsrate → Scherrate. Die Fließkurve. Nennen Sie die Datei, aus der es stammt (postProcessing/forces/0/moment.dat, geschrieben durch das forces functionObject), vor dem Ausführen.

2. case.yaml schreiben

Eine Datei pro Simulation, in examples/<Name>/case.yaml. Es ist der Vertrag: Die Skripte lesen daraus, sie leiten Zahlen nicht aus dem Chat ab. Vorlage: examples/couette/case.yaml. Dem Benutzer zeigen und vor dem Bauen ein Ja einholen.

3. Netz – der Schritt, den M-Star verbirgt

OpenFOAM benötigt ein Netz, das hier mit blockMesh aus system/blockMeshDict erstellt wird. Das Couette-Netz ist ein einziger Hex-Block:

Achse = X (Zylinderachse), radial = Y, Keil öffnet sich in der Y-Z-Ebene
Keilwinkel insgesamt 4 Grad (OpenFOAM benötigt < 5 Grad), Halbwinkel 2 Grad
axiale Ausdehnung x = 0..0,001 m, EINE Zelle (keine axiale Variation)
radial: 40 Zellen über den 5-mm-Spalt, simpleGrading (1 1 1)
Patches: innerWall, outerWall, back/front (Typ wedge),
         left/right (Typ empty)

Vor dem Lösen mit checkMesh prüfen: es muss Mesh OK. melden, Keilwinkel 2° pro Seite, Nichtorthogonalität 0. Die empty + wedge-Kombination in einem Netz wird von v2412 akzeptiert (hier verifiziert); falls eine zukünftige Version sie ablehnt, die axialen Flächen auf symmetry umstellen.

Drehmomentskalierung: Der Sektor ist ein 4°-Scheibe eines 1-mm-Schnitts des 60-mm-Zylinders, daher

T_voll = M_x(Sektor) * (360/4) * (0,060/0,001) = M_x * 5400

wobei M_x das Moment um die X-Achse aus dem forces functionObject auf innerWall ist (CofR im Ursprung, auf der Achse). Das Vorzeichen ist negativ (Flüssigkeitswiderstand wirkt der Drehung entgegen); das antreibende Drehmoment ist der Betrag.

4. Fall bauen

OpenFOAM ist eine Sammlung von Anwendungen, keine Bibliothek: Sie schreiben Dictionary-Dateien und führen sie aus. Das Repo-Layout:

bash scripts/install-openfoam.sh   # offizielles Debian-Repo, v2412
source /usr/lib/openfoam/openfoam2412/etc/bashrc
bash scripts/check-setup.sh        # simpleFoam, blockMesh, checkMesh, uv
./run-couette.sh                   # Probelauf: Netz bauen + nur checkMesh

couette_build.py kopiert die Vorlage (examples/couette/case/) in ein Ausführungsverzeichnis und ersetzt __OMEGA__ in 0/U mit der Winkelgeschwindigkeit für die Scherrate:

Omega = gamma * (Ro^2 - Ri^2) / (2 * Ro^2)

Randbedingungen (gegen die v2412-Tutorials verifiziert):

  • innerWall: rotatingWallVelocity, axis (1 0 0), omega constant <Omega> (rad/s), origin (0 0 0). Muster: das climbingRod-Tutorial verwendet rotatingWallVelocity.
  • outerWall: noSlip.
  • back/front: wedge; left/right: empty.
  • Druck: fixedFluxPressure auf beiden Wänden (Allwand-Fall).
  • constant/transportProperties: transportModel Newtonian; nu 1e-03; (siehe §1 – kinematisch, nicht dynamisch).
  • constant/turbulenceProperties: simulationType laminar;. v2412 liest turbulenceProperties; neuere Versionen haben es in momentumTransport umbenannt – wenn Ihr Löser sich beschwert, dass er den anderen Namen nicht finden kann, benennen Sie die Datei und ihr internes object um.
  • system/fvSolution: SIMPLE mit pRefCell 0; pRefValue 0; (erforderlich: Jeder Rand ist eine Wand, daher benötigt der Druck eine Referenzzelle – ohne sie beendet sich simpleFoam mit "Unable to set reference cell for field p"), GAMG für p, smoothSolver für U, residualControl p/U 1e-8.
  • system/controlDict: simpleFoam, endTime 3000 Iterationen, forces functionObject (patches (innerWall), rho rhoInf; rhoInf 1000;, CofR (0 0 0), writeInterval 5). v2412 schreibt force.dat und moment.dat (separate Dateien), nicht forces.dat.

Status: Der stationäre Fall wurde auf dieser VM tatsächlich ausgeführt (OpenFOAM v2412, 2026-11-17), und die newtonsche Validierung in §6 besteht (0,03 % Fehler im analytischen Drehmoment bei γ̇ = 10 – siehe examples/couette/RUN_REPORT.md). Der transiente pimpleFoam-Variant (case-transient/, für das Hochfahrvideo) lauft ebenfalls: 1000 Schritte in ~2 s, konvergiert zum gleichen Drehmoment.

Nicht-newtonsch: transportModel in transportProperties ändern (Herschel-Bulkley zuerst, Bird-Carreau als Zweites). Den newtonschen Pfad als Standard und als Validierungstor beibehalten – niemals ein nicht-newtonsches Modell an einer nicht validierten Geometrie debuggen.

5. Ausführen

./run-couette.sh --run           # ein Lauf pro Scherrate, in examples/couette/runs/
# oder, pro Punkt:
python3 couette_build.py --gamma 10 --out runs/gamma_10
cd runs/gamma_10 && blockMesh && simpleFoam

Jeder Lauf schreibt torque.csv (Iteration, Sektormoment, Vollzylinder-Drehmoment) und run_info.json (Konvergenzflag, Iterationen, Rechenzeit). Wenn ein Lauf langsam ist, zuerst das Netz oder die Rechenzeit verfeinern – nicht stillschweigend die Geometrie ändern, um ihn schnell zu machen. Ein Lauf, der endTime erreicht, ohne dass das Uz-Residuum unter 1e-7 fällt, wird als converged: false gekennzeichnet – vor dem Vertrauen in sein Drehmoment diagnostizieren (Netz, Randbedingungen, Unterrelaxation).

6. Nachbereitung – Drehmoment zur Fließkurve (Couette)

Gleiche Umrechnung wie bei den M-Star- und Palabos-Skills:

Scherrate an der Innenwand:   gamma_i = 2*Omega*Ro^2 / (Ro^2 - Ri^2)
Schubspannung an der Innenwand: tau_i  = T / (2*pi*Ri^2*L)
scheinbare Viskosität:         eta_app = tau_i / gamma_i

Drehmoment über das stationäre Fenster mitteln, das in case.yaml genannt wird (letzte 20 % der Proben), dessen Standardabweichung als Stationsprüfung melden.

Validierungstor (zwingend für den ersten Lauf einer neuen Geometrie). Zuerst ein newtonsches Fluid bekannter Viskosität ausführen und mit dem analytischen Couette-Drehmoment vergleichen:

T_analytisch = 4*pi*L*eta*Omega*Ri^2*Ro^2 / (Ro^2 - Ri^2)

Wenn das simulierte Drehmoment um mehr als ~10 % abweicht, nicht mit einer nicht-newtonschen Fließkurve fortfahren. Stoppen und diagnostizieren: Netzauflösung über den Spalt, nu (kinematisch vs. dynamisch – siehe §1), Rechenzeit/Konvergenz, drehende Wandrandbedingung, Drehmomentskalierung. Die Validierungszahl im Bericht festhalten. couette_post.py erzwingt dieses Tor und beendet sich mit Fehlercode bei Misserfolg.

Dann liefert jeder Sweep-Punkt einen (gamma_i, tau_i)-Punkt. tau vs. gamma (log-log) und eta_app vs. gamma darstellen, flow_curve.csv schreiben, und – falls der Benutzer Parameter wünscht – die Kurve mit rheofit (Herschel-Bulkley, Carreau, …) in einem separaten Schritt fitten.

7. Bericht

Pro Lauf liefern: case.yaml (wie ausgeführt), flow_curve.csv, flow_curve.png und eine kurze Notiz mit der Geometrie (Keilsektor, Winkel, Zellen über den Spalt), Fluid, Sweep, Validierungsergebnis, stationärem Kriterium und allem Unverifizierten. Wenn ein Lauf fehlschlug, das Ende des Solver-Logs melden – den Punkt nicht stillschweigend aus der Kurve entfernen.

Starten einer Sitzung mit GitHub Copilot CLI

Gleiche Einrichtung wie mstar-skill und palabos-skill: Copilot CLI entdeckt Projekt-Skills in .github/skills/, und dieses Skill ist dort gespiegelt. Vom Repo-Stammverzeichnis aus:

git clone https://github.com/marcocaggioni/openfoam-skill.git
cd openfoam-skill
bash scripts/install-openfoam.sh
bash scripts/check-setup.sh
copilot

Dann /skills list (Sie sollten openfoam-simulation sehen), und:

/openfoam-simulation führe das Couette-Beispiel in examples/couette/case.yaml aus

Dieses Skill hat bewusst kein allowed-tools-Frontmatter: Copilot muss fragen, bevor es Shell-Befehle ausführt, insbesondere vor einem langen Solver-Lauf. Wenn das Skill während einer Sitzung hinzugefügt wurde, zuerst /skills reload ausführen.

Was dieses Skill NICHT tut

  • Es installiert OpenFOAM nicht für Sie über den skriptgestützten apt-Weg in scripts/install-openfoam.sh hinaus: Sie benötigen eine Debian/Ubuntu-Maschine und sudo.
  • Es behauptet nicht, dass ein Fall verifiziert ist, bis er gegen ein installiertes OpenFOAM läuft und die newtonsche Validierung bestanden wird.
  • Es ersetzt M-Star nicht für Tanks, Rührer, Mehrphasen- oder partikelbeladene Strömungen – diese liegen außerhalb des Rahmens von v0.1. Dieses Repo ist die Couette-Fließkurve, offen durchgeführt, als erster Beleg, dass der offene Finite-Volumen-Weg funktioniert.

Dateien in diesem Repo

  • skills/openfoam-simulation/SKILL.md – diese Datei. Byte-für-Byte gespiegelt unter .github/skills/openfoam-simulation/SKILL.md (die Kopie, die GitHub Copilot CLI entdeckt). Die beiden Kopien synchron halten – beide im selben Commit bearbeiten.
  • docs/openfoam-guide.md – Installations-, Netz-, Randbedingungs-, nicht-newtonsche Notizen, Grenzen.
  • examples/couette/ – das ausgearbeitete Couette-Beispiel: case.yaml, case/ (stationäre simpleFoam-Vorlage), case-transient/ (pimpleFoam-Hochfahr-Vorlage), couette_build.py, couette_sweep.py, couette_post.py, make_video.py, README.md.
  • OpenFOAM selbst: https://www.openfoam.com (GPL)

Verwandte Skills