uesgraphs.examples.e10_networks_example

Example Network Generator for UESGraphs

This module provides functionality to generate example district heating networks. It includes predefined network topologies that can be used for testing, demonstration, and validation purposes.

Main Features:

• Generation of two example networks: ‘Pinola’ and ‘IBPSA’

• Coordinate transformation for Modelica compatibility

• Time series data generation for temperatures and heat inputs

• Network topology creation with detailed pipe specifications

Example Networks:

1. IBPSA Network: - Based on the PlugFlowAIT model from the IBPSA Library - Contains 1 supply building, 3 demand buildings, and 2 heating network nodes - Includes realistic pipe parameters and thermal properties - Reference: doi: 10.1016/j.enconman.2017.08.072

2. Pinola Network: - Hybrid network combining IBPSA model and Larock 424 example - Features 2 supply buildings, 3 demand buildings, and 3 heating network nodes - Complete with pipe specifications and thermal parameters

Functions:

make_network_ibpsa(dir_dest):

Creates the IBPSA example network with predefined topology

make_network_pinola(dir_dest):

Creates the Pinola example network with predefined topology

convert_positions(ues_network, width_set):

Transforms network coordinates for Modelica compatibility

get_temperature_ground():

Returns ground temperature time series data

get_temperature_supply():

Returns supply temperature time series data

get_input_heat():

Returns heat input time series data for demand buildings

Notes:

• All networks are exported with complete metadata for simulation purposes

• Time series data uses 900-second time steps

• Coordinates are automatically adjusted for Modelica model generation

• Network parameters are based on realistic district heating system values

Functions

convert_positions(ues_network[, width_set])	Translate node positions onto a Modelica-ready canvas
get_input_heat()	Return the map for heat input
get_temperature_ground()	Returns a time series of ground temperature from IBPSA example
get_temperature_supply()	Returns a time series of supply temperature from IBPSA example
main()
make_network_ibpsa(dir_dest)	Creates a graph corresponding to the PlugFlowAIT model in IBPSA
make_network_pinola(dir_dest)	Creates a graph of the "Pinola" network

uesgraphs.examples.e10_networks_example.main()

uesgraphs.examples.e10_networks_example.convert_positions(ues_network, width_set=4000)

Translate node positions onto a Modelica-ready canvas

Parameters:

• ues_network (uesgraphs.uesgraph.UESGraph object) – An uesgraphs representation of the cooling network

• width_set (float) – Width of the Modelica-ready canvas after translation

Returns:

ues_network – An uesgraphs representation of the cooling network

Return type:

uesgraphs.uesgraph.UESGraph object

uesgraphs.examples.e10_networks_example.make_network_ibpsa(dir_dest)

Creates a graph corresponding to the PlugFlowAIT model in IBPSA

The Modelica IBPSA Library (and thus AixLib, too) contains a benchmark network that was also used in the following paper: doi: 10.1016/j.enconman.2017.08.072

The model is at AixLib.Fluid.FixedResistances.Validation.PlugFlowPipes.PlugFlowAIT

This function returns the UESGraph representing the network

Parameters:

dir_dest (str) – Path where a nodes.json export of the network will be stored

Returns:

graph_network – Graph of the network

Return type:

uesgraphs.uesgraph.UESGraph

uesgraphs.examples.e10_networks_example.make_network_pinola(dir_dest)

Creates a graph of the “Pinola” network

The Modelica IBPSA Library (and thus AixLib, too) contains a benchmark network that was also used in the following paper: doi: 10.1016/j.enconman.2017.08.072

The model is at AixLib.Fluid.FixedResistances.Validation.PlugFlowPipes.PlugFlowAIT

This function returns the UESGraph representing a network that is a mix between the IBPSA model and the Larock 424 example

Parameters:

dir_dest (str) – Path where a nodes.json export of the network will be stored

Returns:

graph_network – Graph of the network

Return type:

uesgraphs.uesgraph.UESGraph

uesgraphs.examples.e10_networks_example.get_temperature_ground()

Returns a time series of ground temperature from IBPSA example

uesgraphs.examples.e10_networks_example.get_temperature_supply()

Returns a time series of supply temperature from IBPSA example

uesgraphs.examples.e10_networks_example.get_input_heat()

Return the map for heat input