Skip to main content

A model to predict total electricity loads

Project description

build DOI


tell is an open-source Python package to model future hourly total electricity loads.


tell was created to:

  • Project the short- and long-term evolution of hourly electricity demand in response to changes in weather and climate.

  • Work at a spatial resolution adequate for input to a unit commitment/economic dispatch (UC/ED) model.

  • Maintain consistency with the long-term growth and evolution of annual state-level electricity demand projected by an economically driven human-Earth system model.

Install tell

tell is available via GitHub repository by using the pip install functionality. tell requires a Python version between 3.8 and 4.0 as well as a pip install to import the package. tell has been tested on Windows and Mac platforms. (Note: For those installing on Windows, tell is supported by GeoPandas functionality. Please see suggestions for installing GeoPandas on Windows here:

pip install tell

Check out a quickstarter tutorial to run tell

Run tell using the quickstarter tutorial: Quickstarter.

Getting started

New to tell? Get familiar with what tell is all about in our Getting Started documentation.

User guide

Our User Guide provides in-depth information on the key concepts of tell and how the model works.

Contributing to tell

Whether you find a typo in the documentation, find a bug, or want to develop functionality that you think will make tell more robust, you are welcome to contribute. Please see our Contribution Guidelines for more details.

API reference

The API Reference contains a detailed description of the tell API. The reference describes how the methods work and which parameters can be used. It assumes that you have an understanding of the key concepts.


Need help with tell or have a comment? Please open a new Issue with your question/comments.

Project details

Download files

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

Source Distribution

tell-1.0.0.tar.gz (102.0 MB view hashes)

Uploaded Source

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