What is this?

This software aims to be a complete platform for power systems research and simulation. Watch the video and check out the documentation

Installation

Try: pip install GridCal

For more options (including a standalone setup one), follow the installation instructions from the project's documentation.

Execution

GridCal can be used in 2 ways:

1. From the user interface (GUI)
2. As a library.

Executing python3 -c "from GridCal.ExecuteGridCal import run; run()" in a console should bring up the GUI under most platforms. For detailed instructions, follow the instructions from the project's documentation.

Tutorials

• Cloning the repository: https://youtu.be/59W_rqimB6w

• Standalone GridCal setup: https://youtu.be/SY66WgLGo54

• Making a grid with profiles: https://youtu.be/H2d_2bMsIS0

Batteries included

In an effort to ease the simulation and construction of grids, We have included extra materials to work with.

Here you can find:

• Load profiles for your projects
• Standard IEEE grids as well as grids from open projects
• Equipment catalogue (Wires, Cables and Transformers) ready to use in GridCal

Examples

Examples are included in Tutorials section. In addition, the tests under src/tests may serve as valuable examples.

Testing GridCal

python3 -m venv venv
venv/bin/python -m pip install --upgrade -r requirements_venv.txt
venv/bin/python -m tox

Features overview

It is pure Python, it works for Windows, Linux and OSX.

Some features you'll find already are:

• Compatible with other formats:

  • Import (Drag & Drop)

    • CIM (Common Information Model v16)
    • PSS/e RAW versions 29, 30, 32, 33 and 34.
    • Matpower (might not be fully compatible, notify me if not).
    • DigSilent .DGS (not be fully compatible: Only positive sequence and devices like loads, generators, etc.)

  • Export

    • Zip file .gridcal with CSV inside (fastest, normal GridCal format)
    • Sqlite
    • Excel
    • Custom JSON
    • CIM (Common Information Model v16)

• Power flow:

  • State of the art multi-terminal AC/DC Newton Raphson in power and current equations.
  • Newton Raphson Iwamoto (optimal acceleration).
  • Fast Decoupled Power Flow
  • AC/DC multi-terminal Levenberg-Marquardt (Works very well with large ill-conditioned grids)
  • Holomorphic Embedding Power Flow (Unicorn under investigation...)
  • DC approximation.
  • Linear AC approximation.

• Optimal power flow (OPF) and generation dispatch:

  • Linear (DC) with losses.
  • Linear (Ac) with losses.
  • Loss-less simple generation dispatch.
  • All the modes can be split the runs in hours, days, weeks or months!

• Time series with profiles in all the objects physical magnitudes.

• PTDF approximated branch flow time series for super fast estimation of the flows.

• Bifurcation point with predictor-corrector Newton-Raphson.

• Monte Carlo / Latin Hypercube stochastic power flow based on the input profiles.

• Blackout cascading in simulation and step by step mode.

• Three-phase short circuit.

• Includes the Z-I-P load model, this means that the power flows can handle both power and current.

• The ability to handle island grids in all the simulation modes.

• Profile editor and importer from Excel and CSV.

• Grid elements' analysis to discover data problems.

• Overhead line construction from wire scheme.

• Device templates (lines and transformers).

• Grid reduction based on branch type and filtering by impedance values

• Export the schematic in SVG and PNG formats.

Check out the documentation to learn more and to get started.

Collaborators

• Michel Lavoie (Transformer automation)
• Bengt Lüers (Better testing)
• Josep Fanals Batllori (HELM)
• Manuel Navarro Catalán (Better documentation)
• Paul Schultz (Grid Generator)

Contact

Send feedback and requests to [email protected].