energyRt is a package for R to develop Reference Energy System (RES) models (also known as Capacity Expansion Models (CEM), or “Bottom-Up” technological energy models), and analyze energy-technologies.
energyRt package provides tools to formulate the main “bricks” of an energy system model in R, and solve the model with one of the mainstream mathematical programming languages:
energyRt package is a set of classes, methods, and functions in R which are designed to:
- handle data, assist in defining RES models,
- helps to analyze data, check for errors and bugs before parsing it into solver,
- parses your dataset to GAMS or GLPK or Python/Pyomo or Julia/JuMP and runs them to solve the model,
- reads the solution and imports results back to R,
- assists with an analysis of results and reporting.
The current functionality allows development of multi-regional RES models from basic to well advanced level of complexity, including multiple regions, exogenous or endogenous interregional trade routes (for example, electricity grid), multilevel/nested time-slices, as well as flexible definition of technologies, storages. The package documentation is in development. By now, the best way to test the functionality of the package is to check fully functional examples of the model (see Examples bellow).
Assuming that R is already installed (if not, please download and install from https://www.r-project.org/), we also recommend RStudio (https://www.rstudio.com/), a powerful IDE (Integrated Development Environment) for R. It simplifies usage of R, provides number of features such as reproducible research (integration with Markdown, Sweave), integration with version control (github, svn).
The cost-minimising linear programming model (the set of equation for LP problem), emboddied into energyRt package requires additional software to solve it. Currently energyRt model code is written in several languages GAMS, GLPK, Python/Pyomo, Julia/Jump. At least one of them is required to solve the model.
The General Algebraic Modeling System (GAMS, http://gams.com/) is a powerful proprietary modeling system. Suitable LP solvers: CBC (included in the basic GAMS version, very powerful open source solver) or CPLEX. Others LP solvers have not been tested, but may work as well.
GAMS path should be also added to the environmental variables in your operating system.
GLPK is an open source Linear Programming Kit which includes powerful LP and MIP solver, and basic language for creating mathematical programming models (Mathprog or GMPL – for details see https://en.wikibooks.org/wiki/GLPK/GMPL_%28MathProg%29)
GLPK/GMPL is an open source alternative to GAMS, but only for LP and MIP problems. GLPK/GMPL is a bit slower than GAMS for small models, and significantly slower for large models, partially because of the slower Mathprog (GMPL) language processor.
Download GLPK binaries for Windows: https://sourceforge.net/projects/winglpk/ Follow the installation instructions, and add the path to the Windows environment variables.
We are not familiar if there are any GLPK-binaries/installers for Mac OSx. Therefore the following example is for installed from source with a standard procedure: gzip -d glpk-4.57.tar.gz
tar -x < glpk-4.57.tar
After installation check:
or glpsol -v
Response from glpsol will be an indicator of successful installation.
Please folow one of the standard procedures to install Python, make it available in your system’s terminal/cmd, install Pyomo package and LP solver(s). CPLEX or Gurobi are recommended for large scale models.
Similarly, follow the standard procedure of installing Julia and JuMP package, as well as the solvers and links to the solvers. Currently Julia/JuMP version of energyRt is suitable for small-scale models and is recommended for testing only, the code for large-scale models is in progress.