def draw_net(net, results=None):
scale_size = True
bus_size, ext_grid_size, switch_size = 1., 1., 1.
switch_distance, load_size, sgen_size, trafo_size = 1., 1., 1., 1.
if scale_size:
mean_distance_between_buses = sum(
(net['bus_geodata'].max() - net['bus_geodata'].min()).dropna() /
200)
bus_size *= mean_distance_between_buses
ext_grid_size *= mean_distance_between_buses * 1.5
switch_size *= mean_distance_between_buses * 1
switch_distance *= mean_distance_between_buses * 2
load_size *= mean_distance_between_buses
sgen_size *= mean_distance_between_buses
trafo_size *= mean_distance_between_buses
fp = FontProperties(family="Helvetica", style="italic")
bc = create_bus_collection(net,
net.bus.index,
size=bus_size,
bus_geodata=net.bus_geodata)
use_bus_geodata = len(net.line_geodata) == 0
in_service_lines = net.line[net.line.in_service].index
respect_switches = False
nogolines = set(net.switch.element[(net.switch.et == "l") & (net.switch.closed == 0)]) \
if respect_switches else set()
plot_lines = in_service_lines.difference(nogolines)
lc = create_line_collection(net,
plot_lines,
use_bus_geodata=use_bus_geodata)
buses = net.bus.index.tolist()
coords = zip(net.bus_geodata.loc[buses, "x"].values,
net.bus_geodata.loc[buses, "y"].values)
if results != None:
lambs = [
round(results['bus'][idx, LAM_P], 2)
for idx in net.bus.index.tolist()
]
ac = create_annotation_collection([
' ' + str(b + 1) + ' lam=' + str(l) for b, l in zip(buses, lambs)
],
coords,
0.1,
prop=fp)
else:
ac = create_annotation_collection([str(b + 1) for b in buses], coords,
0.2)
gc = create_gen_collection(net, size=sgen_size * 2)
ec = create_ext_grid_collection(net, size=sgen_size * 2)
collections = [bc, lc, ac, gc, ec]
draw_collections(collections)
def simple_plot(net, respect_switches=False, line_width=1.0, bus_size=1.0, ext_grid_size=1.0,
trafo_size=1.0, plot_loads=False, plot_sgens=False, load_size=1.0, sgen_size=1.0,
switch_size=2.0, switch_distance=1.0, plot_line_switches=False, scale_size=True,
bus_color="b", line_color='grey', trafo_color='k', ext_grid_color='y',
switch_color='k', library="igraph", show_plot=True, ax=None):
"""
Plots a pandapower network as simple as possible. If no geodata is available, artificial
geodata is generated. For advanced plotting see the tutorial
INPUT:
**net** - The pandapower format network.
OPTIONAL:
**respect_switches** (bool, False) - Respect switches if artificial geodata is created.
.. note::
This Flag is ignored if plot_line_switches is True
**line_width** (float, 1.0) - width of lines
**bus_size** (float, 1.0) - Relative size of buses to plot.
The value bus_size is multiplied with mean_distance_between_buses, which equals the
distance between
the max geoocord and the min divided by 200.
mean_distance_between_buses = sum((net['bus_geodata'].max()
- net['bus_geodata'].min()) / 200)
**ext_grid_size** (float, 1.0) - Relative size of ext_grids to plot.
See bus sizes for details. Note: ext_grids are plottet as rectangles
**trafo_size** (float, 1.0) - Relative size of trafos to plot.
**plot_loads** (bool, False) - Flag to decide whether load symbols should be drawn.
**plot_sgens** (bool, False) - Flag to decide whether sgen symbols should be drawn.
**load_size** (float, 1.0) - Relative size of loads to plot.
**sgen_size** (float, 1.0) - Relative size of sgens to plot.
**switch_size** (float, 2.0) - Relative size of switches to plot. See bus size for details
**switch_distance** (float, 1.0) - Relative distance of the switch to its corresponding \
bus. See bus size for details
**plot_line_switches** (bool, False) - Flag if line switches are plotted
**scale_size** (bool, True) - Flag if bus_size, ext_grid_size, bus_size- and distance \
will be scaled with respect to grid mean distances
**bus_color** (String, colors[0]) - Bus Color. Init as first value of color palette.
Usually colors[0] = "b".
**line_color** (String, 'grey') - Line Color. Init is grey
**trafo_color** (String, 'k') - Trafo Color. Init is black
**ext_grid_color** (String, 'y') - External Grid Color. Init is yellow
**switch_color** (String, 'k') - Switch Color. Init is black
**library** (String, "igraph") - library name to create generic coordinates (case of
missing geodata). "igraph" to use igraph package or "networkx" to use networkx package.
**show_plot** (bool, True) - Shows plot at the end of plotting
**ax** (object, None) - matplotlib axis to plot to
OUTPUT:
**ax** - axes of figure
"""
# don't hide lines if switches are plotted
if plot_line_switches:
respect_switches = False
# create geocoord if none are available
if len(net.line_geodata) == 0 and len(net.bus_geodata) == 0:
logger.warning("No or insufficient geodata available --> Creating artificial coordinates." +
" This may take some time")
create_generic_coordinates(net, respect_switches=respect_switches, library=library)
if scale_size:
# if scale_size -> calc size from distance between min and max geocoord
sizes = get_collection_sizes(net, bus_size, ext_grid_size, switch_size,
switch_distance, load_size, sgen_size, trafo_size)
bus_size = sizes["bus"]
ext_grid_size = sizes["ext_grid"]
trafo_size = sizes["trafo"]
sgen_size = sizes["sgen"]
load_size = sizes["load"]
switch_size = sizes["switch"]
switch_distance = sizes["switch_distance"]
# create bus collections to plot
bc = create_bus_collection(net, net.bus.index, size=bus_size, color=bus_color, zorder=10)
# if bus geodata is available, but no line geodata
use_bus_geodata = len(net.line_geodata) == 0
in_service_lines = net.line[net.line.in_service].index
nogolines = set(net.switch.element[(net.switch.et == "l") & (net.switch.closed == 0)]) \
if respect_switches else set()
plot_lines = in_service_lines.difference(nogolines)
# create line collections
lc = create_line_collection(net, plot_lines, color=line_color, linewidths=line_width,
use_bus_geodata=use_bus_geodata)
collections = [bc, lc]
# create ext_grid collections
eg_buses_with_geo_coordinates = set(net.ext_grid.bus.values) & set(net.bus_geodata.index)
if len(eg_buses_with_geo_coordinates) > 0:
sc = create_bus_collection(net, eg_buses_with_geo_coordinates, patch_type="rect",
size=ext_grid_size, color=ext_grid_color, zorder=11)
collections.append(sc)
# create trafo collection if trafo is available
trafo_buses_with_geo_coordinates = [t for t, trafo in net.trafo.iterrows()
if trafo.hv_bus in net.bus_geodata.index and
trafo.lv_bus in net.bus_geodata.index]
if len(trafo_buses_with_geo_coordinates) > 0:
tc = create_trafo_collection(net, trafo_buses_with_geo_coordinates,
color=trafo_color, size=trafo_size)
collections.append(tc)
# create trafo3w collection if trafo3w is available
trafo3w_buses_with_geo_coordinates = [
t for t, trafo3w in net.trafo3w.iterrows() if trafo3w.hv_bus in net.bus_geodata.index and
trafo3w.mv_bus in net.bus_geodata.index and trafo3w.lv_bus in net.bus_geodata.index]
if len(trafo3w_buses_with_geo_coordinates) > 0:
tc = create_trafo3w_collection(net, trafo3w_buses_with_geo_coordinates,
color=trafo_color)
collections.append(tc)
if plot_line_switches and len(net.switch):
sc = create_line_switch_collection(
net, size=switch_size, distance_to_bus=switch_distance,
use_line_geodata=not use_bus_geodata, zorder=12, color=switch_color)
collections.append(sc)
if plot_sgens and len(net.sgen):
sgc = create_sgen_collection(net, size=sgen_size)
collections.append(sgc)
if plot_loads and len(net.load):
lc = create_load_collection(net, size=load_size)
collections.append(lc)
if len(net.switch):
bsc = create_bus_bus_switch_collection(net, size=switch_size)
collections.append(bsc)
ax = draw_collections(collections, ax=ax)
if show_plot:
plt.show()
return ax
def simple_plot(net,
respect_switches=False,
line_width=1.0,
bus_size=1.0,
ext_grid_size=1.0,
scale_size=True,
bus_color="b",
line_color='grey',
trafo_color='k',
ext_grid_color='y',
library="igraph"):
"""
Plots a pandapower network as simple as possible. If no geodata is available, artificial
geodata is generated. For advanced plotting see the tutorial
INPUT:
**net** - The pandapower format network.
OPTIONAL:
**respect_switches** (bool, False) - Respect switches if artificial geodata is created
**line_width** (float, 1.0) - width of lines
**bus_size** (float, 1.0) - Relative size of buses to plot.
The value bus_size is multiplied with mean_distance_between_buses, which equals the
distance between
the max geoocord and the min divided by 200.
mean_distance_between_buses = sum((net['bus_geodata'].max()
- net['bus_geodata'].min()) / 200)
**ext_grid_size** (float, 1.0) - Relative size of ext_grids to plot.
See bus sizes for details. Note: ext_grids are plottet as rectangles
**scale_size** (bool, True) - Flag if bus_size and ext_grid_size will be scaled with
respect to grid mean distances
**bus_color** (String, colors[0]) - Bus Color. Init as first value of color palette.
Usually colors[0] = "b".
**line_color** (String, 'grey') - Line Color. Init is grey
**trafo_color** (String, 'k') - Trafo Color. Init is black
**ext_grid_color** (String, 'y') - External Grid Color. Init is yellow
"""
# create geocoord if none are available
if len(net.line_geodata) == 0 and len(net.bus_geodata) == 0:
logger.warning(
"No or insufficient geodata available --> Creating artificial coordinates."
+ " This may take some time")
create_generic_coordinates(net,
respect_switches=respect_switches,
library=library)
if scale_size:
# if scale_size -> calc size from distance between min and max geocoord
mean_distance_between_buses = sum(
(net['bus_geodata'].max() - net['bus_geodata'].min()) / 200)
# set the bus / ext_grid sizes accordingly
# Comment: This is implemented because if you would choose a fixed values
# (e.g. bus_size = 0.2), the size
# could be to small for large networks and vice versa
bus_size *= mean_distance_between_buses
ext_grid_size *= mean_distance_between_buses * 1.5
# create bus collections ti plot
bc = create_bus_collection(net,
net.bus.index,
size=bus_size,
color=bus_color,
zorder=10)
# if bus geodata is available, but no line geodata
use_bus_geodata = len(net.line_geodata) == 0
in_service_lines = net.line[net.line.in_service].index
nogolines = set(net.switch.element[(net.switch.et == "l") & (net.switch.closed == 0)]) \
if respect_switches else set()
plot_lines = in_service_lines.difference(nogolines)
lc = create_line_collection(net,
plot_lines,
color=line_color,
linewidths=line_width,
use_bus_geodata=use_bus_geodata)
collections = [bc, lc]
eg_buses_with_geo_coordinates = set(net.ext_grid.bus.values) & set(
net.bus_geodata.index)
if len(eg_buses_with_geo_coordinates) > 0:
sc = create_bus_collection(net,
eg_buses_with_geo_coordinates,
patch_type="rect",
size=ext_grid_size,
color=ext_grid_color,
zorder=11)
collections.append(sc)
# create trafo collection if trafo is available
trafo_buses_with_geo_coordinates = [
t for t, trafo in net.trafo.iterrows()
if trafo.hv_bus in net.bus_geodata.index
and trafo.lv_bus in net.bus_geodata.index
]
if len(trafo_buses_with_geo_coordinates) > 0:
tc = create_trafo_symbol_collection(net,
trafo_buses_with_geo_coordinates,
color=trafo_color)
collections.append(tc[0])
collections.append(tc[1])
draw_collections(collections)
plt.show()
def simple_plot(net=None,
respect_switches=False,
line_width=1.0,
bus_size=1.0,
ext_grid_size=1.0,
bus_color=colors[0],
line_color='grey',
trafo_color='g',
ext_grid_color='y'):
"""
Plots a pandapower network as simple as possible. If no geodata is available, artificial geodata is generated. For advanced plotting see the tutorial
INPUT:
**net** - The pandapower format network. If none is provided, mv_oberrhein() will be plotted as an example
OPTIONAL:
**respect_switches** (bool, False) - Respect switches when artificial geodata is created
**line_width** (float, 1.0) - width of lines
**bus_size** (float, 1.0) - Relative size of buses to plot.
The value bus_size is multiplied with mean_distance_between_buses, which equals the distance between
the max geoocord and the min divided by 200.
mean_distance_between_buses = sum((net['bus_geodata'].max() - net['bus_geodata'].min()) / 200)
**ext_grid_size** (float, 1.0) - Relative size of ext_grids to plot.
See bus sizes for details. Note: ext_grids are plottet as rectangles
**bus_color** (String, colors[0]) - Bus Color. Init as first value of color palette. Usually colors[0] = "b".
**line_color** (String, 'grey') - Line Color. Init is grey
**trafo_color** (String, 'g') - Trafo Color. Init is green
**ext_grid_color** (String, 'y') - External Grid Color. Init is yellow
"""
if net is None:
import pandapower.networks as nw
logger.warning(
"No pandapower network provided -> Plotting mv_oberrhein")
net = nw.mv_oberrhein()
# create geocoord if none are available
if len(net.line_geodata) == 0 and len(net.bus_geodata) == 0:
logger.warning(
"No or insufficient geodata available --> Creating artificial coordinates."
+ " This may take some time")
create_generic_coordinates(net, respect_switches=respect_switches)
if bus_size or ext_grid_size is None:
# if either bus_size or ext_grid size is None -> calc size from distance between min and
# max geocoord
mean_distance_between_buses = sum(
(net['bus_geodata'].max() - net['bus_geodata'].min()) / 200)
# set the bus / ext_grid sizes accordingly
# Comment: This is implemented because if you would choose a fixed values
# (e.g. bus_size = 0.2), the size
# could be to small for large networks and vice versa
bus_size *= mean_distance_between_buses
ext_grid_size *= mean_distance_between_buses * 1.5
# if bus geodata is available, but no line geodata
use_line_geodata = False if len(net.line_geodata) == 0 else True
# create bus collections ti plot
bc = create_bus_collection(net,
net.bus.index,
size=bus_size,
color=bus_color,
zorder=10)
lc = create_line_collection(net,
net.line.index,
color=line_color,
linewidths=line_width,
use_line_geodata=use_line_geodata)
collections = [bc, lc]
eg_buses_with_geocoordinates = set(net.ext_grid.bus.values) & set(
net.bus_geodata.index)
if len(eg_buses_with_geocoordinates) > 0:
sc = create_bus_collection(net,
eg_buses_with_geocoordinates,
patch_type="rect",
size=ext_grid_size,
color=ext_grid_color,
zorder=11)
collections.append(sc)
# create trafo collection if trafo is available
trafo_buses_with_geocoordinates = [t for t, trafo in net.trafo.iterrows() \
if trafo.hv_bus in net.bus_geodata.index \
and trafo.lv_bus in net.bus_geodata.index]
if len(trafo_buses_with_geocoordinates) > 0:
tc = create_trafo_collection(net,
trafo_buses_with_geocoordinates,
color=trafo_color)
collections.append(tc)
draw_collections(collections)
plt.show()
