Adding and modifying components

Besides importing whole scenarios, you can add, remove and integrate individual components — generators, loads, storage units, charging points or heat pumps. For an overview of all component types, see Components.

Adding a component

Use add_component(). If the bus is known, the component is connected there; otherwise see geolocation-based integration below.

# add a storage unit to a known bus (no time series set — e.g. for a
# subsequent worst-case study, where the series come from
# set_time_series_worst_case_analysis)
edisgo.add_component(
    comp_type="storage_unit",
    bus=edisgo.topology.buses_df.index[3],
    p_nom=4,
)

In a time-series study you provide the series directly:

edisgo.add_component(
    comp_type="storage_unit",
    bus=edisgo.topology.buses_df.index[3],
    p_nom=4,
    ts_active_power=pd.Series([-3.4, 2.5, -3.4, 2.5], index=edisgo.timeseries.timeindex),
    ts_reactive_power=pd.Series([0.0, 0.0, 0.0, 0.0], index=edisgo.timeseries.timeindex),
)

Removing a component

edisgo.remove_component(comp_type="load", comp_name="Load_XYZ")

Integration based on geolocation

integrate_component_based_on_geolocation() connects a component to the most suitable point in the grid given its coordinates and nominal power. The voltage level it is connected to depends on its power (the thresholds are defined in config_grid); large components are connected directly to a station, smaller ones to the nearest suitable line or bus.

Aggregating components

aggregate_components() combines the generators respectively loads at the same bus into a single component, which can speed up power flow and optimisation. By default all generators (resp. all loads) at a bus are aggregated; you can instead group them by further columns — e.g. by type or sector — via aggregate_generators_by_cols / aggregate_loads_by_cols. Storage units are not aggregated.

Manual heat-pump and storage integration

Heat pumps are added as loads of type="heat_pump" and then equipped with COP and heat-demand series:

bus = edisgo.topology.loads_df[
    edisgo.topology.loads_df.sector == "residential"].bus[0]
hp_name = edisgo.add_component(
    "load", bus=bus, p_set=0.015, type="heat_pump")

# cop and heat_demand are pandas Series you provide (indexed by the time index),
# e.g. from measured or modelled data
edisgo.heat_pump.set_cop(edisgo, cop.to_frame(name=hp_name))
edisgo.heat_pump.set_heat_demand(edisgo, heat_demand.to_frame(name=hp_name))
edisgo.apply_heat_pump_operating_strategy()

For the methodology behind heat-pump and storage operation see Heat pumps and Battery storage.