You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ManuelNvro 6bd372ceb0 Added step 0, step 1 and step 2 in DG Library tutorial 1 week ago
.idea Requirements for readthedocs 1 week ago
Grids_and_profiles Slight performance improvement by converting the fubm derivatives to numba 2 weeks ago
doc Added step 0, step 1 and step 2 in DG Library tutorial 1 week ago
pics Added Area, Substation, Zone and Country objects 6 months ago
src Requirements for readthedocs 1 week ago
.gitignore Fixing stuff around 4 months ago
.gitlab-ci.yml yes 1 year ago
.readthedocs.yml fixes for readthedocs 8 months ago
.travis.yml Reverted matplotlib back to 2.1.1 to not to break readthedocs 1 year ago Should link to latest, not master (on RTD) 1 year ago Create 3 years ago Added collaborators to the readme 1 week ago
pytest.ini Fixed path to source 2 years ago
requirements-dev.txt Requirements for readthedocs 1 week ago
requirements.txt Requirements for readthedocs 1 week ago
requirements_venv.txt Requirements for readthedocs 1 week ago Requirements for readthedocs 1 week ago
tox.ini add test for tutorials 1 year ago

Codacy Badge Documentation Status Build Status DOI

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


Try: pip install GridCal

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


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.


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 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 of the 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:

    • Robust Newton Raphson in power and current equations.
    • Newton Raphson Iwamoto (optimal acceleration).
    • Fast Decoupled Power Flow
    • 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.


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


Send feedback and requests to