Create Collections

Matplotlib collections can be created from pandapower networks with the following functions:

Bus Collections

pandapower.plotting.create_bus_collection(net, buses=None, size=5, patch_type='circle', colors=None, z=None, cmap=None, norm=None, infofunc=None, picker=False, bus_geodata=None, cbar_title='Bus Voltage [pu]', **kwargs)

Creates a matplotlib patch collection of pandapower buses.

Input:

net (pandapowerNet) - The pandapower network

OPTIONAL:
buses (list, None) - The buses for which the collections are created.

If None, all buses in the network are considered.

size (int, 5) - patch size

patch_type (str, “circle”) - patch type, can be

  • “circle” for a circle

  • “rect” for a rectangle

  • “poly<n>” for a polygon with n edges

infofunc (function, None) - infofunction for the patch element

colors (list, None) - list of colors for every element

z (array, None) - array of bus voltage magnitudes for colormap. Used in case of given

cmap. If None net.res_bus.vm_pu is used.

cmap (ListedColormap, None) - colormap for the patch colors

norm (matplotlib norm object, None) - matplotlib norm object

picker (bool, False) - picker argument passed to the patch collection

bus_geodata (DataFrame, None) - coordinates to use for plotting

If None, net[“bus_geodata”] is used

cbar_title (str, “Bus Voltage [pu]”) - colormap bar title in case of given cmap

**kwargs - key word arguments are passed to the patch function

OUTPUT:

pc - patch collection

Branch Collections

pandapower.plotting.create_line_collection(net, lines=None, line_geodata=None, bus_geodata=None, use_bus_geodata=False, infofunc=None, cmap=None, norm=None, picker=False, z=None, cbar_title='Line Loading [%]', clim=None, plot_colormap=True, **kwargs)

Creates a matplotlib line collection of pandapower lines.

Input:

net (pandapowerNet) - The pandapower network

OPTIONAL:
lines (list, None) - The lines for which the collections are created. If None, all lines

in the network are considered.

line_geodata (DataFrame, None) - coordinates to use for plotting. If None,

net[“line_geodata”] is used

bus_geodata (DataFrame, None) - coordinates to use for plotting

If None, net[“bus_geodata”] is used

use_bus_geodata (bool, False) - Defines whether bus or line geodata are used.

infofunc (function, None) - infofunction for the patch element

cmap - colormap for the patch colors

norm (matplotlib norm object, None) - matplotlib norm object

picker (bool, False) - picker argument passed to the patch collection

z (array, None) - array of line loading magnitudes for colormap. Used in case of given

cmap. If None net.res_line.loading_percent is used.

cbar_title (str, “Line Loading [%]”) - colormap bar title in case of given cmap

clim (tuple of floats, None) - setting the norm limits for image scaling

**kwargs - key word arguments are passed to the patch function

OUTPUT:

lc - line collection

pandapower.plotting.create_trafo_collection(net, trafos=None, picker=False, size=None, infofunc=None, cmap=None, norm=None, z=None, clim=None, cbar_title='Transformer Loading', plot_colormap=True, **kwargs)

Creates a matplotlib line collection of pandapower transformers.

Input:

net (pandapowerNet) - The pandapower network

OPTIONAL:
trafos (list, None) - The transformers for which the collections are created.

If None, all transformers in the network are considered.

picker (bool, False) - picker argument passed to the patch collection

size (int, None) - size of transformer symbol circles. Should be >0 and

< 0.35*bus_distance

infofunc (function, None) - infofunction for the patch element

**kwargs - key word arguments are passed to the patch function

OUTPUT:

lc - line collection

pc - patch collection