monee visualization

Network plots

Annotated interactive graph visualization for Network.

Entry point: plot_network().

monee.visualization.visualization.plot_network(network: monee.model.network.Network, title: str | None = None, show_children: bool = True, use_monee_positions: bool = False, write_to: str | None = None)[source]

Plot a Network as an annotated interactive graph.

Nodes are colored by energy-carrier type (electricity, heat/water, gas, coupling point). Branch midpoints show compact parameter labels. Hovering over any element reveals the full set of scalar model parameters.

Parameters:

  • network (monee.model.network.Network) – The Network to visualise.

  • title (str | None) – Figure title. Defaults to "Network".

  • show_children (bool) – Show attached child components (loads, generators, …) in the parent node’s hover tooltip.

  • use_monee_positions (bool) – Use stored node.position coordinates instead of the automatic graph layout.

  • write_to (str | None) – Optional path to export the figure (PDF / PNG / SVG).

Returns:

plotly.graph_objs._figure.Figure – A plotly.graph_objects.Figure.

Result plots

Annotated interactive graph visualization for SolverResult.

Entry point: plot_result().

monee.visualization.result_visualization.plot_result(result: monee.solver.core.SolverResult, title: str | None = None, show_children: bool = True, use_monee_positions: bool = False, write_to: str | None = None)[source]

Plot a SolverResult as an annotated interactive network graph.

Node coloring (traffic-light):

  • Electrical buses: green when vm_pu ∈ [0.95, 1.05], yellow for [0.90, 0.95) or (1.05, 1.10], red otherwise.

  • Gas / water junctions: neutral gray with the current pressure_pu as an inline label.

Branch coloring (traffic-light):

  • Power lines / transformers: green < 70 %, yellow 70–90 %, red ≥ 90 % loading.

  • Hydraulic pipes: green, labeled with mass flow (kg/s).

  • Multi-grid (CP) branches: dotted.

Hover over any node or branch to see the full result table for that component. Children (loads, generators, ext-grids, …) are listed in their parent node’s hover text when show_children is True.

Parameters:

  • result (monee.solver.core.SolverResult) – The SolverResult to visualise.

  • title (str | None) – Figure title. Defaults to "Network Result".

  • show_children (bool) – Include child components in parent-node hover text.

  • use_monee_positions (bool) – Use stored node.position coordinates.

  • write_to (str | None) – Optional path to export the figure (PDF / PNG / SVG).

Returns:

plotly.graph_objs._figure.Figure – A plotly.graph_objects.Figure.