sxs

Projecte SuperSonic (sxs)

🌐 Pàgina principal: Projecte SuperSònc (sxs)

Informe mesures de cabal Euromed

Aquest projecte recull els resultats del treball realitzat per mesurar cabals en diferents punts de la fàbrica d’Euromed mitjançant el cabalímetre supersònic Flexim (Fluxus G608). L’objectiu és automatitzar el processament de dades, la generació d’informes i la visualització geoespacial i de fluxos.

📑 Informes automatitzats report

Informe aigua torres (AT)

Informe vapor (STE)

🗺️ Mapes de punts de mesura mapa

Mapa mesures aigua torres (AT)

Mapa mesures vapor (STE)

📊 Diagrama Sankey (Balanç de fluxos) sankey

Sankey aigua torres (AT)

Sankey vapor (STE)

sankey_nodes-at_20260417_1152.html -–

📂 Estructura del repositori

sxs/
├── run_sxs.bat             # Script d'execució ràpida per llançar la interfície (GUI).
├── README.md               # Aquest document
├── requirements.txt
├── .gitignore
├── src/                    # Codi font del projecte (Python).
│   ├── gui_2.py            # Interfície gràfica principal (SXS Tools).
│   ├── selection_layer.py  # Lògica de selecció de fitxers i columnes per a la GUI.
│   ├── config.py           # Configuració centralitzada de rutes i fitxers constants.
│   ├── add_date.py         # Script per normalitzar noms de fitxers CSV afegint la data.
│   ├── excel2csv.py        # Utilitat per convertir fulls d'Excel a format CSV.
│   ├── create_plots.py     # Generació de gràfics (batch processing i previsualització).
│   ├── create_tkinter.py   # Visualitzador interactiu de punts sobre el plànol de la planta.
│   ├── create_sankey.py    # Generació de diagrames de flux (Sankey) en HTML.
│   ├── create_report_html.py # Generador d'informes interactius en format HTML (Quarto).
│   ├── create_report_pdf.py  # Generador d'informes en format PDF (Quarto).
│   ├── points_dict.py      # Diccionari de traducció d'IDs de punts a noms descriptius.
│   └── gui.py              # Legacy.
├── data/                   # Dades d'entrada.
│   ├── raw/                # Fitxers CSV bruts obtinguts de les mesures.
│   ├── punts/              # Llistat de punts de mesura (punts-mesura-ste.csv, etc.).
│   ├── sankey/             # Fitxers de nodes i fluxos per als diagrames Sankey.
│   └── planol/             # Imatges de fons (PNG) per als mapes de la planta.
└── outputs/                # Fitxers generats pel programari.
    ├── plots/              # Gràfiques exportades en format PNG (es crea automàticament)
    ├── sankey/             # Diagrames de flux exportats.
    ├── mapa-at/            # Mapa amb els punts de mesura d'aigua de torres
    ├── mapa-ste/           # Mapa de la fabrica amb els punts de mesura de vapor
    └── report/             # Html reports dels grafics obtinguts de les mesures

-–

🛠️ Implementació Tècnica i Arquitectura

El sistema s’ha dissenyat com una suite modular de processament de dades que segueix una arquitectura de pipeline lineal:

1. Arquitectura d’Alt Nivell

1. Ingesta: Recollida de fitxers CSV del cabalímetre Flexim G608.
2. Estandardització: Extracció de metadades i dates per a l’organització automàtica.
3. Transformació: Sincronització de configuracions en Excel amb el backend de Python.
4. Visualització: Creació de gràfics de sèries temporals, diagrames Sankey i mapes interactius.
5. Generació d’Informes: Consolidació de resultats mitjançant Quarto.

2. Detall dels Mòduls Principal (src/)

• gui.py: El panell de control principal basat en Tkinter que permet executar totes les tasques sense línia de comandes.
• add\_date.py: Crucial per a l’organització; llegeix el contingut dels CSV bruts, extreu la data d’inici i canvia el nom dels fitxers a un format ordenable: AAAAMMDD\_HHMMSS\_Punt.csv.
• create\_sankey.py: Utilitza plotly.graph\_objects per calcular balanços de cabal entre nodes d’origen i destí definits en la configuració.
• create\_tkinter.py \& selection\_layer.py: Visualitzador de mapes interactiu que superposa punts de mesura sobre els plànols .png, permetent veure velocitats de cabal de forma espacial.
• config.py: Centralitza totes les rutes del projecte utilitzant pathlib per garantir la portabilitat entre sistemes.

3. Flux de Treball i Processament

El flux recomanat per a l’usuari és:

1. Copiar els CSV nous a data/raw/.
2. Executar “Add Date” des de la GUI per estandarditzar els fitxers.
3. Si s’han modificat els punts o nodes a l’Excel, executar “Excel → CSV”.
4. Generar els gràfics (“Batch plot”) i els diagrames (“Sankey”).
5. Generar l’informe final per consolidar les dades.

4. Requisits Tècnics

• Python 3.10+

• Biblioteques clau:

  • pandas: Processament de dades.
  • plotly \& matplotlib: Visualització interactiva i estàtica.
  • tkinter: Interfície gràfica i mapes.
  • Quarto: Cal tenir-lo instal·lat al sistema per generar els informes .html i .pdf.

-–

Autor: Arnau Coronado Nadal
Localització: Mollet del Vallès, abril 2026