Skip to content

Commit

Permalink
update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Matt-Brigida committed Jun 25, 2023
1 parent f3355a3 commit 71f8d14
Showing 1 changed file with 13 additions and 14 deletions.
27 changes: 13 additions & 14 deletions man/EIAdata-package.Rd
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,16 @@
R wrapper for the US Energy Information Administration's (EIA's) API.
}
\description{
This package allows the user to query categories, and import data, through the EIA's API.
Resulting time series are objects of class xts. The EIA API offeres
access to over a million unique time series. The package also
contains a function which returns the latest EIA Natural Gas Storage Report.
This package allows the user to import data using version 2 of the EIA's API.
Resulting time series are objects of class xts. The EIA API offers
access to over a million unique time series.
}
\details{
\tabular{ll}{
Package: \tab EIAdata\cr
Type: \tab Package\cr
Version: \tab 0.1.2\cr
Date: \tab 2022-01-10\cr
Version: \tab 0.2.0\cr
Date: \tab 2023-07-01\cr
License: \tab GPL-2\cr
}
}
Expand All @@ -40,14 +39,6 @@ http://www.eia.gov/beta/api/
key <- "your_key"
# To see the top of the data category hierarchy.
getCatEIA(key=key)
# To see the subcategories and data sets in a particular category (for example 40827).
getCatEIA(key=key, cat=40827)
# To download and return a time series object of class xts
# for example ELEC.PLANT.GEN.13-WAT-ALL.Q
Expand All @@ -56,5 +47,13 @@ getEIA(ID = "ELEC.PLANT.GEN.13-WAT-ALL.Q", key = key)
# The if the EIA series ID contains a "-", the function will replace
# this with a ".". So the call above will return a time series of
# class xts named ELEC.PLANT.GEN.13.WAT.ALL.Q
# If you don't know the Series IDs for the data you want, do the following:
#
# 1. Go to [EIA's Opendata website](https://www.eia.gov/opendata/).
# 2. Go to the "Bulk File Downloads" by scrolling down a bit and looking on the right margin.
# 3. Choose the bulk download for the category that contains the series
# you want.
# For example if it is a Crude Oil series download the "Petroleum" file.
# 4. After the file downloads unzip it and find the Series ID you want.
}
}

0 comments on commit 71f8d14

Please sign in to comment.