edisgo.network.grids.Grid

class edisgo.network.grids.Grid(**kwargs)

Bases: abc.ABC

digraph inheritancec58dfcc66a { bgcolor=transparent; rankdir=LR; size="8.0, 12.0"; "ABC" [URL="https://docs.python.org/3/library/abc.html#abc.ABC",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Helper class that provides a standard way to create an ABC using"]; "Grid" [URL="#edisgo.network.grids.Grid",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Defines a basic grid in eDisGo."]; "ABC" -> "Grid" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

Defines a basic grid in eDisGo.

Parameters:

edisgo_obj (EDisGo)
id (str or int, optional) – Identifier

property id: ID of the grid.

property edisgo_obj: EDisGo object the grid is stored in.

property nominal_voltage

Nominal voltage of network in kV.

Parameters:: nominal_voltage (float)
Returns:: Nominal voltage of network in kV.
Return type:: float

property graph

Graph representation of the grid.

Returns:: Graph representation of the grid as networkx Ordered Graph, where lines are represented by edges in the graph, and buses and transformers are represented by nodes.
Return type:: networkx.Graph

property geopandas

Returns components as geopandas.GeoDataFrames.

Returns container with geopandas.GeoDataFrames containing all georeferenced components within the grid.

Returns:: Data container with GeoDataFrames containing all georeferenced components within the grid.
Return type:: GeoPandasGridContainer

property station: DataFrame with form of buses_df with only grid’s station’s secondary side bus information.

property station_name

Name of station to the overlying voltage level.

Name of station is composed of grid name with the extension ‘_station’.

property generators_df

Connected generators within the network.

Returns:: Dataframe with all generators in topology. For more information on the dataframe see generators_df.
Return type:: pandas.DataFrame

property generators

Connected generators within the network.

Returns:: List of generators within the network.
Return type:: list(Generator)

property loads_df

Connected loads within the network.

Returns:: Dataframe with all loads in topology. For more information on the dataframe see loads_df.
Return type:: pandas.DataFrame

property loads

Connected loads within the network.

Returns:: List of loads within the network.
Return type:: list(Load)

property storage_units_df

Connected storage units within the network.

Returns:: Dataframe with all storage units in topology. For more information on the dataframe see storage_units_df.
Return type:: pandas.DataFrame

property charging_points_df

Connected charging points within the network.

Returns:: Dataframe with all charging points in topology. For more information on the dataframe see loads_df.
Return type:: pandas.DataFrame

property switch_disconnectors_df

Switch disconnectors in network.

Switch disconnectors are points where rings are split under normal operating conditions.

Returns:: Dataframe with all switch disconnectors in network. For more information on the dataframe see switches_df.
Return type:: pandas.DataFrame

property switch_disconnectors

Switch disconnectors within the network.

Returns:: List of switch disconnectory within the network.
Return type:: list(Switch)

property lines_df

Lines within the network.

Returns:: Dataframe with all buses in topology. For more information on the dataframe see lines_df.
Return type:: pandas.DataFrame

abstract property buses_df

Buses within the network.

Returns:: Dataframe with all buses in topology. For more information on the dataframe see buses_df.
Return type:: pandas.DataFrame

property weather_cells

Weather cells in network.

Returns:: List of weather cell IDs in network.
Return type:: list(int)

property peak_generation_capacity

Cumulative peak generation capacity of generators in the network in MW.

Returns:: Cumulative peak generation capacity of generators in the network in MW.
Return type:: float

property peak_generation_capacity_per_technology

Cumulative peak generation capacity of generators in the network per technology type in MW.

Returns:: Cumulative peak generation capacity of generators in the network per technology type in MW.
Return type:: pandas.DataFrame

property p_set

Cumulative peak load of loads in the network in MW.

Returns:: Cumulative peak load of loads in the network in MW.
Return type:: float

property p_set_per_sector

Cumulative peak load of loads in the network per sector in MW.

Returns:: Cumulative peak load of loads in the network per sector in MW.
Return type:: pandas.DataFrame

assign_length_to_grid_station()

Assign length in km from each bus in the grid to the grid’s station.

The length is written to column ‘length_to_grid_station’ in buses_df.

assign_grid_feeder(mode='grid_feeder')

Assigns MV or LV feeder to each bus and line, depending on the mode.

See assign_feeders for more information.

Parameters:: mode (str) – Specifies whether to assign MV or grid feeder. If mode is “mv_feeder” the MV feeder the buses and lines are in are determined. If mode is “grid_feeder” LV buses and lines are assigned the LV feeder they are in and MV buses and lines are assigned the MV feeder they are in. Default: “grid_feeder”.

get_feeder_stats()

Generate statistics of the grid’s feeders.

So far, only the feeder length is determined.

Returns:: Dataframe with feeder name in index and column ‘length’ containing the respective feeder length in km.
Return type:: pandas.DataFrame