International Energy Agency (IEA)

From Wiki
Revision as of 21:06, 25 May 2017 by AlannaMarkle (Talk | contribs)

Jump to: navigation, search


The International Energy Agency commenced its operation in 1974 under the auspices of the Organization for Economic Co-operation and Development (OECD). The IEA is the energy forum for 26 Member countries, all from the OECD, to improve the world’s energy supply and to promote reliable databases for energy-related information. IEA member governments are committed to sharing energy information, to co-ordinating their energy policies and to co-operating in the development of rational energy programs. IEA publishes monthly reports on electricity, natural gas, prices, and the oil market. The World Energy Outlook is the IEA's most comprehensive publication, and is considerd " the world’s most authoritative source of energy market analysis and projections."

The main IEA sources used by IFs are the World Energy Balances (WEB) and World Energy Statistics (WES), databases assocated with the World Energy Outlook. They contain variables such as the production, trade, and consumption of coal, oil, gas, electricity, heat, renewables, and waste for OECD countries and over 100 non-OECD countries.


Data Acquisition

Unlike most data used in IFs, IEA data from the WEB and WES are not open source. The data must be purchased from the IEA and is delivered on two CD-ROMs.[1] Each disc runs on a database management software program called Beyond 20/20 that comes loaded on the discs, along with the data. Financial support for the purchase of the IEA data is available from a University Library Association grant. Pardee successfully applied for grant funding through this program for the 2017 update with the help of staff at the Anderson Academic Commons at the University of Denver.


Full documentation is available for each dataset detailing its contents, structure, definitions, geographical coverage, etc. 

World Energy Balances 2016 Database Documentation

World Energy Statistics 2016 Database Documentation

Batch Pull

The IEA update is performed as a Batch Pull that includes 138 series using the Batch Data Update feature in IFs. In the display, "IEA" is the Source, "IEA Countries" are used for country concordance. For the Code Location in Source Data portion of the update form, the source Excel must be formatted so that each Code in Source term is in a different column. For example, SeriesEnImportsOilProductsIEA's Code in Sourse is "Imports.Oil products," so there should be two columns with "Imports" in one and "Oil products" in the next.

Series Codes

Because this is a batch pull, each series needs a Code in addition to a variable name to be imported. The codes are listed in the DataDict, and should match (or be extremely close to) the series name in the IEA source database. For the 2017 update, series on the WEB and WES discs were organized by two parameters, FLOW and PRODUCT, where FLOW is the first term of the Code and PRODUCT is the second term of the Code. Drag and drop FLOW, PRODUCT, UNIT, and COUNTRY to column and row headers to reconfigure the display in Beyond 20/20.


Variable: EnImportsOilProductsIEA

Code: Imports.Oil products

FLOW: Imports

PRODUCT: Oil products

See Beyond 20/20 screenshot here - File:IEA Beyond 2020 screenshot.png

Pulling and Formatting the Data


Ideally, the IEA series are pulled from the discs in bulk. As of the 2017 update, Beyond 20/20 limits the number of records that can be exported at one time, preventing all the data from being exported at once; however, it is possible to pull all records by PRODUCT or FLOW. For example, it is possible to pull all natural gas or oil products series  at once from the WEB disc. Pull the data by assembling the correct configuration in Beyond 20/20, then going to File>Save As and saving it as a .xls file. It is also possible to copy and past individual (or a few) series into an Excel by highlighting them, but not a large number of series at once. [NOTE: The directly exported Excel file did not work on Pardee computers due to a policy setting issue, so the data had to be copied and pasted into a new sheet to be manipulated]

See Beyond 20/20 screenshot here - 


Once the series have been pulled by PRODUCT or FLOW, they need to be cleaned. Missing data are marked with a "..", "x", or "n," so remove these with a Find+Replace. The data can then be imported using the codes assocated with the FLOW and PRODUCT, along with the country name. It may be necessary to also clean the codes, for example if there is a unit listed parenthetically after the name of the product (i.e. "Solar thermal (TJ-net)")

See Souce Excel screenshot here - 


Variable: Variable names were not changed from previous years this data was pulled, and no additional variables were added for the 2017 pull.

Table: These were not changed from previous years this data was pulled. 

Code in Source: Identifies the series for batch import; were not changed from previous years this data was pulled.

Groups: These were not changed from previous years this data was pulled. 

Subgroups: These were not changed form previoys years this data was pulled.

Definitions and Units: These were not changed from previous years this data was pulled.

Extended Source Defn: All were marked as "No Extended Source" for 2017 pull. Units used in this dataset include BBOE and GwHr.

Years: Years for every series were changed to available data provided through the database. Most series begin in 1960 with the exception of EnExportsOilIEA, EnImportsOiliIEA, and EnProdOilIEA, which begin in 1971. All extend through either 2014 or 2015 as of the 2017 update.

Source: The source used in the 2017 update for all batch pull IEA series is "IEA (International Energy Agency) Batch Pull."

Original Source: The original source used in the 2017 update for all series is the "World Energy Outlook."

Notes: Notes were updated to reflect the source disc for the series (WEB or WES), any conversion factors used, and the appropriate initials.

Aggregation: Aggregations were not changed from pervious updates.

Disaggregation: Disaggregations were not changed from previous updates.

Name in source: Was updated based on the name of each variable as it is displayed in the Beyond 20/20 database format; generally matches the Code in Source.

Decimal places: These were not changed from previous years this data was pulled.

Country Concordance: FAO Countries were used.

Formula: These were not changed from previous years this data was pulled, and are either blank or convert data from ktoe to BBOE or GwH

Preprocessor Series

Of the 138 IEA Batch Pull series, 24 are preprocessor. These series should be updated first in any IEA batch update. They include:


Country Concordance