Visualizer

Features

  • Based on dash-cytoscape.

  • Visualize small and large (10000+ nodes) networks

  • Explore attributes of nodes and branches

  • Highlight specific nodes and branches

  • Visualize various layouts, including hierarchical, force-directed and coordinate-based layouts

  • Export as a standalone HTML file for sharing or offline viewing

With Coordinates

Hierarchical

Force-Directed

Coordinates

Hierarchical

Force-Directed

Quickstart

Installation

pip install 'power-grid-model-ds[visualizer]'  # quotes added for zsh compatibility

Usage

from power_grid_model_ds import Grid
from power_grid_model_ds.visualizer import visualize
from power_grid_model_ds.generators import RadialGridGenerator

grid = RadialGridGenerator(Grid).run()
visualize(grid)

This will start a local web server at http://localhost:8050

Saving to HTML

To save a visualization as a standalone HTML file that can be shared or opened later without a running Python server, this does not contain advanced interaction but the graph only:

from power_grid_model_ds import Grid
from power_grid_model_ds.visualizer import save_html
from power_grid_model_ds.generators import RadialGridGenerator

grid = RadialGridGenerator(Grid).run()
save_html(grid, "my_grid.html")

# With options:
save_html(grid, "my_grid.html", layout="cose", include_appliances=True)

The generated file embeds the graph data and Cytoscape.js and supports pan, zoom, and click interactions in any browser.

Disclaimer

Please note that the visualizer is still a work in progress and may not be fully functional or contain bugs. We welcome any feedback or suggestions for improvement.