U.S. Energy Information Administration logo
Skip to sub-navigation
‹ Analysis & Projections

International Energy Outlook 2021

Release date: October 6, 2021   |  Next release date: October 2022  |  IEO Narrative

IEO2021 WEPS Source Code and Input Files

The World Energy Project System (WEPS) is the model used to create our International Energy Outlook 2021 (IEO2021).  We developed WEPS primarily for EIA modelers. However, many obtain the model simply to use the data in its input files or to examine the source code. Because we developed WEPS, most of what constitutes the model is in the public domain and requires no licenses for use. However, WEPS does contain some proprietary components that are outside of the public domain but can be licensed. Detailed documentation of WEPS is available on our website.

The IEO2021 uses the WEPS archive, which is available as an encrypted zip file. The archive demonstrates that the published results from the IEO2021 Reference case can be replicated with the model and discloses the source code and inputs used.

Please email the WEPS team for the encryption key to the downloaded zip file. We will send files for the proprietary Oxford Economics macroeconomic model separately once Oxford Economics notifies us that you have obtained a license for the model.

PYTHON
EIA designed the WEPS archive for use as a 64-bit Python 3.7 application with Microsoft Windows. Installation files and additional Python libraries are listed below.

Installers
python-3.7.10.amd64.msi
HDF5-1.18.16 (64 bit)

Libraries
numpy-1.19.2+mkl-cp37-cp37m-win_amd64.whl
numexpr-2.7.2-cp37-cp37m-win_amd64.whl
openpyxl-3.0.4-py2.py3-none-any.whl
pandas-1.1.3-cp37-cp37m-win_amd64.whl
pyodbc-4.0.30-cp37-cp37m-win_amd64.whl
tables-3.6.1-cp37-cp37m-win_amd64.whl
tabulate-0.8.7-py3-none-any.whl
install wxPython-4.0.7-cp37-cp37m-win_amd64.whl
xlrd-1.2.0-py2.py3-none-any.whl
xlwt-1.3.0-py2.py3-none-any.whl
XlsxWriter-1.3.6-py3-none-any.whl
scipy-1.5.2-cp37-cp37m-win_amd64.whl
Bottleneck-1.3.2-cp37-cp37m-win_amd64.whl
docutils-0.16-py2.py3-none-any.whl
Jinja2-2.11.2-py3-none-any.whl
matplotlib-3.3.2-cp37-cp37m-win_amd64.whl
Sphinx-3.2.1-py3-none-any.whl
line_profiler-3.0.2-cp37-cp37m-win_amd64.whl
scikit_learn-0.23.2-cp37-cp37m-win_amd64.whl
patsy-0.5.1-py2.py3-none-any.whl
statsmodels-0.12.0-cp37-cp37m-win_amd64.whl
pytest-6.1.1-py3-none-any.whl
bcrypt-3.2.0-cp37-cp37m-win_amd64.whl

FORTRAN
Recompiling the WEPS Fortran modules requires the f2py library and mingw64.

GAMS
GAMS is used for the International Electricity Market Module. For IEO2021, we used GAMS version 24.7.3 with the Xpress solver version 8.5. More information is available on the GAMS website.

AIMMS
AIMMS is used for the International Coal Market Module. For IEO2021, we used AIMMS version 4 (release 4.69.1.0-x64-VS2017) with the Cplex solver. More information is available on the AIMMS website.

Oxford Economics Model
If you request files for the proprietary Oxford Economics macroeconomic model, we will send the files separately after you license the model from Oxford Economics. Contact Aaron Bergman for details.

Email the IEO team with technical questions about the WEPS archive.