Status: Expect regular updates and bug fixes.
Solar photovoltaic distributed energy resources (PV-DER) are power electronic inverter based generation (IBG) connected to the electric power distribution system (eg. roof top solar PV systems). This utility can be used to simulate the dynamics of a single DER connected to a stiff voltage source as shown in the following schematic:
The dynamics of the DER are modelled using dynamic phasors. Detailed description of the concepts behind this utility can be found in the IEEE publication Dynamic Modeling of Solar PV Systems for Distribution System Stability Analysis and detailed list of equations can be found in the Model specification document.
- Source code repository: https://github.com/sibyjackgrove/SolarPV-DER-simulation-utility
- API Documentation: https://solarpv-der-simulation-utility.readthedocs.io/en/latest/
You can install the module directly from GitHub with following commands:
git clone https://github.com/sibyjackgrove/SolarPV-DER-simulation-utility.git
cd SolarPV-DER-simulation-utility
pip install -e .
Following projects are using Solar PV-DER simulation utility:
- Argonne Transmission and Distribution systems Co-Simulation tool (TDcoSim)
- OpenAI Gym Distributed Energy Resource Environment (Gym-DER)
The module can be imported as a normal python module:
import pvder
The following features are available currently:
- Single phase or three phase DER models (phase voltages may be unbalanced).
- Run simulation in stand alone mode with internal grid voltage source model.
- Run simulation in loop mode where grid voltage and frequency is supplied every time step by a third party program.
- Visualize or retrieve simulation results for voltages, current, active, and reactive power.
- Introduce solar insolation events (in all modes), grid voltage, and frequency change events (in stand alone mode).
- Retrive and modify model parameters from a third party program.
- Enable Low voltage ride through (LVRT) and Volt-VAR control logic.
The following steps are required:
- First import the following classes:
from pvder.DER_components_single_phase import SolarPV_DER_SinglePhase
from pvder.grid_components import Grid
from pvder.dynamic_simulation import DynamicSimulation
from pvder.simulation_events import SimulationEvents
from pvder.simulation_utilities import SimulationResults
- Create a SimulationEvents object: This object is used to add or remove disturbance events occurs during the simulation.
events = SimulationEvents()
- Create a Grid object: This object describes the steady state model for the grid voltage source. It needs to be supplied with an SimulationEvents object.
grid = Grid(events=events)
- Create a SolarPV_DER_SinglePhase or SolarPV_DER_ThreePhase object: This object describes the dynamic DER model. It needs both an SimulationEvents object and a Grid object. The power rating of the DER are should also be provided.
PV_DER = SolarPV_DER_SinglePhase(grid_model=grid,events=events,Sinverter_rated = 10.0e3,standAlone = True)
- Create a DynamicSimulation object: This object runs the simulation and stores the solution. It takes SimulationEvents, Grid and, SolarPV_DER_SinglePhase objects as arguments.
sim = DynamicSimulation(grid_model=grid,PV_model=PV_DER,events = events)
- Create a SimulationResults object: This object is used to visualize the simulation results.
results = SimulationResults(simulation = sim)
- Add an event (for e.g. solar insolation change at 10.0 s):
events.add_solar_event(10,90)
- Specify simulation flags (for e.g. set the DEBUG_SIMULATION and DEBUG_POWER flag to true to observe the power at each time step.):
sim.DEBUG_SIMULATION = False
sim.DEBUG_POWER = False
- Specify simulation stop time (for e.g. 20.0 s):
sim.tStop = 20.0
- Run the simulation:
sim.run_simulation()
- Visualize the results (for e.g. the power output at PCC-LV side):
results.PER_UNIT = False
results.plot_DER_simulation(plot_type='active_power_Ppv_Pac_PCC')
Try out Jupyter notebooks with usage examples in Google Colab:
A schematic of the relationship between differen classes in the module is shown in the figure below:
Dependencies: SciPy, Numpy, Matlplotlib
Please feel free to raise an issue for bugs or feature requests.
Core developer:
- Siby Jose Plathottam [email protected]
Contributor:
- Karthikeyan Balasubramaniam [email protected]
This project was supported by Kemal Celik, U.S. DOE Office of Electricity, Solar Energy Technology Office through the SuNLaMP program.
The authors would like to acknowledge Shrirang Abhyankar and Puspal Hazra for their contribution.
If you use this code please cite it as:
@misc{pvder,
title = {{SolarPV-DER-simulation-utility}: A simulation utility for or solar photovoltaic distributed energy resources},
author = "{Siby Jose Plathottam,Karthikeyan Balasubramaniam}",
howpublished = {\url{https://github.com/sibyjackgrove/SolarPV-DER-simulation-utility}},
url = "https://github.com/sibyjackgrove/SolarPV-DER-simulation-utility",
year = 2019,
note = "[Online; accessed 19-March-2019]"
}
Copyright © 2019, UChicago Argonne, LLC
Photovoltaic Distributed Energy Resource (PV-DER) Simulation Utility is distributed under the terms of BSD-3 OSS License.