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) RadiusR_o, EintauchlängeL. 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 undempty-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
transportPropertiesist die kinematische Viskositätnu= η/ρ (m²/s), nicht die dynamische Viskosität η. Für η = 1,0 Pa·s und ρ = 1000 kg/m³ giltnu = 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ßspannungtau0ist 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:
simpleFoamläuft in Iterationen, nicht in Sekunden.endTime 3000mitresidualControl1e-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 % dermoment.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 dasforcesfunctionObject), 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: dasclimbingRod-Tutorial verwendetrotatingWallVelocity.outerWall:noSlip.back/front:wedge;left/right:empty.- Druck:
fixedFluxPressureauf beiden Wänden (Allwand-Fall). constant/transportProperties:transportModel Newtonian;nu 1e-03;(siehe §1 – kinematisch, nicht dynamisch).constant/turbulenceProperties:simulationType laminar;. v2412 liestturbulenceProperties; neuere Versionen haben es inmomentumTransportumbenannt – wenn Ihr Löser sich beschwert, dass er den anderen Namen nicht finden kann, benennen Sie die Datei und ihr internesobjectum.system/fvSolution:SIMPLEmitpRefCell 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,residualControlp/U 1e-8.system/controlDict:simpleFoam,endTime 3000Iterationen,forcesfunctionObject (patches (innerWall),rho rhoInf; rhoInf 1000;,CofR (0 0 0),writeInterval 5). v2412 schreibtforce.datundmoment.dat(separate Dateien), nichtforces.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 inscripts/install-openfoam.shhinaus: 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)