monee 1.0.1

Framework for calculating the steady-state energy flow and for solving optimization problems in coupled energy grids (gas, heat, electricity)

PyPi | Docs

The python project monee (a Modular Network-based Energy Grid Optimization) can be used to calculate the steady-state energy flow of coupled grids (electricity, water (heating), gas). It is also capable to flexibly formulate and solve optimal energy flow problems. For this monee currently uses GEKKO to solve these problems (further integrations are planned).

Further, there are unique key aspects of monee such as:

• Timeseries simulation
• Native support of multi-energy components as P2H/CHP/P2G
• Integration of networkx as main internal datastructure, this enables easy appliance of graph-based approaches.
• Modular component definitions
• Importing of MATPOWER networks
• Restricted import of pandapower and therefore simbench networks.

Installation

The monee framework is hosted on pypi, as such you can install it with:

pip install monee

Examples

Creating a network (express API)

from monee import mx, run_energy_flow

# create multi-grid container the monee.Network
net = mx.create_multi_energy_network()

# electricity grid
bus_0 = mx.create_bus(net)
bus_1 = mx.create_bus(net)

mx.create_line(net, bus_0, bus_1, 100, r_ohm_per_m=0.00007, x_ohm_per_m=0.00007)
mx.create_ext_power_grid(net, bus_0)
mx.create_power_load(net, bus_1, 0.1, 0)

# water-based district heating grid
junc_0 = mx.create_water_junction(net)
junc_1 = mx.create_water_junction(net)
junc_2 = mx.create_water_junction(net)

mx.create_ext_hydr_grid(net, junc_0)
mx.create_water_pipe(net, junc_0, junc_1, diameter_m=0.12, length_m=100)
mx.create_sink(net, junc_2, mass_flow=1)

# creating connection between el and water grid
mx.create_p2h(net, bus_1, junc_1, junc_2, heat_energy_mw=0.1, diameter_m=0.1, efficiency=0.9)

# execute an energy flow calculating the energy flow for the whole MES
result = run_energy_flow(net)