HydroPy

HydroPy es una aplicación de escritorio para el predimensionamiento y la verificación preliminar de instalaciones hidráulicas domiciliarias. Reúne cálculos de agua potable, desagüe pluvial, desagüe cloacal y selección de bombas en una interfaz gráfica con proyectos JSON editables.

Warning

HydroPy es una herramienta de apoyo. No reemplaza el proyecto ejecutivo, la firma del profesional responsable, las fichas de los fabricantes ni la aprobación de la autoridad competente. Antes de construir se deben confirmar cotas, materiales, diámetros interiores, accesorios, curvas de bombas, curva IDF y normativa vigente.

Descargar

• HydroPy 0.2.0 para Windows
• Manual de Usuario en PDF
• Todas las versiones publicadas

El ejecutable incluye Python, Tkinter, Matplotlib y los cuatro calculadores. No requiere instalación; basta con descargarlo y abrirlo. El primer inicio puede tardar unos segundos. Windows SmartScreen puede mostrar una advertencia porque el archivo todavía no posee firma digital.

Cálculos disponibles

Módulo	Entrada de ejemplo	Resultados principales
Agua potable NP 68	red.json	Caudal probable, DN, velocidad, pérdidas y presión residual
Desagüe pluvial	pluvial.json	Área efectiva, caudal racional, DN, capacidad, llenado y velocidad
Desagüe cloacal NP 44	cloacal.json	Unidades de descarga, DN normativo y pendiente mínima
Bombas	bomba.json	Punto Q-H, ADT, potencia, motor, tuberías y NPSH

Uso rápido

1. Abra HydroPy-0.2.0.exe o ejecute python -m hidropy desde el código fuente.
2. Elija uno de los cuatro módulos.
3. Pulse Ejemplo para cargar un proyecto válido o Abrir para seleccionar un JSON propio.
4. Edite los datos. El editor indica línea y columna y marca la ubicación de errores JSON.
5. Pulse Calcular para obtener la tabla de resultados y, en los módulos de redes, el gráfico del sistema.
6. Revise las advertencias antes de guardar el proyecto o exportar la gráfica.

Las redes se representan como árboles. Cada nodo declara su padre; la raíz usa null. En agua, la raíz es la fuente o el tanque. En pluvial y cloacal, la raíz representa la salida final.

Ejemplo mínimo de agua potable

{
  "tanque": {
    "padre": null,
    "cota_m": 6.0,
    "presion_mca": 0.0
  },
  "lavadero": {
    "padre": "tanque",
    "longitud_m": 9.0,
    "cota_m": 2.8,
    "artefactos": {
      "pileta_lavar": 1
    }
  }
}

Los campos más habituales son:

• padre: nodo al que se conecta el tramo, o null para la raíz.
• longitud_m: longitud del tramo en metros.
• cota_m: elevación del nodo.
• presion_mca: presión disponible en la raíz, en metros de columna de agua.
• artefactos: cantidades asociadas al nodo.
• pendiente_pct: pendiente porcentual para redes pluviales y cloacales.
• area_m2: superficie contribuyente en el cálculo pluvial.

Los módulos de agua y cloacal aceptan alias habituales como lavabo, lavamanos, fregadero, tina, lavadora y lavaplatos. También admiten catalogo_artefactos para equipos personalizados; sus valores deben justificarse mediante una ficha técnica o criterio profesional.

Ejecutar desde el código fuente

Desde la raíz del proyecto:

python -m hidropy

Los motores también pueden utilizarse sin la interfaz:

python dimensionar_agua_np68.py red.json --sin-grafico
python dimensionar_pluvial.py pluvial.json --sin-grafico
python dimensionar_cloacal.py cloacal.json --sin-grafico
python dimensionar_bomba.py bomba.json

Las redes aceptan --guardar archivo.png para exportar su gráfico. El módulo pluvial permite además reemplazar la intensidad con --intensidad VALOR.

Desarrollo y verificación

Ejecutar todas las pruebas:

python -m unittest discover -s tests -v

Generar y verificar el manual:

python manual/generar_manual.py
python manual/verificar_manual.py

Compilar el ejecutable de Windows con PyInstaller:

powershell -ExecutionPolicy Bypass -File .\compilar_hidropy.ps1

El ejecutable se genera en dist/HydroPy.exe; build/, dist/, release/, output/ y tmp/ son artefactos locales excluidos del repositorio.

Criterios técnicos y comprobaciones

El módulo de agua utiliza la copia de la NP 68 incluida en el repositorio y el módulo cloacal utiliza las tablas de la NP 44. El cálculo pluvial aplica el método racional y la ecuación de Manning con parámetros configurables. El módulo de bombas entrega una selección preliminar que siempre debe contrastarse con la curva del fabricante.

Antes de aprobar un resultado compruebe, como mínimo:

• topología, cotas, longitudes y unidades de los datos;
• presión residual y límites de velocidad en agua potable;
• intensidad IDF, sumideros, bajadas y reboses en pluvial;
• pendientes, ventilación, sifones y registros en cloacal;
• punto de operación, rendimiento, motor y NPSH en bombas.

Consulte el Manual de Usuario para conocer todos los campos, ejemplos, tablas de referencia, mensajes de error y listas de comprobación.

Autor y soporte

HydroPy es una aplicación de TecnoSurf desarrollada por Juan Molinas.

• Sitio: www.tecnosurf.com
• Aplicación web: tecnosurf-2.firebaseapp.com
• Correo: juan@tecnosurf.com
• Teléfono publicado: +959984 467 989

Copyright © 2026 TecnoSurf. Todos los derechos reservados.