Llevar un modelo QUAL2K / QUAL2Kw de Excel al motor web

QUAL2K y QUAL2Kw se distribuyen como libros de Microsoft Excel con macros VBA y un ejecutable Fortran. Eso exige Windows y Excel con las macros habilitadas, y los modelos grandes pueden ir lentos o bloquearse dentro de VBA. El motor de Hydrolitica es un port independiente en Python del solucionador de QUAL2Kw 5.1 que corre en el navegador: puedes abrir directamente un libro existente, sin volver a digitar los datos.

Figura 1: De un libro QUAL2Kw a resultados en el navegador

Importar en un solo paso

Abre el motor con el diálogo de importación (o usa Importar libro QUAL2Kw en la barra del motor) y elige tu archivo .xls, .xlsx o .xlsm. El libro se lee en tu navegador; al motor solo se envían los valores de las hojas de entrada, así que los libros grandes (decenas de MB) no son problema.
Lee el informe de importación. Indica qué se trasladó y advierte sobre lo que no (ver la tabla de abajo).
Revisa las tarjetas del asistente y pulsa Ejecutar. Si quieres comprobar el port, compara los resultados con las hojas WQ Output, WQ Min, WQ Max y Temperature Output del propio libro.

Formatos admitidos: QUAL2Kw 5.1 clásico y el formato HTS/STS más reciente. Los libros dendríticos (varios ramales) xQUAL2Kw aún no se pueden importar directamente. En nuestra validación de septiembre de 2026 el motor reprodujo las hojas de resultados de 15 modelos calibrados dentro del 5% (o de una pequeña banda absoluta), y las medias diarias se mantuvieron al pasar cada libro por este importador. Consulta los resultados de la validación.

Excel/VBA frente al motor web

Libro QUAL2Kw frente al motor de Hydrolitica

Tema	Libro QUAL2Kw	Motor de Hydrolitica
Plataforma	Windows con Excel y macros habilitadas	Cualquier navegador moderno (Windows, macOS, Linux, Chromebook)
Cargar un modelo	Edición de celdas en muchas hojas	Importar el libro, el asistente guiado de 14 pasos, o JSON / CSV
Solucionador	VBA y el ejecutable Fortran qual2kw5.exe	Port en Python del solucionador de QUAL2Kw 5.1 (Euler explícito), ejecutado en la nube
Tiempo de corrida	Depende del PC y del modelo	De segundos a unos minutos; el límite es de 300 segundos por corrida
Calibración	Manual, o el algoritmo genético del libro	Autocalibración de 18 tasas cinéticas contra datos observados (cuenta gratuita)
Variables de estado	17 variables de calidad más temperatura	Las mismas 17 más temperatura; el pH se calcula en cada paso
Resultados	Hojas de salida y gráficas	Media, mínimo y máximo diarios por tramo; gráficas, CSV e informe PDF
Guardado	El archivo .xlsm	Guardado en la nube con cuenta, más exportación JSON / CSV

Qué traslada el importador

Hoja del libro a tarjeta del asistente

Hoja del libro	Tarjeta del asistente	Notas
QUAL2K	1. Configuración del proyecto	Nombre, fecha, zona horaria, paso de cálculo y opciones (se leen por etiqueta, así que sirven ambos formatos)
Reach	2. Definición de tramos	Geometría, n de Manning o curvas de calibración, vertederos, cotas, coordenadas
Headwater	3. Cabecera	Caudal, temperatura y calidad del agua
Point Sources	4. Fuentes puntuales	Ubicación, aporte o captación, concentraciones
Diffuse Sources	5. Fuentes difusas	Rango de ubicación, caudal, concentraciones
Rates	6. Tasas cinéticas	Se leen por sección y etiqueta, como las lee el VBA
Reach Rates	7. Tasas por tramo	Valores por tramo, todas las columnas
Light and Heat	8. Luz y calor	Opciones de radiación solar, onda larga y viento
Hojas de meteorología	9. Meteorología	Temperatura del aire y de rocío, viento, nubosidad, sombra
Initial conditions	12. Condiciones iniciales	Valores de arranque, algas de fondo

Qué no se importa

Las cargas de fuentes puntuales que varían durante el día se importan como su media diaria (el asistente no tiene formulario de fuentes puntuales diurnas). El informe de importación lo avisa.
Los datos observados (hoja WQ Data) no se importan: ingresa los objetivos de calibración en la tarjeta de Datos observados.
El VBA personalizado que se haya agregado a un libro no se ejecuta; solo los cálculos estándar de QUAL2Kw.
El método de integración: el motor siempre integra con Euler explícito, así que un libro configurado con Runge-Kutta o paso adaptativo corre con Euler.
La cinética de biopelícula hiporreica y la zona de almacenamiento transitorio superficial (formato HTS/STS) no se simulan; el motor avisa cuando un modelo activa la zona de almacenamiento transitorio.
Libros dendríticos (varios ramales) xQUAL2Kw: sepáralos antes en un libro por ramal.
Un libro sin latitud y longitud en los tramos corre con el sol en 0 grados, 0 grados, igual que QUAL2Kw; el motor avisa.

Problemas frecuentes

Problema	Causa	Solución
La corrida se detiene a los 300 segundos	Modelo grande con paso de cálculo pequeño, sobre todo con diagénesis de sedimentos	Usa un paso de cálculo mayor o divide el río
Aviso solar después de importar	Los tramos no tienen latitud / longitud	Agrega las coordenadas en la configuración del proyecto o en los tramos
OD de saturación demasiado alto	Cota dejada en 0 m	Ingresa las cotas de los tramos
El informe menciona fuentes puntuales diurnas	El libro varía las cargas durante el día	Verifica si la media diaria es aceptable para tu estudio

Si el problema es el propio libro de Excel (Error 53, una detención en ChDir ThisWorkbook.Path, "is aborted!" o macros bloqueadas), consulta errores de QUAL2K y QUAL2Kw y cómo resolverlos.