oemof.visio 0.0.3a1

A package that contains postprocessing and visualisation tools for oemof-solph models

oemof’s visualisation package

Installation

Use pypi to install the latest version. You can install the version just to plot graphs on oemof-solph results with

pip install oemof.visio

or you can install the extra requirements to also produce an image of the energy system

pip install oemof.visio[network]

You can also clone this repository and install locally with

pip install .

or

pip install .[network]

Special for Windows in case of optional network setting: download Graphviz (https://graphviz.org/download/) install it on your system -> activate “add PATH” variables during installation process otherwise the executable cannot be found. Afterwards, restart your environment.

Examples

Have a look at the plotting examples at the ‘oemof_example’ repository to learn how to create the following examples.

(scientifically correct)

(smooth)

Render energy system

To render the component of an energy system, you can insert this code before you turn your EnergySytem instance into a model (not well suited for very large models).

from oemof.visio import ESGraphRenderer
esgr = ESGraphRenderer(
    <your EnergySystem instance>,
    legend=True,
    filepath="full path including filename without extension",
    img_format="pdf"
)
esgr.render()

Render depth

Since oemof-network release above 0.5.1, the SubNetwork class allows to create energy systems with nested subnodes.

By default esgr.render() will display all the subnodes. However, if you want to hide complexity of subnodes you can use esgr.render(max_depth=2) to hide all subnodes with depth greater than 2 within their parent.

Sankey diagramm

To produce a sankey diagramm from the raw oemof-solph results you can use this code snippet into your own model file

import plotly.io as pio

from oemof.visio import ESGraphRenderer
esgr = ESGraphRenderer(<your EnergySystem instance>)

# after the solve method of the model has been called
results = solph.processing.results(model)
fig_dict = esgr.sankey(results)
pio.show(fig_dict)