The Public Utility Data Liberation Project#
What is PUDL?#
The PUDL Project is an open source data processing pipeline that makes US energy data easier to access and use programmatically.
Hundreds of gigabytes of valuable data are published by US government agencies, but it’s often difficult to work with. PUDL takes the original spreadsheets, CSV files, and databases and turns them into a unified resource. This allows users to spend more time on novel analysis and less time on data preparation.
What data is available?#
PUDL currently integrates data from:
EIA Form 860: 2001-2022
EIA Form 860m: 2023-06
EIA Form 861: 2001-2022
EIA Form 923: 2001-2022
FERC Form 1: 1994-2021
FERC Form 714: 2006-2020
Thanks to support from the Alfred P. Sloan Foundation Energy & Environment Program, from 2021 to 2024 we will be integrating the following data as well:
Who is PUDL for?#
The project is focused on serving researchers, activists, journalists, policy makers, and small businesses that might not otherwise be able to afford access to this data from commercial sources and who may not have the time or expertise to do all the data processing themselves from scratch.
We want to make this data accessible and easy to work with for as wide an audience as possible: anyone from a grassroots youth climate organizers working with Google sheets to university researchers with access to scalable cloud computing resources and everyone in between!
How do I access the data?#
There are several ways to access PUDL outputs. For more details you’ll want to check out the complete documentation, but here’s a quick overview:
We publish a lot of the data on https://data.catalyst.coop using a tool called Datasette that lets us wrap our databases in a relatively friendly web interface. You can browse and query the data, make simple charts and maps, and download portions of the data as CSV files or JSON so you can work with it locally. For a quick introduction to what you can do with the Datasette interface, check out this 17 minute video.
This access mode is good for casual data explorers or anyone who just wants to grab a small subset of the data. It also lets you share links to a particular subset of the data and provides a REST API for querying the data from other applications.
Docker + Jupyter#
Want access to all the published data in bulk? If you’re familiar with Python and Jupyter Notebooks and are willing to install Docker you can:
Run the archived image using
Access the data via the resulting Jupyter Notebook server running on your machine.
The PUDL Examples repository has more detailed instructions on how to work with the Zenodo data archive and Docker image.
The PUDL Development Environment#
If you’re more familiar with the Python data science stack and are comfortable working
conda environments, and the Unix command line, then you can set up the
whole PUDL Development Environment on your own computer. This will allow you to run the
full data processing pipeline yourself, tweak the underlying source code, and (we hope!)
make contributions back to the project.
Nightly Data Builds#
If you are less concerned with reproducibility and want the freshest possible data we automatically upload the outputs of our nightly builds to public S3 storage buckets as part of the AWS Open Data Registry. This data is based on the dev branch, of PUDL, and is updated most weekday mornings. It is also the data used to populate Datasette.
The nightly build outputs can be accessed using the AWS CLI, the S3 API, or downloaded directly via the web. See Accessing Nightly Builds for links to the individual SQLite, JSON, and Apache Parquet outputs.
Contributing to PUDL#
Find PUDL useful? Want to help make it better? There are lots of ways to help!
First, be sure to read our Code of Conduct.
You can file a bug report, make a feature request, or ask questions in the Github issue tracker.
Feel free to fork the project and make a pull request with new code, better documentation, or example notebooks.
Make a recurring financial contribution to support our work liberating public energy data.
Hire us to do some custom analysis and allow us to integrate the resulting code into PUDL.
For more information check out the Contributing section of the PUDL Documentation
In general, our code, data, and other work are permissively licensed for use by anybody, for any purpose, so long as you give us credit for the work we’ve done.
For bug reports, feature requests, and other software or data issues please make a GitHub Issue.
For more general support, questions, or other conversations around the project that might be of interest to others, check out the GitHub Discussions
If you’d like to get occasional updates about the project sign up for our email list.
Want to schedule a time to chat with us one-on-one about your PUDL use case, ideas for improvement, or get some personalized support? Join us for Office Hours
Follow us on Twitter: @CatalystCoop
More info on our website: https://catalyst.coop
To hire us to provide customized data extraction and analysis, you can email the maintainers: firstname.lastname@example.org
About Catalyst Cooperative#
Catalyst Cooperative is a small group of data wranglers and policy wonks organized as a worker-owned cooperative consultancy. Our goal is a more just, livable, and sustainable world. We integrate public data and perform custom analyses to inform public policy (Hire us!). Our focus is primarily on mitigating climate change and improving electric utility regulation in the United States.