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.