Repertorio verificable de ejemplos

Este repertorio te ayuda a encontrar una implementación después de estudiar su lección. No es una ruta paralela ni una página para leer de arriba abajo.

Cada script es la única fuente ejecutable, acepta --output DIR, produce un resumen JSON y declara un criterio cuantitativo. Usa --quick para una ejecución breve y --write-fields cuando el ejemplo permita exportar campos.

Núcleo común

#	Ejemplo	Estudia primero	Evidencia	Código
00	sanity check	orientación	versiones y celdas globales	.py
01	Poisson manufacturado	primer problema	tasas L2/H1	.py
02	interpolación P1/P2	objetos DOLFINx	tasas de interpolación	.py
03	fronteras etiquetadas	mallas y fronteras	medidas del contorno	.py
04	espacios de funciones	elementos y espacios	DOF globales	.py

Transferencia de calor

#	Ejemplo	Estudia primero	Evidencia	Código
05	difusión transitoria	lección 6	error analítico y energía	.py

Mecánica de sólidos

#	Ejemplo	Estudia primero	Evidencia	Código
06	elasticidad lineal	lección 7	reacción y energía	.py
07	placa con agujero	lección 8	concentración y malla	.py
08	placa de dos materiales	lección 8	continuidad y balance	.py
09	hiperelasticidad	lección 9	SNES, energía y \(J\)	.py

Mecánica de fluidos

#	Ejemplo	Estudia primero	Evidencia	Código
10	canal de Stokes	lección 10	Poiseuille, caudal y divergencia	.py
11	flujo alrededor de cilindro	lección 11	Picard, arrastre y masa	.py

Multifísica

#	Ejemplo	Estudia primero	Evidencia	Código
12	Cahn–Hilliard	lección 12	masa y energía libre	.py

Ejecución

python examples/01_poisson_manufactured.py --quick --output results
python -m mcandes_fenicsx.validation_cli .

Los JSON incluyen example, dolfinx_version, mpi_size, solver_converged y validation_passed. Las pruebas comparan escalares, normas y tendencias; nunca archivos binarios bit a bit.

Cómo leer un script

Busca siempre los mismos ocho bloques:

1. parámetros y comunicador;
2. malla y etiquetas;
3. elemento y espacio;
4. datos, ensayo y prueba;
5. forma débil;
6. condiciones y solver;
7. verificación;
8. salida JSON o campos.

No todos los archivos usan encabezados idénticos, pero deben conservar esa responsabilidad. El objetivo es reconocer el patrón y encontrar qué cambia con la física.

Regla para ampliar el repertorio

Un problema nuevo aparece aquí únicamente cuando entrega, en el mismo cambio:

1. ecuación, dominio, condiciones, parámetros y unidades;
2. script completo y metadata en examples/metadata/;
3. criterio cuantitativo con tolerancia explícita;
4. resultado reproducible y al menos una prueba automatizada;
5. lección o sección que explique por qué el ejemplo ocupa ese lugar;
6. fuente técnica y soporte serial/MPI declarado.

---

Empieza por: mapa del curso · Practica con: ejercicios y soluciones