Documentación Base – Cálculo Hidráulico (Gas y Líquido)

1. Objetivo

Este documento describe la estructura actual del módulo de cálculo hidráulico dentro del proyecto, incluyendo:

• Arquitectura general

• Módulos y funciones existentes

• Entradas y salidas

• Librerías utilizadas

• Modelo de cálculo

• Riesgos identificados

Sirve como base antes de integrar NeqSIM para equipos y elementos avanzados.

---

2. Arquitectura General

Capas del sistema

Capa	Archivo / módulo	Rol
UI	app.ipynb	Punto de entrada en JupyterLab
UI	src/ui/flow_ui.py	Interfaz tabular, filtros, ejecución de cálculo
Lógica	src/logic/gas_calc.py	Cálculo hidráulico para gas
Lógica	src/logic/liquid_calc.py	Cálculo hidráulico para líquido
DB	src/db/connection.py	Conexión a SQL Server

---

3. Flujo de Operación

1. El usuario selecciona:

   • Empresa

   • Proyecto

   • Línea

   • ISO

2. Se cargan datos desde base de datos.

3. Se muestran en una tabla editable (ipysheet).

4. Cada fila representa un tramo hidráulico.

5. Se ejecuta el cálculo mediante botón Calcular Flujo.

6. Se genera un DataFrame de resultados.

7. Los resultados se exportan a SQL Server.

---

4. Funciones Principales

4.1 Gas

def calcular_gas(df_input):
    return df_resultados