Saltearse al contenido

Ruta: Python para hidrología

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, Δt y método.
  • 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, CN y 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.

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.

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.

# 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).

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.

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.

  • 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.