Skip to main content

Pythonic access to the Alberta (Canada) Electric System Operator (AESO) Energy Trading System (ETS).

Project description

pyaeso is a python package that makes access to the Alberta[, Canada,] Electric System Operator’s (AESO) Energy Trading System (ETS) easier.

The Alberta Electric Systems Operator (AESO) <> operates Alberta’s deregulated electricity market. AESO provides price, demand, and other valuable information through the publically accessible Energy Trading System (ETS) website <>. This information is useful for economic analysis, power trading, electric system study, and electric system forecasting. The first step in using such information is to download it and parse it into useful data structures - a task performed by this library. Typically the data will feed statistical methods, heuristics, and system models to provide useful analysis of the Alberta electric system.

The pyaeso project is hosted at <> and releases are made via the Python Package Index at <>. Online documentation is available at <>.


A basic knowledge of the Python programming language is required to use this library. Python is an easy to learn, powerful language. An excellent introductory tutorial is available at <>.



Extract the archive, enter the recovered directory and type:

python install


Some code samples that use pyaeso are availble in the examples directory. One sample is listed here:

>>> '''Print yesterday's market clearing price/demand points and exit.'''
>>> # Standard library imports
>>> import sys
>>> from StringIO import StringIO
>>> import datetime
>>> # 3rd Party Libraries
>>> from pyaeso import ets
>>> end_date =
>>> start_date = end_date - datetime.timedelta(1)
>>> f = StringIO()
>>> ets.dump_pool_price(f, start_date, end_date)
>>> #print f.getvalue()
>>> data = list(ets.parse_pool_price_file(f))
>>> f.close()
>>> print '''Yesterday's market clearing price/demand points.'''
>>> for d in data:
>>>     print d.t.astimezone(ets.ALBERTA_TZ), '$' + str(d.price), str(d.demand) + 'MW'

Known Incompatibilities

  • Python <= 2.3 - Fails because pyaeso uses several standard library modules that were introduced in Python 2.4.
  • Python 3 - pyaeso uses the pytz package which has no Python 3 version (2009-11-14). The pyaeso library should be quickly available for Python 3 once pytz is updated.

Changes in pyaeso 0.5 (2010-03-16)

  • Beginning long-term migration of code from pyaeso package to aeso package.
  • Added Current Supply/Demand (CSD) report to aeso.csd module.
  • Added Alberta Interconnected Electrical System (AIES) log report to aeso.aieslog module.
  • Several modules now have doctests.
  • Added and examples.

Bugs and Enhancements

If you would like to file a bug report or feature request then you can do so at <>.


As the maintainer of this library I, Keegan Callin, would welcome your polite, constructive comments and criticisms of this library. I can be reached by email using the address kc (at) If you need to talk to me on the telephone or send me something by snail mail, send me an email and I’ll gladly mail you instructions on how to reach me.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyaeso, version 0.5
Filename, size File type Python version Upload date Hashes
Filename, size pyaeso-0.5.tar.bz2 (183.7 kB) File type Source Python version None Upload date Hashes View
Filename, size pyaeso-0.5.tar.gz (184.1 kB) File type Source Python version None Upload date Hashes View
Filename, size (194.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page