edisgo.network.components
¶
Module Contents¶
Classes¶
Generic component |
|
Generic component for all components that can be considered nodes, |
|
Load object |
|
Generator object |
|
Storage object |
|
Switch object |
|
Generic component |
- class edisgo.network.components.BasicComponent(**kwargs)[source]¶
Bases:
abc.ABC
Generic component
Can be initialized with EDisGo object or Topology object. In case of Topology object component time series attributes currently will raise an error.
- property id¶
Unique identifier of component as used in component dataframes in
Topology
.- Returns
Unique identifier of component.
- Return type
- property voltage_level¶
Voltage level the component is connected to (‘mv’ or ‘lv’).
- Returns
Voltage level. Returns ‘lv’ if component connected to the low voltage and ‘mv’ if component is connected to the medium voltage.
- Return type
- class edisgo.network.components.Component(**kwargs)[source]¶
Bases:
BasicComponent
Generic component for all components that can be considered nodes, e.g. generators and loads.
- property bus¶
Bus component is connected to.
- property geom¶
Geolocation of component.
- Return type
- class edisgo.network.components.Load(**kwargs)[source]¶
Bases:
Component
Load object
- property p_set¶
Peak load in MW.
- property annual_consumption¶
Annual consumption of load in MWh.
- property sector¶
Sector load is associated with.
The sector is e.g. used to assign load time series to a load using the demandlib. The following four sectors are considered: ‘agricultural’, ‘cts’, ‘residential’, ‘industrial’.
- property active_power_timeseries¶
Active power time series of load in MW.
- Returns
Active power time series of load in MW.
- Return type
- property reactive_power_timeseries¶
Reactive power time series of load in Mvar.
- Returns
Reactive power time series of load in Mvar.
- Return type
- class edisgo.network.components.Generator(**kwargs)[source]¶
Bases:
Component
Generator object
- property nominal_power¶
Nominal power of generator in MW.
- property type¶
Technology type of generator (e.g. ‘solar’).
- property subtype¶
Technology subtype of generator (e.g. ‘solar_roof_mounted’).
- property active_power_timeseries¶
Active power time series of generator in MW.
- Returns
Active power time series of generator in MW.
- Return type
- property reactive_power_timeseries¶
Reactive power time series of generator in Mvar.
- Returns
Reactive power time series of generator in Mvar.
- Return type
- class edisgo.network.components.Storage(**kwargs)[source]¶
Bases:
Component
Storage object
- property nominal_power¶
Nominal power of storage unit in MW.
- property active_power_timeseries¶
Active power time series of storage unit in MW.
- Returns
Active power time series of storage unit in MW.
- Return type
- property reactive_power_timeseries¶
Reactive power time series of storage unit in Mvar.
- Returns
Reactive power time series of storage unit in Mvar.
- Return type
- property state_of_charge_timeseries¶
State of charge time series of storage unit in MWh.
- Returns
State of charge time series of storage unit in MWh.
- Return type
- class edisgo.network.components.Switch(**kwargs)[source]¶
Bases:
BasicComponent
Switch object
Switches are for example medium voltage disconnecting points (points where MV rings are split under normal operation conditions). They are represented as branches and can have two states: ‘open’ or ‘closed’. When the switch is open the branch it is represented by connects some bus and the bus specified in bus_open. When it is closed bus bus_open is substitued by the bus specified in bus_closed.
- property type¶
Type of switch.
So far edisgo only considers switch disconnectors.
- property bus_open¶
Bus ID of bus the switch is ‘connected’ to when state is ‘open’.
As switches are represented as branches they connect two buses. bus_open specifies the bus the branch is connected to in the open state.
- Returns
Bus in ‘open’ state.
- Return type
- property bus_closed¶
Bus ID of bus the switch is ‘connected’ to when state is ‘closed’.
As switches are represented as branches they connect two buses. bus_closed specifies the bus the branch is connected to in the closed state.
- Returns
Bus in ‘closed’ state.
- Return type
- property state¶
State of switch (open or closed).
- Returns
State of switch: ‘open’ or ‘closed’.
- Return type
- property branch¶
Branch the switch is represented by.
- Returns
Branch the switch is represented by.
- Return type
- property grid¶
Grid switch is in.
- Returns
Grid switch is in.
- Return type
Grid
- class edisgo.network.components.PotentialChargingParks(**kwargs)[source]¶
Bases:
BasicComponent
Generic component
Can be initialized with EDisGo object or Topology object. In case of Topology object component time series attributes currently will raise an error.
- property voltage_level¶
Voltage level the component is connected to (‘mv’ or ‘lv’).
- Returns
Voltage level. Returns ‘lv’ if component connected to the low voltage and ‘mv’ if component is connected to the medium voltage.
- Return type
- property ags¶
8-digit AGS (Amtlicher Gemeindeschlüssel, eng. Community Identification Number) number the potential charging park is in. Number is given as
int
and leading zeros are therefore missing.- Returns
AGS number
- Return type
- property use_case¶
Charging use case (home, work, public or hpc) of the potential charging park.
- Returns
Charging use case
- Return type
- property designated_charging_point_capacity¶
Total gross designated charging park capacity in kW.
This is not necessarily equal to the connection rating.
- Returns
Total gross designated charging park capacity
- Return type
- property user_centric_weight¶
User centric weight of the potential charging park determined by SimBEV.
- Returns
User centric weight
- Return type
- property geometry¶
Location of the potential charging park as Shapely Point object.
- Returns
Location of the potential charging park.
- Return type
- property nearest_substation¶
Determines the nearest LV Grid, substation and distance.
- property edisgo_id¶
- property charging_processes_df¶
Determines designated charging processes for the potential charging park.
- Returns
DataFrame with AGS, car ID, trip destination, charging use case (private or public), netto charging capacity, charging demand, charge start, charge end, potential charging park ID and charging point ID.
- Return type
- property grid_connection_capacity¶
- property within_grid¶
Determines if the potential charging park is located within the grid district.