Ruta: Python para hidrología
A dónde llegas
Sección titulada «A dónde llegas»Al final puedes escribir un programa que, para una cuenca y un periodo de retorno:
- calcule la lluvia de diseño y su riesgo de excedencia;
- convierta esa lluvia en escorrentía con el número de curva;
- reparta el agua en el tiempo con un hidrograma unitario;
- transite la crecida por un tramo de río;
- ajuste una distribución a los máximos anuales y dé el caudal con su intervalo;
- ajuste la IDF de una tabla regional y diga la incertidumbre de sus parámetros;
- separe el flujo base de una serie diaria y explique qué convención usó;
- entregue la punta y el volumen con sus apellidos:
T, duración,CN,Δty método.
Antes de empezar
Sección titulada «Antes de empezar»- Python 3.11 o superior y Visual Studio Code. Si no los tienes, el capítulo Primeros pasos de la Etapa 0 explica la instalación.
- Las etapas 0 a 2 no necesitan librerías; la 3 necesita
pip install -r requirements.txt(NumPy y SciPy). - Sí hace falta una cuenca: área,
CNy tiempo de concentración. Sin ellos el ejercicio es aritmética. - La regla que no se salta: 1 mm sobre 1 km² son 1 000 m³. Se escribe una vez, en una función con nombre.
Etapa 0 · Fundamentos (5 h)
Sección titulada «Etapa 0 · Fundamentos (5 h)»Para quien nunca ha programado. Si ya programas, sáltala.
| # | Capítulo | Qué te llevas |
|---|---|---|
| 1 | Qué es un lenguaje | Qué hace un programa |
| 2 | Contar una historia | Nombres, unidades y orden: datos, cálculo, decisión, informe |
| 3 | Primeros pasos | Instalar Python, ejecutar un archivo, leer errores |
| 4 | Variables y unidades | Números, unidades, f-strings |
| 5 | Decisiones | if para el umbral P > Ia, y for para recorrer |
| 6 | Funciones | def, parámetros, return |
| 7 | La viga completa | Un programa con informe, de principio a fin |
| 8 | Listas, diccionarios, import y errores |
Tablas de datos, math y try |
Prueba de la etapa: escribe una función lamina(i, d) que devuelva i·d/60 y compruébala con i = 59.15 y d = 60: debe dar 59.15 mm.
Etapa 1 · Listas y registros (2 h)
Sección titulada «Etapa 1 · Listas y registros (2 h)»Cómo leer esta etapa. Estos capítulos son de nivel profesional: su ficha pide capítulos de la Parte I y buena parte de su texto explica cómo funciona Python por dentro y cuánto cuesta. Para esta ruta no hace falta. El requisito real es el capítulo 09 de la Parte 0, y de cada capítulo basta la parte de uso: «En una línea», los primeros ejemplos, «La trampa» y el ejercicio. Lo de dentro —tablas hash, mediciones, CPython— es opcional; vuelve cuando te pique la curiosidad. En Secuencias quédate con la lista y sus rebanadas; en Registros, con dataclass, que es lo que pide la prueba; en Funciones como objetos, con que una función se puede pasar como argumento.
| # | Capítulo | Qué te llevas |
|---|---|---|
| 1 | Secuencias | El hietograma es una lista |
| 2 | Registros | dataclass para la cuenca |
| 3 | Funciones como objetos | Pasar la función de escorrentía como argumento |
Prueba de la etapa: modela la cuenca con dataclass (area_km2, cn, tc) y escribe una función que devuelva su volumen de escorrentía para una lámina dada.
Etapa 2 · Los modelos (9 h)
Sección titulada «Etapa 2 · Los modelos (9 h)»| # | Capítulo | Qué te llevas |
|---|---|---|
| 1 | Precipitación e IDF | T, riesgo y lámina |
| 2 | Escorrentía y CN | S, Ia y el umbral |
| 3 | Hidrograma unitario | tp, qp y convolución |
| 4 | Tránsito de crecidas | K, X y la ventana de Δt |
| 5 | El caso completo | Las cinco piezas encadenadas |
| 6 | Tránsito en embalse | Puls, cota-volumen y aliviadero |
Prueba de la etapa: reproduce i(25, 60) = 59.15 mm/h, Q = 0 exactamente cuando P = Ia, el volumen de 1 mm de hidrograma unitario (2499 m³ sobre 2.5 km²) y la suma de coeficientes de Muskingum (1.0000).
Etapa 3 · Estadística con SciPy (7 h)
Sección titulada «Etapa 3 · Estadística con SciPy (7 h)»Los dos primeros capítulos son el paso previo: los cuatro de hidrología dan por sabido qué es un array y cómo se llama a SciPy. De ambos basta la parte de uso.
| # | Capítulo | Qué te llevas |
|---|---|---|
| 1 | Vectorizar con NumPy | Qué es un array y por qué se opera sin bucle |
| 2 | SciPy | Raíces, integrales y scipy.stats ya resueltos |
| 3 | Frecuencia con Gumbel | gumbel_r.fit y el error del cuantil |
| 4 | Log-Pearson III | Bondad de ajuste y el jacobiano |
| 5 | Ajuste de la IDF | curve_fit y la covarianza |
| 6 | Flujo base | Filtros recursivos con la restricción en el bucle y el BFI |
Prueba de la etapa: reproduce x_100 = 116.3 m³/s con Gumbel y su error estándar 9.17; comprueba que AIC de Gumbel (250.82) es menor que el de LP3 (252.53) después de la corrección del jacobiano; y obtén corr(A,b) = 0.967 en el ajuste de la IDF. Si el AIC sale al revés, te falta el jacobiano.
Etapa 4 · El caso (3 h)
Sección titulada «Etapa 4 · El caso (3 h)»| Qué hacer | Dónde |
|---|---|
| Calcular la lluvia de diseño de tu cuenca | Capítulo 1 |
| Convertirla en lluvia neta | Capítulo 2 |
| Obtener el hidrograma de entrada | Capítulo 3 |
| Transitarlo si hay un tramo aguas abajo | Capítulo 4 |
| Montar la cadena y comprobar el volumen | Capítulo 5 |
| Cruzar el resultado con la frecuencia de la serie | Capítulo 6 |
Prueba final: produce una tabla con la lluvia de diseño, la lluvia neta, el C, la punta de entrada, la punta de salida, el volumen y —si hay aforos— el caudal de la misma T por frecuencia. Cada número con su unidad, su método y su intervalo. Si algún caudal sale sin intervalo ni método, el informe está incompleto.
La trampa de la ruta
Sección titulada «La trampa de la ruta»Qué viene después
Sección titulada «Qué viene después»- Hidrología urbana: alcantarillado y drenaje de ciudades. No está cubierto.
- Modelos distribuidos y calibración: HEC-HMS y series observadas. Fuera del alcance.
- No estacionariedad y tendencias: qué hacer cuando la serie de 30 años no es una muestra del mismo proceso. Se advierte en el capítulo 6, no se resuelve.
- Hidráulica: si el caudal tiene que pasar por un canal o una tubería, la ruta de hidráulica es el complemento natural.