Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Latest commit a951879 Jul 16, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
bgw config bgw Aug 22, 2018
data_management JSON output correction Jun 26, 2019
docker Initial Commit Jun 26, 2018
nginx/config.d Included CORS support Jul 16, 2019
scripts Transformator-Object Aug 3, 2018
simulator JSON output correction Jun 26, 2019
swagger_server Included CORS support Jul 16, 2019
tests good results Jun 21, 2019
.gitignore .gitignore added Jun 26, 2018
Dockerfile Dockerfile Aug 28, 2018 Update Jul 8, 2019
docker-compose.yml 16.05 May 16, 2019
docker-compose_r.yml new file May 17, 2019 main file Jul 11, 2018
requirements.txt requirements Aug 28, 2018

DSF Simulation Engine API

DSF Simulation Engine (DSF-SE) API is a web-based API to that enables online interaction with power simulator, i.e., OpenDSS. These instructions will get you a copy of the project up and running for development and testing purposes.

Getting the Source from the Repository

$git clone

Modifying the code

Modify swagger definition on swager editor, generate code from swagger download the generated model and replace the existing model replace the existing swagger file with the new one modify the,, and according to the new model

NB: To save time, you may also do these steps manually, i.e., modify swagger file, modify corresponing code in model,, and files


Using this API, requires availability of docker environment. All the required dependencies are specified and contained in the package.

Building and Running the Simulation Engine

$docker-compose build && docker-compose up # after every change

Once the simulation engine starts running, you can send simulation requests via clients such as PostMan

Using the Simulation Engine API

BaseURL: http://ip:port/se

Create Simulation

  • Method: post
  • End Point: /simulation
  • Input: JSON file of GRID definition
  • Output: Simulation id

Run Simulation

Once simulation is successfully created, you can run the simulation

  • Method: post
  • End Point: /commands/run/simulation_id
  • Input: simulation id
  • Output: Simulation result (at the moment): array of Node Names, and Voltage MagPus

Simulation id returned after creating simulation is used as a parameter to run the simulation

Get Simulation Result

Once simulation is successfully run, you can obtain the simulation results

  • Method: get
  • End Point: /simulationResult/simulation_id
  • Input: Simulation id
  • Output: Result of simulation, i.e., Returns result of “Run Simulation” to client

Abort Simulation

  • Method: post
  • End Point: /commands/abort/simulation id

Update Simulation

Parameters of simulation can be updated using simulation id that is returned by the successfull creation of simulation in the above step

  • Method: put
  • End Point: simulation/simulation_id

Delete Simulation

Instance of a simulation can be deleted using simulation id that is returned by the successfull creation of simulation in the above step.

  • Method: delete
  • End Point: /simulation/simulation_id
You can’t perform that action at this time.