CommunityProgramación y desarrollogithub.com

simulación-openfoam

Ejecuta una simulación CFD de código abierto con OpenFOAM a partir de una conversación en lenguaje natural: extrae la geometría, el fluido y las condiciones de operación, los convierte en un caso verificado, construye y ejecuta el caso desde la línea de comandos, y transforma el par en el eje en un resultado físico (por ejemplo, una curva de flujo de Couette). Útil cuando el usuario quiere una simulación CFD gratuita y sin licencia (reómetro de Couette, canal, tanque agitado) o pide la contraparte de código abierto de una simulación M-Star.

¿Qué es simulación-openfoam?

Esta habilidad permite a un agente de IA (como GitHub Copilot CLI) realizar simulaciones CFD de código abierto utilizando OpenFOAM (ESI/OpenCFD) con un flujo de trabajo estructurado: discusión en lenguaje natural → archivo de caso → mallado → ejecución → postprocesamiento → informe. Está diseñada como la contraparte gratuita y sin licencia de habilidades de simulación privadas como mstar-simulation, centrándose en geometrías de Couette, canales y tanques agitados simples. La habilidad guía al agente para elicitar parámetros del usuario (geometría, reología, condiciones de operación), escribir un archivo case.yaml verificable, generar la malla con blockMesh, ejecutar los solvers simpleFoam o pimpleFoam desde la línea de comandos y postprocesar el par en el eje para obtener curvas de flujo. Incluye una validación obligatoria con la solución analítica de Couette (error < 10%) antes de proceder a fluidos no newtonianos. Soporta los modelos de viscosidad integrados de OpenFOAM (newtoniano, ley de potencia, Herschel-Bulkley, Bird-Carreau, Cross, Casson) y está verificada para OpenFOAM v2412. La habilidad enfatiza no inventar parámetros no confirmados, ejecutar primero simulaciones baratas con malla gruesa y reportar explícitamente los supuestos y resultados de validación.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 sumergida L. 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 wedge en las dos caras del sector y parches empty en 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 transportProperties es la viscosidad cinemática nu = η/ρ (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 fluencia tau0 está 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: simpleFoam corre en iteraciones, no en segundos. endTime 3000 con residualControl 1e-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 de moment.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ón forces) 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 tutorial climbingRod con rotatingWallVelocity.
  • outerWall: noSlip.
  • back/front: wedge; left/right: empty.
  • Presión: fixedFluxPressure en 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 lee turbulenceProperties; las versiones más nuevas lo renombraron a momentumTransport — si tu solucionador se queja de que no puede encontrar el otro nombre, renombra el archivo y su object interno.
  • system/fvSolution: SIMPLE con pRefCell 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, residualControl p/U 1e-8.
  • system/controlDict: simpleFoam, endTime 3000 iteraciones, objeto de función forces (patches (innerWall), rho rhoInf; rhoInf 1000;, CofR (0 0 0), writeInterval 5). v2412 escribe force.dat y moment.dat (archivos separados), no forces.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 apt scripteada en scripts/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)

Skills relacionados