Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ropensci/eia
An R package wrapping the US Energy Information Administration open data API.
https://github.com/ropensci/eia
cran eia eia-api energy-data energy-information-administration open-data r-package
Last synced: 3 months ago
JSON representation
An R package wrapping the US Energy Information Administration open data API.
- Host: GitHub
- URL: https://github.com/ropensci/eia
- Owner: ropensci
- License: other
- Created: 2019-06-26T17:24:27.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-13T22:07:21.000Z (7 months ago)
- Last Synced: 2024-04-14T07:11:39.174Z (7 months ago)
- Topics: cran, eia, eia-api, energy-data, energy-information-administration, open-data, r-package
- Language: R
- Homepage: https://docs.ropensci.org/eia
- Size: 1.36 MB
- Stars: 45
- Watchers: 5
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- open-sustainable-technology - EIA - An R package wrapping the US Energy Information Administration open data API. (Energy Systems / Energy Data Accessibility and Integration)
- jimsghstars - ropensci/eia - An R package wrapping the US Energy Information Administration open data API. (R)
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE, comment = "#>", out.width = "100%",
fig.path = "man/figures/README-", fig.width = 7, fig.height = 4, dpi = 150,
message = FALSE, warning = FALSE, error = FALSE
)
library(eia)
library(ggplot2)
```
# eia 
[](https://www.repostatus.org/)
[](https://github.com/ropensci/eia/actions/workflows/R-CMD-check.yaml)
[](https://app.codecov.io/gh/ropensci/eia?branch=master)
[](https://github.com/ropensci/software-review/issues/342)
[](https://cran.r-project.org/package=eia)
[](https://cran.r-project.org/package=eia)
[](https://github.com/ropensci/eia)
The `eia` package provides API access to data from the US [Energy Information Administration](https://www.eia.gov/) (EIA).
Pulling data from the US Energy Information Administration (EIA) API requires a registered API key.
A key can be obtained at no cost [here](https://www.eia.gov/opendata/register.php).
A valid email and agreement to the API Terms of Service is required to obtain a key.
`eia` includes functions for searching the EIA API data directory and importing various datasets.
Datasets returned by these functions are provided in a tidy format or alternatively in more raw form.
It also offers helper functions for working with EIA API date strings and time formats and for
inspecting different summaries of data metadata. The package also provides control over API key
storage and caching of API request results.
## Installation
Install the CRAN release of `eia` with
```{r instl1, eval=FALSE}
install.packages("eia")
```
or install the development version from GitHub with
```{r instl2, eval=FALSE}
# install.packages("remotes")
remotes::install_github("ropensci/eia")
```
## Example
After obtaining the API key, store it somewhere such as `.Renviron` and never have
to do anything with the key when using the package. Alternatively, set it manually
with `eia_set_key()` in the current R session. Further, it can always be passed
explicitly to the `key` argument of a given `eia` function.
### Load package and set key
```{r xmpl1, eval=FALSE}
library(eia)
# not run
eia_set_key("yourkey") # set API key if not already set globally
```
### Explore the API directory
Get a list of the EIA's data directory (and sub-directories) with `eia_dir()`.
```{r xmpl2}
# Top-level directory
eia_dir()
# Electricity sub-directory
eia_dir("electricity")
```
### Get data
Get annual retail electric sales for the Ohio residential sector since 2010
```{r xmpl3}
(d <- eia_data(
dir = "electricity/retail-sales",
data = "sales",
facets = list(stateid = "OH", sectorid = "RES"),
freq = "annual",
start = "2010",
sort = list(cols = "period", order = "asc"),
))
```
and make a nice plot.
```{r plt}
library(ggplot2)
ggplot(d, aes(x = period, y = sales / 1e3)) +
geom_bar(col = "steelblue", fill = "steelblue", stat = "identity") +
theme_bw() +
labs(
title = "Annual Retail Sales of Electricity (GWh)",
subtitle = "State: Ohio; Sector: Residential",
x = "Year", y = "Sales (GWh)"
)
```
## References
See the collection of vignette tutorials and examples as well as complete package
documentation available at the `eia` package [website](https://docs.ropensci.org/eia/).
---
Please note that the `eia` project is released with
a [Contributor Code of Conduct](https://github.com/ropensci/eia/blob/master/CODE_OF_CONDUCT.md).
By contributing to this project, you agree to abide by its terms.
[](https://ropensci.org)