Simple API to interact with the National Renewable Energy Laboratory's Annual Technology Baseline

nrelpy currently enables access to the following datasets:

• Annual Technology Baseline
  • Transportation (2020)
  • Electricity (2019 - 2022)
• GIS Renewable Energy Potential (state-level resolution)

This package may be installed from PyPI with

pip install nrelpy

The motivation for this API is to relieve researchers of the need to carry datasets in their repositories. Therefore, the most basic function of nrelpy returns a dataset as a pandas dataframe. This basic usage is shown below.

import nrelpy.atb as ATB

year = 2022
database = 'electricity'

df = ATB.as_dataframe(year=year, database=database)

import nrelpy.re_potential as REP

df = REP.as_dataframe()

From the top-level nrelpy directory, run pytest.

You can also check the testing coverage with

pytest --cov-config=.coveragerc --cov=nrelpy
coverage html

coverage html creates a nicely formatted html page with the entire coverage report. Simply open the htmlcov/index.html file in your browser.

Contributors should clone the repository and install an editable installation.

git clone https://github.com/samgdotson/nrelpy.git

cd nrelpy

pip install -e .

All pull requests must include appropriate, passing, tests.

Issues and feature requests are welcome.