Simulación con OpenFOAM
OpenFOAM (openfoam.com, ESI/OpenCFD) es el estándar de código abierto
para CFD de volúmenes finitos, GPL, C++ con MPI. No es un
código de Boltzmann reticular como M-Star o Palabos: resuelve las
ecuaciones de Navier–Stokes sobre una malla, con modelos de
viscosidad incorporados (newtoniano, ley de potencia,
Herschel–Bulkley, Bird–Carreau, Cross, Casson), una condición de
contorno rotatingWallVelocity y solucionadores estacionario
(simpleFoam) y transitorio (pimpleFoam). El par proviene del
objeto de función forces. Esta habilidad es la contraparte de
código abierto de la habilidad mstar-simulation en el repositorio
privado mstar-skill y de palabos-simulation: el mismo flujo de
trabajo discusión → caso → ejecución → informe, el mismo ejemplo de
Couette, solucionador diferente — sin licencia, sin interfaz
gráfica, sin archivo .msb. En su lugar, escribes archivos de
diccionario y ejecutas los solucionadores desde la línea de comandos.
El flujo de trabajo, en orden
1. Discutir (inglés) -> ¿qué fluido, qué geometría, qué quieres medir?
2. Escribir case.yaml -> todos los números en un solo archivo, con unidades. Mostrarlo. Obtener un sí.
3. Mallar -> blockMeshDict: sector de cuña para Couette. Verificar con checkMesh.
4. Construir el caso -> copiar la plantilla, sustituir Omega. Sin interfaz gráfica.
5. Barrer / ejecutar -> un simpleFoam por tasa de cizalla, un CSV de par por ejecución.
6. Postprocesar -> par -> esfuerzo, omega -> tasa de cizalla, curva de flujo + validación.
7. Informar -> gráfico + CSV + lo que se asumió, verificó y no verificó.
Nunca saltarse el paso 2. Misma regla que en las habilidades de
M-Star y Palabos: una simulación con un rango de tasa de cizalla,
modelo de fluido o geometría no confirmados es una ejecución
desperdiciada. Si el usuario no ha nombrado un número, pregúntalo ——
no inventes uno y lo ocultes en un diccionario. Los valores por
defecto en los ejemplos están etiquetados default: y deben ser
confirmados.
Ejecutar aquí es gratuito (sin licencia), pero no es gratis: una ejecución 3D con resolución fina consume tiempo real de CPU. Por defecto, haz una primera ejecución barata (malla gruesa, una tasa de cizalla) y solo entonces barre.
1. Discutir — qué obtener
La misma lista de verificación que la habilidad M-Star, más aspectos específicos de OpenFOAM:
Geometría
- Radio interior (giratorio)
R_i, radio exterior (fijo)R_o, longitud sumergidaL. En metros. - La primera versión es un sector de cuña, no un anillo completo.
OpenFOAM es de volúmenes finitos 3D, por lo que una celda de
Couette se modela como una cuña delgada (4°, eje a lo largo de
X, rebanada axial de 1 mm, 1 celda axial) con parches
wedgeen las dos caras del sector y parchesemptyen las dos caras axiales. La condición de contorno de cuña hace que la solución sea axisimétrica: sin vórtices de Taylor, sin efectos de borde — la celda de Couette ideal de longitud infinita, exactamente lo que asume el par analítico. Di cuál estás ejecutando. Un anillo 3D completo es el seguimiento: añade efectos de borde y, por encima del número de Taylor crítico Ta_c ≈ 41.3, vórtices de Taylor que aumentan el par por encima del valor laminar analítico y rompen la puerta de validación. Para este caso (η = 1 Pa·s, ρ = 1000 kg/m³) Re ≤ 1.8 y Ta ≤ 0.9 en toda la barrida, por lo que un anillo completo permanecería laminar — pero la cuña sigue siendo la validación más barata y limpia.
Fluido — elegir una reología, con números
OpenFOAM tiene un menú desplegable de reología, en
constant/transportProperties: transportModel Newtonian; es el
caso de validación, y HerschelBulkley, BirdCarreau, Casson,
powerLaw, CrossPowerLaw son modelos generalisedNewtonian
incorporados. Herschel–Bulkley y Bird–Carreau son el seguimiento
documentado, no el caso de validación. Dos trampas:
- La viscosidad en
transportPropertieses la viscosidad cinemáticanu= η/ρ (m²/s), no la viscosidad dinámica η. Para η = 1.0 Pa·s y ρ = 1000 kg/m³,nu = 1e-03— no 1e-06 (el valor para el agua, η = 1e-3 Pa·s). Un borrador temprano de este repositorio usó 1e-06 y el par resultó exactamente 1000× más pequeño mientras que el perfil de velocidad parecía correcto — el perfil de Couette newtoniano es independiente de la viscosidad, por lo que el perfil no detecta este error. El par sí lo hace. - Los coeficientes no newtonianos también son cinemáticos
(
nu0= η0/ρ,k= K/ρ); el esfuerzo de fluenciatau0está en Pa. Verifica contra la fuente del modelo antes de confiar en una ejecución no newtoniana. Si el usuario nombra un material real, no inventes sus parámetros: pide una curva de flujo medida, un ajuste reofítico o un valor de la literatura, o comienza con newtoniano.
Condiciones de operación — la barrida
- Rango y espaciado de la tasa de cizalla, p. ej., 0.1 → 100 s⁻¹, espaciado logarítmico.
- Resolución de la malla: celdas a través del espacio (por defecto 40, es decir, dx = 0.125 mm). Más celdas = esfuerzo cortante en la pared más preciso, pero mucho más coste.
- Duración de la ejecución:
simpleFoamcorre en iteraciones, no en segundos.endTime 3000conresidualControl1e-8 — el solucionador se detiene temprano cuando converge (γ̇ = 10 converge en ~2050 iteraciones, ~2 s). La ventana estacionaria para promediar el par es el último 20% de las muestras demoment.dat.
Qué se mide
- Couette: par en el rotor → esfuerzo cortante, velocidad de
rotación → tasa de cizalla. La curva de flujo. Nombra el
archivo del que proviene (
postProcessing/forces/0/moment.dat, escrito por el objeto de funciónforces) antes de ejecutar.
2. Escribir case.yaml
Un archivo por simulación, en examples/<nombre>/case.yaml. Es el
contrato: los scripts lo leen, no derivan números del chat.
Plantilla: examples/couette/case.yaml. Muéstralo al usuario y
obtén un sí antes de construir.
3. Mallado — el paso que M-Star oculta
OpenFOAM necesita una malla, construida aquí con blockMesh a
partir de system/blockMeshDict. La malla de Couette es un solo
bloque hexaédrico:
eje = X (eje del cilindro), radial = Y, cuña se abre en el plano Y-Z
ángulo de cuña 4 grados total (OpenFOAM requiere < 5 grados), semiángulo 2 grados
extensión axial x = 0..0.001 m, UNA celda (sin variación axial)
radial: 40 celdas a través del espacio de 5 mm, simpleGrading (1 1 1)
parches: innerWall, outerWall, back/front (tipo wedge),
left/right (tipo empty)
Verifica con checkMesh antes de resolver: debe informar
Mesh OK., ángulo de cuña 2° por lado, no ortogonalidad 0. La
combinación empty + wedge en una malla es aceptada por v2412
(verificado aquí); si una versión futura la rechaza, cambia las
caras axiales a symmetry.
Escalado del par: el sector es un corte de 4° de una rebanada de 1 mm del cilindro de 60 mm, por lo que
T_full = M_x(sector) * (360/4) * (0.060/0.001) = M_x * 5400
donde M_x es el momento alrededor del eje X del objeto de función
forces en innerWall (CofR en el origen, sobre el eje).
El signo es negativo (el arrastre del fluido se opone a la
rotación); el par motor es la magnitud.
4. Construir el caso
OpenFOAM es un conjunto de aplicaciones, no una biblioteca: escribes archivos de diccionario y los ejecutas. La estructura del repositorio:
bash scripts/install-openfoam.sh # repositorio oficial de Debian, v2412
source /usr/lib/openfoam/openfoam2412/etc/bashrc
bash scripts/check-setup.sh # simpleFoam, blockMesh, checkMesh, uv
./run-couette.sh # ejecución en seco: construir malla + solo checkMesh
couette_build.py copia la plantilla (examples/couette/case/)
a un directorio de ejecución y sustituye __OMEGA__ en 0/U con
la velocidad angular para la tasa de cizalla:
Omega = gamma * (Ro^2 - Ri^2) / (2 * Ro^2)
Condiciones de contorno (verificadas con los tutoriales de v2412):
innerWall:rotatingWallVelocity,axis (1 0 0),omega constant <Omega>(rad/s),origin (0 0 0). Patrón: el tutorialclimbingRodconrotatingWallVelocity.outerWall:noSlip.back/front:wedge;left/right:empty.- Presión:
fixedFluxPressureen ambas paredes (caso de todas las paredes). constant/transportProperties:transportModel Newtonian;nu 1e-03;(ver §1 — cinemática, no dinámica).constant/turbulenceProperties:simulationType laminar;. v2412 leeturbulenceProperties; las versiones más nuevas lo renombraron amomentumTransport— si tu solucionador se queja de que no puede encontrar el otro nombre, renombra el archivo y suobjectinterno.system/fvSolution:SIMPLEconpRefCell 0; pRefValue 0;(requerido: cada límite es una pared, por lo que la presión necesita una celda de referencia — sin ella simpleFoam sale con "Unable to set reference cell for field p"), GAMG para p, smoothSolver para U,residualControlp/U 1e-8.system/controlDict:simpleFoam,endTime 3000iteraciones, objeto de funciónforces(patches (innerWall),rho rhoInf; rhoInf 1000;,CofR (0 0 0),writeInterval 5). v2412 escribeforce.datymoment.dat(archivos separados), noforces.dat.
Estado: el caso estacionario se ha ejecutado realmente en esta
máquina virtual (OpenFOAM v2412, 2026-11-17) y la validación
Newtoniana en §6 pasa (0.03% de error de par analítico en γ̇ = 10 —
ver examples/couette/RUN_REPORT.md). La variante transitoria
pimpleFoam (case-transient/, para el video de arranque)
también se ejecuta: 1000 pasos en ~2 s, convergiendo al mismo par.
No newtoniano: cambia transportModel en
transportProperties (Herschel–Bulkley primero, Bird–Carreau
segundo). Mantén la ruta Newtoniana como predeterminada y la
puerta de validación — nunca depures un modelo no newtoniano en
una geometría no validada.
5. Ejecutar
./run-couette.sh --run # una ejecución por tasa de cizalla, en examples/couette/runs/
# o, por punto:
python3 couette_build.py --gamma 10 --out runs/gamma_10
cd runs/gamma_10 && blockMesh && simpleFoam
Cada ejecución escribe torque.csv (iteración, momento del sector,
par del cilindro completo) y run_info.json (bandera de
convergencia, iteraciones, tiempo de pared). Si una ejecución es
lenta, refina primero la malla o el tiempo de ejecución — no
cambies silenciosamente la geometría para hacerla rápida. Una
ejecución que alcanza endTime sin que el residual de Uz caiga
por debajo de 1e-7 se marca converged: false — diagnostica antes
de confiar en su par (malla, condiciones de contorno,
relajación).
6. Postprocesar — par a curva de flujo (Couette)
Misma conversión que las habilidades M-Star y Palabos:
tasa de cizalla en la pared interior: gamma_i = 2*Omega*Ro^2 / (Ro^2 - Ri^2)
esfuerzo cortante en la pared interior: tau_i = T / (2*pi*Ri^2*L)
viscosidad aparente: eta_app = tau_i / gamma_i
Promedia el par en la ventana estacionaria nombrada en case.yaml
(último 20% de las muestras), reporta su desviación estándar como
verificación de estacionariedad.
Puerta de validación (obligatoria para la primera ejecución de una geometría nueva). Ejecuta primero un fluido newtoniano de eta conocida y compara con el par analítico de Couette:
T_analytic = 4*pi*L*eta*Omega*Ri^2*Ro^2 / (Ro^2 - Ri^2)
Si el par simulado difiere en más de ~10%, no continúes con una
curva de flujo no newtoniana. Detente y diagnostica: resolución de
malla a través del espacio, nu (cinemática vs dinámica — ver §1),
tiempo de ejecución / convergencia, pared giratoria, escalado del
par. Registra el número de validación en el informe.
couette_post.py aplica esta puerta y sale con código distinto de
cero en caso de fallo.
Luego, cada punto de barrida da un punto (gamma_i, tau_i). Grafica
tau vs gamma (log-log) y eta_app vs gamma, escribe
flow_curve.csv y — si el usuario quiere parámetros — ajusta la
curva con rheofit (Herschel–Bulkley, Carreau, …) en un paso
separado.
7. Informe
Entrega, por ejecución: case.yaml (tal como se ejecutó),
flow_curve.csv, flow_curve.png y una nota breve que indique la
geometría (sector de cuña, ángulo, celdas a través del espacio),
fluido, barrida, resultado de validación, criterio de estado
estacionario y cualquier cosa no verificada. Si una ejecución
falló, reporta la cola del registro del solucionador — no omitas
silenciosamente el punto de la curva.
Iniciar una sesión con GitHub Copilot CLI
Misma configuración que mstar-skill y palabos-skill: Copilot
CLI descubre las habilidades del proyecto en .github/skills/, y
esta habilidad está duplicada allí. Desde la raíz del repositorio:
git clone https://github.com/marcocaggioni/openfoam-skill.git
cd openfoam-skill
bash scripts/install-openfoam.sh
bash scripts/check-setup.sh
copilot
Luego /skills list (deberías ver openfoam-simulation), y:
/openfoam-simulation ejecuta el ejemplo de Couette en examples/couette/case.yaml
Esta habilidad deliberadamente no tiene metadatos allowed-tools:
Copilot debe preguntar antes de ejecutar comandos de shell, y en
particular antes de una ejecución larga del solucionador. Si la
habilidad se añadió durante una sesión, ejecuta /skills reload
primero.
Qué NO hace esta habilidad
- No instala OpenFOAM por ti más allá de la ruta
aptscripteada enscripts/install-openfoam.sh: necesitas una máquina Debian/Ubuntu y sudo. - No afirma que un caso esté verificado hasta que se ejecuta contra un OpenFOAM instalado y la validación newtoniana pasa.
- No reemplaza M-Star para tanques, impulsores, multifásicos o flujos con partículas — esos están fuera del alcance de v0.1. Este repositorio es la curva de flujo de Couette, hecha de forma abierta, como la primera prueba de que la ruta de volúmenes finitos abierta funciona.
Archivos en este repositorio
skills/openfoam-simulation/SKILL.md— este archivo. Duplicado byte por byte en.github/skills/openfoam-simulation/SKILL.md(la copia que GitHub Copilot CLI descubre). Mantén las dos copias sincronizadas — edita ambas en el mismo commit.docs/openfoam-guide.md— notas de instalación, mallado, condiciones de contorno, no newtoniano, límites.examples/couette/— el ejemplo de Couette trabajado:case.yaml,case/(plantilla estacionaria simpleFoam),case-transient/(plantilla transitoria pimpleFoam para arranque),couette_build.py,couette_sweep.py,couette_post.py,make_video.py,README.md.- El propio OpenFOAM: https://www.openfoam.com (GPL)