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) <http://www.aeso.ca> operates Alberta’s deregulated electricity market. AESO provides price, demand, and other valuable information through the publically accessible Energy Trading System (ETS) website <http://ets.aeso.ca>. 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 <http://bitbucket.org/kc/pyaeso> and releases are made via the Python Package Index at <http://pypi.python.org/pypi/pyaeso>. Online documentation is available at <http://packages.python.org/pyaeso>.

Audience

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 <http://docs.python.org/tutorial/>.

Requirements

Installation

Extract the archive, enter the recovered directory and type:

python setup.py install

Usage

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

>>> # Standard Library imports
>>> import sys
>>> import datetime
>>> try:
...   # Python 3.x style
...   from io import BytesIO
... except ImportError:
...   # Python 2.x
...   from StringIO import StringIO as BytesIO
...
>>> # 3rd Party Module imports
>>> import aeso
>>> from aeso import equilibrium
>>>
>>> # Program
>>> end_date = datetime.date.today()
>>> start_date = end_dt - datetime.timedelta(1)
>>> f = BytesIO()
>>> try:
...   equilibrium.dump_equilibrium(f, start_dt, end_dt)
...   ofs = f.seek(0)
...   data = list(equilibrium.parse_equilibrium_file(f))
... finally:
...   f.close()
...
>>> for d in data:
...   print d.t.astimezone(aeso.AB_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.

pyaeso 0.7 (2011-12-26)

  • Support for Python 2.7, 3.0, 3.1, and 3.2 added and tested.

  • Added timeout parameters to most urlopen and dump functions.

  • Simplified test infrastructure.

  • Fixed date handling in ATC to match AESO’s new format.

  • Removed all ATC functions from pyaeso.ets module. These functions have been marked as deprecated since 0.5 and have been replaced by the aeso.atc module.

  • Updated aeso.csd parser to convert total net generation values of ‘-’ to ‘None’ rather than throwing a ValueError.

  • Updated examples to use aeso package.

Bugs and Enhancements

If you would like to file a bug report or feature request then you can do so at <http://bitbucket.org/kc/pyaeso/issues>.

Contact

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) kcallin.net. 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.

Source Distributions

pyaeso-0.7.zip (221.3 kB view details)

Uploaded Source

pyaeso-0.7.tar.gz (193.0 kB view details)

Uploaded Source

pyaeso-0.7.tar.bz2 (188.2 kB view details)

Uploaded Source

File details

Details for the file pyaeso-0.7.zip.

File metadata

  • Download URL: pyaeso-0.7.zip
  • Upload date:
  • Size: 221.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyaeso-0.7.zip
Algorithm Hash digest
SHA256 a948eaf165f9de70225e4ea4d0a021d435b1bf0193307d48d0f0f1df507d5930
MD5 f39277d46482186cb894b2f8b21127bd
BLAKE2b-256 304ceefce3fe54dcd1ce1ef531cdaabecd2c9a30f3fbf8404e548d3dfb008da1

See more details on using hashes here.

File details

Details for the file pyaeso-0.7.tar.gz.

File metadata

  • Download URL: pyaeso-0.7.tar.gz
  • Upload date:
  • Size: 193.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyaeso-0.7.tar.gz
Algorithm Hash digest
SHA256 533ccecef1f5e18c57023866aa2f9d889dacb4e802f8123c64becdafd02142f8
MD5 e23017a164b10c9b0ab407be48d62cdb
BLAKE2b-256 8eb7eac405776cbe714d98b827b88ddee05041a2a425dbb9d52131c7d32ab851

See more details on using hashes here.

File details

Details for the file pyaeso-0.7.tar.bz2.

File metadata

  • Download URL: pyaeso-0.7.tar.bz2
  • Upload date:
  • Size: 188.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyaeso-0.7.tar.bz2
Algorithm Hash digest
SHA256 4f6ecd251eb2abc404bea28e0141b12c125f7ed45c6f4228268ac5650d4734ac
MD5 641750455826023782977eacf85ca2f2
BLAKE2b-256 5df53ae7255ddd9a1af02257d59209b43ab0a3271f6834f2480fb80cb9b61573

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page