Awesome
<b>Exa</b>scale <b>G</b>rid <b>O</b>ptimization toolkit (ExaGO<sup>TM</sup>) 
<!---->
<img src="viz/images/network_gen_load_us.png">
<img src="docs/manual/figures/three_in_one.png">
ExaGO<sup>TM</sup> is a package for solving large-scale power grid optimization problems on parallel and distributed architectures, particularly targeted for exascale machines with heteregenous architectures (GPU). Combinations of stochastic, contingency-constrained, multiperiod ACOPF problems can be solved with ExaGO. The package is written in C/C++ with python bindings available for python-based applications. An overview of the package is given on this page. For extended information, including the modeling details and formulations, see the ExaGO manual.
ExaGO<sup>TM</sup> includes the following applications for solving different power grid optimization problems:
- OPFLOW solves an AC optimal power flow either on CPU and GPU
- TCOPFLOW solves a multi-period optimal power flow
- SCOPFLOW solves a security-constrained (contingency-constrained) optimal power. Both single-period and multi-period problems can be solved.
- SOPFLOW solves a stochastic optimal power flow with (optional) security constraints for single and multiple periods.
ExaGO<sup>TM</sup> applications are interfaced with the following optimization solver packaages:
- Ipopt is a popular optimization package for solving nonlinear optimization problems that uses an interior-point algorithm.
- HiOp is a HPC package for optimization. ExaGO interfaces with two of its solvers -- a mixed sparse-dense interior-point solver (NewtonMDS) and a sparse interior-point solver (HiOPSparse). NewtonMDS allows execution of the optimization either on CPU and GPU. The sparse HiOp solver is currently supported on CPU only.
Note that not all applications can utilize all solvers yet. The following table lists the solver-application compatibility.
| Solver | OPFLOW | TCOPFLOW | SCOPLOW | SOPFLOW |
|---|---|---|---|---|
| Ipopt | Y | Y | Y | Y |
| HiOp | Y | Y | Y |
Additionally, note that SCOPFLOW and SOPFLOW with HiOp solver use Ipopt to solve a portion of the problem (base problem). So one must also configure with Ipopt when using HiOp solver for these applications.
Installing
Details installation instructions are given at INSTALL.md for information on acquiring, building and installing ExaGO.
Usage
Instructions for executing the different ExaGO<sup>TM</sup> applications is given below.
Options
Each application has a different set of options that are described in depth in the usage notes. These options can be passed optionally through an options file (-optionsfile <option_file>), or directly on the command line.
Since options may be specified in more than one location (on the command line, and through an options file), it is worth noting that the option specified on the command line supersede those in the options file. For example, if opflowoptions options file set the network file via the option -netfile case9mod.m, the following behavior occurs:
# This uses case9mod.m
./opflow -optionsfile opflowoptions
# This uses case118.m
./opflow -netfile case118.m -options_file opflowoptions
Visualization (experimental)
ExaGO has an experimental visualization to display the results of OPFLOW application on a map. See the visualization README for more information.
Contributing
Please see the developer guidelines before attempting to contribute. Feel free to raise an issue or contact the team if the guidelines are ambiguous or you have a particular question.
Authors
- Shrirang Abhyankar
- Slaven Peles
- Asher Mancinelli
- Cameron Rutherford
- Bruce Palmer
- Jaelyn Litzinger
- William Perkins
- Sayef Azad Sakin
- Joseph Macam
- Ryan Danehy
- Nicholson Koukpaizan
Acknowledgement
This package is developed as a part of ExaSGD project under the Exascale computing project.
Copyright
Copyright © 2020, Battelle Memorial Institute.
ExaGO<sup>TM</sup> is a free software distributed under a BSD 2-clause license. You may reuse, modify, and redistribute the software. See the license file for details.
Disclaimer
This material was prepared as an account of work sponsored by an agency of the United States Government. Neither the United States Government nor the United States Department of Energy, nor Battelle, nor any of their employees, nor any jurisdiction or organization that has cooperated in the development of these materials, makes any warranty, express or implied, or assumes any legal liability or responsibility for the accuracy, completeness, or usefulness or any information, apparatus, product, software, or process disclosed, or represents that its use would not infringe privately owned rights. Reference herein to any specific commercial product, process, or service by trade name, trademark, manufacturer, or otherwise does not necessarily constitute or imply its endorsement, recommendation, or favoring by the United States Government or any agency thereof, or Battelle Memorial Institute. The views and opinions of authors expressed herein do not necessarily state or reflect those of the United States Government or any agency thereof.