Metadata-Version: 1.2
Name: GridCal
Version: 3.3.7
Summary: .. _about:

About GridCal
=============

**GridCal** is a research oriented power systems software.

Research oriented? How? Well, it is a fruit of research. It is designed to be modular.
As a researcher I found that the available software (not even talking about commercial
options) are hard to expand or adapt to achieve complex simulations. **GridCal** is
designed to allow you to build and reuse modules, which eventually will boost your
productivity and the possibilities that are at hand.

I have made other projects (even another open source one: fPotencia in C++). I believe
that this project encapsulates my half life of programming experience and the curiosity
I have developed for power systems.

So, I do really hope you enjoy it, and if you have comments, suggestions or just want
to collaborate, do not hesitate to contact.

Cheers,

Santiago

Home-page: https://github.com/SanPen/GridCal
Author: Santiago Peñate Vera and Michel Lavoie
Author-email: santiago.penate.vera@gmail.com
License: UNKNOWN
Description: ![](https://github.com/SanPen/GridCal/blob/master/pics/GridCal_banner.png)
        
        # What is this?
        
        This software aims to be a complete platform for power systems research and simulation.
        [Watch the video](https://youtu.be/SY66WgLGo54) and
        [check out the documentation](https://gridcal.readthedocs.io)
        
        ![](https://github.com/SanPen/GridCal/blob/master/pics/GridCal.png)
        
        # Installation
        
        Try: `pip install GridCal`
        
        For more options, follow the
        [installation instructions](https://gridcal.readthedocs.io/en/latest/getting_started/install.html)
        from the project's documentation.
        
        # Execution
        
        GridCal can be used in 2 ways:
        
        1. With a 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](https://gridcal.readthedocs.io/en/latest/getting_started.html)
        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](https://github.com/SanPen/GridCal/tree/master/Grids_and_profiles) 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](https://github.com/SanPen/GridCal/tree/master/Tutorials) folder of the GitHub repository. In addition, the
        tests under [src/tests](https://github.com/SanPen/GridCal/tree/master/src/tests) may serve as valuable examples.
        
        # 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
            - CIM (Common Information Model v16)
            - PSS/e RAW versions 30, 32 and 33.
            - 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
            - Excel (normal GridCal format)
            - 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.
        
        - Time series with profiles in all the objects physical magnitudes.
        
        - 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.
        
        Visit the [Wiki](https://github.com/SanPen/GridCal/wiki) and the
        [check out the documentation](https://gridcal.readthedocs.io) to learn more and to
        get started.
        
        Send feedback and requests to santiago.penate.vera@gmail.com.
        
Keywords: power systems planning
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers and electrical engineers
Classifier: Topic :: Software Development :: Power Systems
Classifier: License :: OSI Approved :: GPLv3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.5
