rnoaa

An R interface to many National Oceanic and Atmospheric Administration data sources.
https://github.com/ropensci/rnoaa

Category: Climate Change
Sub Category: Climate Data Access and Visualization

Keywords

climate noaa noaa-data r r-package rstats

Keywords from Contributors

ecology cycle routes tidyverse weather carpentries climate-data occurrence hydrology genome

Last synced: about 17 hours ago
JSON representation

Repository metadata

R interface to many NOAA data APIs

• Host: GitHub
• URL: https://github.com/ropensci/rnoaa
• Owner: ropensci
• License: other
• Created: 2013-07-08T22:31:24.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2025-02-04T14:23:39.000Z (3 months ago)
• Last Synced: 2025-04-25T13:49:04.180Z (1 day ago)
• Topics: climate, noaa, noaa-data, r, r-package, rstats
• Language: R
• Homepage: https://docs.ropensci.org/rnoaa
• Size: 104 MB
• Stars: 336
• Watchers: 24
• Forks: 84
• Open Issues: 27
• Releases: 27
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Codemeta: codemeta.json

README.Rmd

          rnoaa
=====

```{r echo=FALSE}
library("knitr")
hook_output <- knitr::knit_hooks$get("output")
knitr::knit_hooks$set(output = function(x, options) {
   lines <- options$output.lines
   if (is.null(lines)) {
     return(hook_output(x, options))  # pass to default hook
   }
   x <- unlist(strsplit(x, "\n"))
   more <- "..."
   if (length(lines)==1) {        # first n lines
     if (length(x) > lines) {
       # truncate the output, but add ....
       x <- c(head(x, lines), more)
     }
   } else {
     x <- c(if (abs(lines[1])>1) more else NULL,
            x[lines],
            if (length(x)>lines[abs(length(lines))]) more else NULL
           )
   }
   # paste these lines together
   x <- paste(c(x, ""), collapse = "\n")
   hook_output(x, options)
 })

knitr::opts_chunk$set(
  comment = "#>",
  collapse = TRUE,
  warning = FALSE,
  message = FALSE,
  fig.width = 10,
  fig.path = "man/figures/",
  cache.path = "inst/cache/"
)
```

[![Project Status: Unsupported](https://www.repostatus.org/badges/latest/unsupported.svg)](https://www.repostatus.org/#unsupported)
[![cran checks](https://cranchecks.info/badges/worst/rnoaa)](https://cranchecks.info/pkgs/rnoaa)
[![R-check](https://github.com/ropensci/rnoaa/workflows/R-check/badge.svg)](https://github.com/ropensci/rnoaa/actions)
[![codecov.io](https://codecov.io/github/ropensci/rnoaa/coverage.svg?branch=master)](https://codecov.io/github/ropensci/rnoaa?branch=master)
[![rstudio mirror downloads](https://cranlogs.r-pkg.org/badges/rnoaa?color=C9A115)](https://github.com/r-hub/cranlogs.app)
[![cran version](https://www.r-pkg.org/badges/version/rnoaa)](https://cran.r-project.org/package=rnoaa)


`rnoaa` is an R interface to many NOAA data sources. We don't cover all of them, but we include many commonly used sources, and add we are always adding new sources. We focus on easy to use interfaces for getting NOAA data, and giving back data in easy to use formats downstream. We currently don't do much in the way of plots or analysis. To get started see: https://docs.ropensci.org/rnoaa/articles/rnoaa.html

## NOTICE: PACKAGE TO BE ARCHIVED

NOAA has changed not only the base URL of the API but reorganized the structure and endpoints of the data and API. The current `rnoaa` package is still functional with the NOAA API v2 but the data available in the API end at approximately 2022-09-15. A new NOAA weather package is planned to replace rnoaa functionality where possible. At that point the rnoaa package will be archived.

## Data sources in rnoaa

* NOAA NCDC climate data:
    * We are using the NOAA API version 2
    * Docs for the NCDC API are at https://www.ncdc.noaa.gov/cdo-web/webservices/v2
    * GHCN Daily data is available at http://www.ncdc.noaa.gov/ghcn-daily-description via FTP and HTTP
* Severe weather data docs are at https://www.ncdc.noaa.gov/swdiws/
* Sea ice data (ftp://sidads.colorado.edu/DATASETS/NOAA/G02135/shapefiles)
* NOAA buoy data (https://www.ndbc.noaa.gov/)
* ERDDAP data (https://upwell.pfeg.noaa.gov/erddap/index.html)
  * Now in package rerddap (https://github.com/ropensci/rerddap)
* Tornadoes! Data from the NOAA Storm Prediction Center (https://www.spc.noaa.gov/gis/svrgis/)
* HOMR - Historical Observing Metadata Repository (http://www.ncdc.noaa.gov/homr/api)
* GHCND FTP data (ftp://ftp.ncdc.noaa.gov/pub/data/noaa) - NOAA NCDC API has some/all (not sure really) of this data, but FTP allows to get more data more quickly
* Extended Reconstructed Sea Surface Temperature (ERSST) data (https://www.ncdc.noaa.gov/data-access/marineocean-data/extended-reconstructed-sea-surface-temperature-ersst-v4)
* NOAA CO-OPS - tides and currents data (https://tidesandcurrents.noaa.gov/)
* NOAA Climate Prediction Center (CPC) (http://www.cpc.ncep.noaa.gov/)
* Africa Rainfall Climatology version 2 (ftp://ftp.cpc.ncep.noaa.gov/fews/fewsdata/africa/arc2/ARC2_readme.txt)
* Blended Sea Winds (https://www.ncdc.noaa.gov/data-access/marineocean-data/blended-global/blended-sea-winds)
* Local Climatological Data (https://www.ncdc.noaa.gov/cdo-web/datatools/lcd)
* Storm Events Database (https://www.ncdc.noaa.gov/stormevents/)

## Help/Getting Started

Documentation is at https://docs.ropensci.org/rnoaa/, and there are many vignettes in the package itself, available in your R session, or on CRAN (https://cran.r-project.org/package=rnoaa). The tutorials:

* **Getting started - start here**
* NOAA Buoy vignette
* NOAA National Climatic Data Center (NCDC) vignette (examples)
* NOAA NCDC attributes vignette
* NOAA NCDC workflow vignette
* Sea ice vignette
* Severe Weather Data Inventory (SWDI) vignette
* Historical Observing Metadata Repository (HOMR) vignette

## netcdf data

Some functions use netcdf files, including:

* `ersst`
* `buoy`
* `bsw`
* `argo`
 
You'll need the `ncdf4` package for those functions, and those only. `ncdf4` is in Suggests in this package, meaning you only need `ncdf4` if you are using any of the functions listed above. You'll get an informative error telling you to install `ncdf4` if you don't have it and you try to use the those functions. Installation of `ncdf4` should be straightforward on any system. See https://cran.r-project.org/package=ncdf4

## NOAA NCDC Datasets

There are many NOAA NCDC datasets. All data sources work, except `NEXRAD2` and `NEXRAD3`, for an unknown reason. This relates to `ncdc_*()` functions only.

```{r echo=FALSE}
library('rnoaa')
dat <- ncdc_datasets()$data
dat <- dat[, !names(dat) %in% 'uid']
dat <- dat[, c('id', 'name', 'mindate', 'maxdate', 'datacoverage')]
names(dat) <- c('Dataset', 'Description', 'Start Date', 'End Date', 'Data Coverage')
knitr::kable(dat)
```

```{r echo=FALSE}
cat(paste0("table updated on ", Sys.Date()))
```

**NOAA NCDC Attributes**

Each NOAA dataset has a different set of attributes that you can potentially get back in your search. See https://www.ncei.noaa.gov/access for detailed info on each dataset. We provide some information on the attributes in this package; see the vignette for attributes (https://docs.ropensci.org/rnoaa/articles/ncdc_attributes.html) to find out more


## Contributors

* Scott Chamberlain (https://github.com/sckott)
* Daniel Hocking (https://github.com/djhocking)
* Brooke Anderson (https://github.com/geanders)
* Maëlle Salmon (https://github.com/maelle)
* Adam Erickson (https://github.com/adam-erickson)
* Nicholas Potter (https://github.com/potterzot)
* Joseph Stachelek (https://github.com/jsta)
* Daniel Hocking (https://github.com/djhocking)

## Meta

* Please report any issues or bugs: https://github.com/ropensci/rnoaa/issues
* License: MIT
* Get citation information for `rnoaa` in R doing `citation(package = 'rnoaa')`
* Please note that this package is released with a Contributor Code of Conduct (https://ropensci.org/code-of-conduct/). By contributing to this project, you agree to abide by its terms.

        

---

Owner metadata

• Name: rOpenSci
• Login: ropensci
• Email: [email protected]
• Kind: organization
• Description:
• Website: https://ropensci.org/
• Location: Berkeley, CA
• Twitter: rOpenSci
• Company:
• Icon url: https://avatars.githubusercontent.com/u/1200269?v=4
• Repositories: 307
• Last ynced at: 2023-03-10T20:30:59.242Z
• Profile URL: https://github.com/ropensci

---

GitHub Events

Total

• Watch event: 6
• Push event: 1

Last Year

• Watch event: 6
• Push event: 1

---

Committers metadata

Last synced: 6 days ago

Name	Email	Commits
Scott Chamberlain	m****s@g****m	902
Brooke Anderson	g****n@j****u	103
Nicholas Potter	p****t@g****m	27
Daniel Hocking	d****g@g****m	25
DougFirErickson	a****n@g****m	23
jsta	j****k@u****u	14
Elio Campitelli	e****i@g****m	12
masalmon	m****n@y****e	11
Ewen2015	w****n@o****m	9
Bob Rudis	b****b@r****t	8
grandpotato	k****o@g****m	7
Tom 2 Philippi	t****i@n****v	7
Karthik Ram	k****m@g****m	6
Philip Shirk	p****k@g****m	6
mps9506	m****m@g****m	6
Brooke Anderson	b****n@c****u	5
Ed Weber	e****r@n****v	5
Ryan Hicks	r****1@g****m	5
Steven	s****y@g****m	5
Edmund Hart	e****t@g****m	4
Jillian Dunic	j****c@g****m	4
RyanG	r****n@g****m	4
Jeroen Ooms	j****s@g****m	3
MIRANDA FIX	m****x@g****m	3
Rachel Severson	r****n@c****u	3
jferreri	j****i@g****m	3
Bryce Mecum	p****h@g****m	2
Casey Patrizio	c****8@g****m	2
Max Joseph	m****h@g****m	2
Nicholas Tierney	n****y@g****m	2
and 17 more...

Committer domains:

• colostate.edu: 3
• rams.colostate.edu: 1
• ucar.edu: 1
• irco.com: 1
• economist.com: 1
• wisc.edu: 1
• berkeley.edu: 1
• msu.edu: 1
• noaa.gov: 1
• nps.gov: 1
• rudis.net: 1
• utexas.edu: 1
• jhsph.edu: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ropensci/rnoaa

---

---

---

Dependencies

Score: 9.744550435974908