TELL documentation

Date: Apr 10, 2023 Version: v1.0.0

Useful links: Source Repository | Issues & Ideas

tell was created to:

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

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

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

tell is targeted for users that are interested in grid stress modeling. This could include those whose business needs require accurate load forecasting (electric utilities, regulatory commissions, industrial and big commercial companies, etc.), researchers interested in energy system transitions, and many others in need of a framework for blending short and long-term load models with an explicit spatial resolution component.


Getting started

New to tell? Get familiar with what tell is all about.



Follow along with this Jupyter notebook to learn the ropes of tell.


User Guide

The user guide provides in-depth information on the key concepts of tell.


API reference

A detailed description of the tell API.