Structure
pandaprosumer as a software tool is developed to model custom prosumer components within multi-energy systems. The figure illustrates the envisioned future application of pandaprosumer in simulating the interaction of electricity, heat, and gas grids, along with sector-coupling infrastructures such as Power-to-Gas (P2G) and Combined Heat and Power (CHP) systems.
Conceptualized integration of the pandaprosumer with multi-energy grids and infrastructures
A prosumer in the pandarosumer is a container object that encapsulates the controller, elements, period and mapping required to model the sector coupling component. The core of this setup is the prosumer controller, which facilitates the interactions between elements containing the static data, time-series data inputs (e.g., heat demand profiles, source temperature profiles), and natural constants (e.g., conversion efficiencies).
In the context of pandaprosumer, the ConstProfileController is a specialized controller that is configured to be initialized and executed first to read from a data source (in a user-defined file format e.g., CSV, Excel etc.) and generate a time-series profile. This ensures that the downstream controllers receive time-series inputs to invoke their respective controller logic. The ConstProfileController does not perform internal calculations and simply inherits the prosumer’s mapping logic to direct it’s output to other controllers.
pandaprosumer leverages the control loop of pandapower and builds upon it to manage controller interactions for energy systems. At its core, the run_timeseries function handles the execution of the controllers over a defined period. It initializes time series variables, runs the control logic in the control step of each controller and the loop repeatedly evaluates whether each controller has converged. The loop executes control steps and recalculates power flow until convergence is reached or a set iteration limit is crossed. Controller-specific initialization and finalization routines are also supported.
Mappings define data connections between controllers and are described in detail in Mappings.
Prosumer Structure
Prosumer |
Example Content |
|---|---|
controller (3 entries) |
|
mapping (3 entries) |
|
period (1 entry) |
|
heat_pump (1 entry) |
heat_pump: delta_t_evap_c = 5.0, carnot_efficiency = 0.5, cond_fluid = water - Time 00:00 → output_kw = A - Time 01:00 → output_kw = B |
heat_demand (1 entry) |
heat_demand: scale = X, temp_in = Y, temp_out = Z - Time 00:00 → demand_kw = M - Time 01:00 → demand_kw = N |
time_series (2 entries) |
|
Flowchart: Heat Pump and Heat Demand Element Interaction
Operation of heat pump and heat demand controllers within the pandaprosumer framework