ES — Herramienta web de tamizaje (screening) para proyectos de Combustión In Situ (ISC) en recuperación mejorada de petróleo (EOR). EN — Web-based screening tool for In-Situ Combustion (ISC) enhanced oil recovery (EOR) projects.
Una aplicación web autocontenida para la evaluación temprana (nivel de tamizaje) de candidatos a combustión in situ. Guía al usuario por una Evaluación guiada ISC por etapas: contexto, prefactibilidad, operabilidad, física de combustión, pronóstico y análisis de incertidumbre.
Importante: es una herramienta de tamizaje y decisión temprana. No sustituye la simulación numérica de yacimientos ni pruebas de laboratorio (tubos de combustión).
- Screening clásico con criterios de la literatura (Nelson & McNeil, correlaciones de requerimiento de aire y combustible).
- Física de combustión: eficiencia térmica (Marx & Langenheim), estequiometría (Benham & Poettmann), cinética de Arrhenius, combustión húmeda.
- Operabilidad: inyectividad (Theis), espaciamiento, área de respuesta.
- Pronóstico y economía a nivel de tamizaje, con exportación de reporte HTML autocontenido.
- Cuantificación de incertidumbre: Monte Carlo, expansión de caos polinomial (PCE) e índices de Sobol.
- Chat IA integrado (opcional, Google Gemini) fundamentado en el manual técnico de la herramienta.
- Interfaz bilingüe ES/EN.
Requiere Python 3.9+.
pip install -r requirements.txt
uvicorn main:app --reload
# abrir http://127.0.0.1:8000El chat IA es opcional. Para habilitarlo, define la variable de entorno:
export GEMINI_API_KEY="tu_api_key"Sin esa variable la aplicación funciona normalmente, con el chat deshabilitado.
pytest| Ruta | Contenido |
|---|---|
main.py |
Backend FastAPI (motor de cálculo y API) |
index.html |
Interfaz de usuario (single-page) |
academia.html |
Módulo Academia (material conceptual) |
kinetics.py, wet_combustion.py, reporting.py |
Física y reportes |
advanced/ |
Módulos avanzados: UQ, PCE, DCA bayesiano, inyectividad |
isc_chat.py, isc_db.py, isc_ratelimit.py |
Chat IA (Gemini) y persistencia |
knowledge_base/ |
Base de conocimiento del chat (manual técnico en texto) |
tests/ |
Suite de pruebas |
Distribuido bajo licencia MIT (ver LICENSE). Si usas esta herramienta en trabajo académico o técnico, cita:
Rey Mateus, J. A., & Soto Ramirez, C. J. (2026). ISC Web Screening: herramienta de tamizaje para combustión in situ. https://github.com/jsry80/isc_web_screening
A self-contained web application for early-stage (screening-level) evaluation of in-situ combustion candidates. It walks the user through a staged Guided ISC Assessment: context, pre-feasibility, operability, combustion physics, forecasting, and uncertainty analysis.
Important: this is a screening / early-decision tool. It does not replace numerical reservoir simulation or laboratory work (combustion tube tests).
- Classic screening against published criteria (Nelson & McNeil; air and fuel requirement correlations).
- Combustion physics: thermal efficiency (Marx & Langenheim), stoichiometry (Benham & Poettmann), Arrhenius kinetics, wet combustion.
- Operability: injectivity (Theis), well spacing, response area.
- Screening-level forecast and economics, with a self-contained HTML report export.
- Uncertainty quantification: Monte Carlo, polynomial chaos expansion (PCE), and Sobol indices.
- Built-in AI chat (optional, Google Gemini) grounded on the tool's technical manual.
- Bilingual ES/EN interface.
Requires Python 3.9+.
pip install -r requirements.txt
uvicorn main:app --reload
# open http://127.0.0.1:8000The AI chat is optional. To enable it, set:
export GEMINI_API_KEY="your_api_key"Without it, the application runs normally with the chat disabled.
pytestReleased under the MIT license (see LICENSE). If you use this tool in academic or technical work, please cite:
Rey Mateus, J. A., & Soto Ramirez, C. J. (2026). ISC Web Screening: a screening tool for in-situ combustion. https://github.com/jsry80/isc_web_screening