ding0.core.structure package¶

Submodules¶

ding0.core.structure.groups module¶

class ding0.core.structure.groups.LoadAreaGroupDing0(**kwargs)[source]¶

Bases: object

Container for small load_areas / load areas (satellites).

A group of stations which are within the same satellite string. It is required to check whether a satellite string has got more load or string length than allowed, hence new nodes cannot be added to it.

id_db¶

Descr

Type:	`int`

mv_grid_district¶

Desc

Type:	Shapely Polygon object

add_lv_load_area(lv_load_area)[source]¶

Adds a LV load_area to _lv_load_areas if not already existing

Parameters:	lv_load_area (Shapely Polygon object) – Descr

can_add_lv_load_area(node)[source]¶

Sums up peak load of LV stations

That is, total peak load for satellite string

Parameters:	node (`GridDing0`) – Descr
Returns:	obj: bool – True if ????

lv_load_areas()[source]¶

Returns a generator for iterating over load_areas

Yields:	int – generator for iterating over load_areas

network¶

ding0.core.structure.regions module¶

class ding0.core.structure.regions.LVGridDistrictDing0(**kwargs)[source]¶

Bases: ding0.core.structure.RegionDing0

Describes region that is covered by a single LV grid

Parameters:

geo_data (Shapely Polygon object) – The geo-spatial polygon in the coordinate reference system with the SRID:4326 or epsg:4326, this is the project used by the ellipsoid WGS 84.
lv_load_area (Shapely Polygon object) – Descr
lv_grid (Shapely Polygon object) – Descr
population (float) – Descr
peak_load_residential (float) – Descr
peak_load_retail (float) – Descr
peak_load_industrial (float) – Descr
peak_load_agricultural (float) – Descr
peak_load (float) – Descr
sector_count_residential (int) – Descr
sector_count_retail (int) – Descr
sector_count_industrial (int) – Descr
sector_count_agricultural (int) – Descr

TODO UPDATE DESCR FOR GRAPH AND BUILDINGS

network¶

class ding0.core.structure.regions.LVLoadAreaCentreDing0(**kwargs)[source]¶

Bases: object

Defines a region centre in Ding0.

The centres are used in the MV routing as nodes.

Note

Centre is a point within a region’s polygon that is located most central (e.g. in a simple region shape like a circle it’s the geometric center).

Parameters:	id_db (`int`) – unique ID in database (=id of associated load area) grid (`int`) – Descr geo_data (Shapely Point object) – The geo-spatial point in the coordinate reference system with the SRID:4326 or epsg:4326, this is the project used by the ellipsoid WGS 84. lv_load_area (`LVLoadAreaDing0`) – Descr

network¶

pypsa_bus_id¶

Remove Returns specific ID for representing bus in pypsa network.

Returns:	`str` – Representative of pypsa bus
Type:	Todo

class ding0.core.structure.regions.LVLoadAreaDing0(**kwargs)[source]¶

Bases: ding0.core.structure.RegionDing0

Defines a LV-load_area in DINGO

ring¶

Descr

Type:	`int`

mv_grid_district¶

Descr

Type:	Shapely Polygon object

lv_load_area_centre¶

Descr

Type:	Shapely Point object

lv_load_area_group¶

Descr

Type:	Shapely Polygon object

is_satellite¶

Descr

Type:	`bool`

is_aggregated¶

Descr

Type:	`bool`

db_data¶

Descr

Type:	pandas.DatetimeIndex

# new osm approach

load_area_graph¶

contains all streets in load_area

Type:	networkx.MultiDiGraph

MVLoads¶

list containing ding0.MVLoads in lvla

Type:	list

add_lv_grid_district(lv_grid_district)[source]¶

Adds a LV grid district to _lv_grid_districts if not already existing

Parameters:	lv_grid_district (Shapely Polygon object) – Descr

add_mv_load(mv_load)[source]¶

Adds a MVLoad to _lv_grid_districts if not already existing

Parameters:	mv_load (ding0.core.network.MVLoadDing0) –

lv_grid_districts()[source]¶

Returns a generator for iterating over LV grid districts

Yields:	int – generator for iterating over LV grid districts

lv_grid_districts_count()[source]¶

Returns the count of LV grid districts

Returns:	int – Number of LV grid districts.

mv_loads_count()[source]¶

Returns the count of MV loads

Returns:	int – Number of MV loads.

network¶

peak_generation¶: Cumulative peak generation of generators connected to LV grids of underlying LVGDs

class ding0.core.structure.regions.MVGridDistrictDing0(**kwargs)[source]¶

Bases: ding0.core.structure.RegionDing0

Defines a MV-grid_district in DfINGO

mv_grid¶

Descr

Type:	`int`

geo_data¶

The geo-spatial Polygon in the coordinate reference system with the SRID:4326 or epsg:4326, this is the project used by the ellipsoid WGS 84.

Type:	Shapely Polygon object

peak_load¶

Descr

Type:	`float`

peak_load_satellites¶

Descr

Type:	`float`

peak_load_aggregated¶

Descr

Type:	`float`

add_aggregated_peak_demand()[source]¶: Summarizes peak loads of underlying aggregated load_areas

add_lv_load_area(lv_load_area)[source]¶

Adds a Load Area lv_load_area to _lv_load_areas if not already existing

Additionally, adds the associated centre object to MV grid’s _graph as node.

Parameters:	lv_load_area (LVLoadAreaDing0) – instance of class LVLoadAreaDing0

add_lv_load_area_group(lv_load_area_group)[source]¶: Adds a LV load_area to _lv_load_areas if not already existing.

add_peak_demand()[source]¶

Summarizes peak loads of underlying load_areas in kVA.

(peak load sum and peak load of satellites)

lv_load_area_groups()[source]¶

Returns a generator for iterating over LV load_area groups.

Yields:	int – generator for iterating over LV load_areas

lv_load_area_groups_count()[source]¶

Returns the count of LV load_area groups in MV region

Returns:	int – Number of LV load_area groups in MV region.

lv_load_areas()[source]¶

Returns a generator for iterating over load_areas

Yields:	int – generator for iterating over load_areas

network¶

Module contents¶

class ding0.core.structure.RegionDing0(**kwargs)[source]¶

Bases: object

Defines a region in DING0