Skip to main content
U.S. flag

An official website of the United States government

Publication Date
11 November 2022

tell: a Python package to model future totalelectricity loads in the United States



The purpose of the Total ELectricity Load (tell) model is to generate 21st century profiles of hourly electricity load (demand) across the Conterminous United States (CONUS). tell loads reflect the impact of climate and socioeconomic change at a spatial and temporal resolution adequate for input to an electricity grid operations model. tell uses machine learning to develop profiles that are driven by projections of climate/meteorology and population. tell also harmonizes its results with United States (U.S.) state-level, annual projections from a national- to global-scale energy-economy model. This model accounts for a wide range of other factors affecting electricity demand, including technology change in the building sector, energy prices, and demand elasticities, which stems from model coupling with the U.S. version of the Global Change Analysis Model (GCAM-USA). tell was developed as part of the Integrated Multisector Multiscale Modeling (IM3) project. IM3 explores the vulnerability and resilience of interacting energy, water, land, and urban systems in response to compound stressors, such as climate trends, extreme events, population, urbanization, energy system transitions, and technology change. 

McGrath, Casey R., Casey D. Burleyson, Zarrar Khan, Aowabin Rahman, Travis Thurber, Chris R. Vernon, Nathalie Voisin, and Jennie S. Rice. 2022. “Tell: A Python Package To Model Future Totalelectricity Loads In The United States”. Journal Of Open Source Software 7(79) (79). The Open Journal: 4472. doi:10.21105/joss.04472.
Funding Program Area(s)