uesgraphs.examples.e13_analyze_uesgraphs_example

Analysis and Visualization of Dymola Simulation Results

This module processes and visualizes simulation results from Dymola for UESGraphs-generated district heating network models. It demonstrates the analysis workflow from loading simulation data to creating network visualizations with key performance indicators.

Prerequisites:

  1. Network Definition: - Requires a network definition file (nodes.json) generated by example e11 - Contains network topology and component parameters

  2. Simulation Data: - Dymola simulation results in either .mat or .parquet.gzip format - Example data provided in uesgraphs/data/ - Results must be from AixLib v2.1.0 models

Features:

  • Loads network topology from JSON

  • Processes Dymola simulation results

  • Assigns time series data to network components

  • Generates network visualizations with: * Mass flow distribution * Pressure distribution * Time-averaged performance indicators

Data Processing:

  1. Data Format Handling: - Checks for compressed data in .parquet.gzip format - If only .mat file exists:

    • Converts data using mat_handler.py

    • Stores intermediate results in compressed .parquet.gzip format

    • Uses compressed format for further processing

    • Subsequent runs use cached .parquet.gzip file for improved performance

  2. Data Assignment: - Maps time series data to network components - Processes both extensive and intensive properties - Calculates time averages for visualization

Required Input Files:

  1. nodes.json: Network topology and parameters

  2. simulation_results.mat or parquet with .gzip compression: Dymola simulation output

    (If only .mat is available, will be converted to .gzip with mat_handler.py)

Output:

  1. Network visualizations:

    • Mean Mass flow distribution (m_flow.png)

    • Mean Pressure distribution (press_flow.png)

Notes:

  • Simulation period can be specified (default: one week)

  • Visualization uses time-averaged values for certain properties

  • AixLib version must be specified for correct data mapping

  • All paths are relative to the workspace directory

Functions

main()

uesgraphs.examples.e13_analyze_uesgraphs_example.main()[source]