PyPSA/pypsa-usa

Pull energy consumption survay data from PUDL

Open

#541 opened on Feb 13, 2025

View on GitHub
 (0 comments) (0 reactions) (0 assignees)Python (52 forks)auto 404
Sectorenhancementgood first issue

Repository metrics

Stars
 (140 stars)
PR merge metrics
 (PR metrics pending)

Description

Feature Request

PUDL archives the EIA Residential Energy Consumption Survey, Commercial Energy Consumption Survey and Manufacturing Energy Consumption Survey (see here for the archives). Would be good to pull this data directly from these archives, as it will make updating easier in the future. Moreover, its clearer to new users what data we are actually using.

Suggested Solution

Add a new retrieve rule that pulls these data sources. Then point the snakemake rules to the sources. Should be drop in replacements; ie. underlying code filtering should not need to change.

Additional Info

No response

Contributor guide

Research direction
Explore PUDL archives for the three consumption surveys (RECS, CBECS, MECS) to understand the data format and available endpoints. Identify how to create a new Snakemake rule that retrieves this data and integrates with existing consumption survey processing.
Tech stack
python
Domain
databackend
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
PythonSnakemake
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
40