FAROES is "Fusion Analysis, Research, and Optimization for Energy Systems". It is a Python package for optimizing fusion power plants, and especially for optimizing properties like their capital cost or levelized cost of energy. It is built in a modular fashion to allow user-developers to modify or add equations or analyses of their own design. It uses the OpenMDAO framework (openmdao.org) to provide interfaces to third-party nonlinear solvers and optimizers, especially gradient-based optimizers. The framework has advanced logging features to record solution data and metadata. This framework also allows users to easily specify the design variables, constraints, and optimization targets, or to define their own.
numpy>=1.21.0scipyopenmdao == 3.15.0. Can be installed withpip install "openmdao==3.15.0".ruamel >= 0.16, a yaml parser.plasmapy(https://www.plasmapy.org/).
All these can be installed automatically using the setup.py file.
Download the repo, cd to the folder and run pip install -e .. This will download and install requirements and install FAROES in 'editable' mode.
The two below can be installed on linux using the script available here: https://github.com/OpenMDAO/build_pyoptsparse/
pyoptsparse(https://github.com/mdolab/pyoptsparse) in order to access thepyOptSparseDriverwhich allows use of more powerful optimizers likeIPOPT.IPOPT. This is optimizer seems to perform a bit better than the implemntations ofCOBYLAorSLSQPwhich are included withscipy.
Note that an environment variable must be set in every terminal instance using IPOPT. We recommend adding a line to ~/.bashrc to do this automatically for every terminal instance: export LD_LIBRARY_PATH=$HOME/ipopt/lib:$LD_LIBRARY_PATH
docutils<0.17,>=0.15nbclient<0.6,>=0.2sphinx >= 4.4.0jupyter-sphinx==0.3.2Jinja2<3.1sphinxcontrib-bibtex >= 2.3jsonschema < 4sphinx_rtd_theme
The above packages are used to build the documentation for FAROES, and can be downloaded automatically by downloading the repos, cd to the folder, and running pip install -e .[docs], which will install FAROES in 'editable' mode alongside with the packages needed to build the documentation.
This work was supported by the U.S. Department of Energy under contract number DE-AC02-09CH11466.
The developer grants to the Government, and others acting on its behalf, a nonexclusive, paid-up, irrevocable, world-wide license in such copyrighted data to reproduce, prepare derivative works, distribute copies to the public, and perform publicly and display publicly, by or on behalf of the Government.