Collaborative Open-Source Dynamic Simulation Library

The power system and energy systems at large experience a paradigm shift with many novel , active components connected. Appraising the behavior and reactions of such new items is critical for network operators to simulate and anticipate system operation, and for this, available, reliable up to date and possibly specifically targeted component models are required.

At present, on one hand, operators manage to gather and build pragmatically a model database of the components directly connected to their network. They remain however blind or use rough proxies to cope with:

• Components indirectly connected (e.g. to neighboring, coupled networks, such as electricity or gas grids ; and/or quite likely in a soon future: across sectors )
• Future connected ones (components at design stage, latest technology, and proprietary manufacturer models). On the other hand, research also suffers from the lack of all the necessary component models and is slowed down by the effort required to circumvent it.

They both face the need for a collaborative shared dynamic simulation library that would benefit to all by its high quality, transparency of model equations, and concrete applications (real test cases).

In this Colib workspace, we aim at addressing power systems components, networks, and small and large test cases for steady-state and dynamic stability studies. For each of them, the description of the object is presented on one side, and the links to open source implementations with indicators on the quality on the other side.

Want to contribute? Go see: How to contribute page

Installation Guide

1. Install Ruby 2.6.5

• Go to RubyInstaller and download the Ruby+Devkit 2.6.5 installer.

2. Install Gem

• Visit RubyGems and follow the instructions to install Gem.

3. Install GCC for Jekyll

• Download and install GCC for Jekyll from SourceForge.

4. Install Make for Jekyll

1. Open a new PowerShell terminal.
2. Run the following lines written in the quickstart on Scoop (check if the commands below are the same on the website):

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

   Close the terminal after running the above commands.

3. Search for Make using the search bar on Scoop.
4. Open a new PowerShell terminal.
5. Execute the following command to install Make:

   scoop install main/make

5. Install Git

• Download and install Git from Git Official Website.

6. Install Visual Studio Code (Recommended)

• Download and install Visual Studio Code from VSCode Official Website.

Follow these steps to install the necessary tools for Jekyll and additional recommended tools.

Additional Steps for Website Setup

1. Use Git to Clone the Work on Your Computer

• Open a terminal or PowerShell window.
• Navigate to the directory where you want to clone the website's work.
• Run the following command:

  git clone <repository_url>

  Replace <repository_url> with the URL of the repository.

2. Open the Website's Folder with VSCode

• Open Visual Studio Code (VSCode).
• Use the menu or shortcut to open the folder where you cloned the website's work.

3. Open a New Terminal

• In VSCode, open a new terminal window.

4. Run Bundle Install

• In the terminal, navigate to the website's folder.
• Run the following command to install dependencies:

  bundle install

5. Run Bundle Exec Jekyll Serve

• After installing dependencies, run the following command to serve the website locally:

  bundle exec jekyll serve

Final Step: Visit the Website

• Once the Jekyll server is running, visit the website in your browser at http://localhost:4000.

Troubleshooting:

• If you encounter the error message "Bundle command not found," run the following command to install Bundler:

  gem install bundler

  Then, retry running bundle install.