{"id":13736118,"url":"https://github.com/ropensci/rerddap","last_synced_at":"2025-04-04T17:04:41.805Z","repository":{"id":23623174,"uuid":"26992679","full_name":"ropensci/rerddap","owner":"ropensci","description":"R client for working with ERDDAP servers","archived":false,"fork":false,"pushed_at":"2025-03-20T15:12:59.000Z","size":100867,"stargazers_count":41,"open_issues_count":2,"forks_count":14,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-28T16:04:26.755Z","etag":null,"topics":["api-client","erddap","noaa-data","r","r-package","rstats"],"latest_commit_sha":null,"homepage":"https://docs.ropensci.org/rerddap","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ropensci.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":"codemeta.json"}},"created_at":"2014-11-22T07:58:32.000Z","updated_at":"2025-03-20T15:10:05.000Z","dependencies_parsed_at":"2024-01-16T01:25:31.189Z","dependency_job_id":"6ee4e4e9-04f1-406f-959a-30ae748db4f5","html_url":"https://github.com/ropensci/rerddap","commit_stats":{"total_commits":337,"total_committers":10,"mean_commits":33.7,"dds":0.09792284866468848,"last_synced_commit":"5ef985bc4b58bd5200c011e356598e82ac783471"},"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Frerddap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Frerddap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Frerddap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Frerddap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ropensci","download_url":"https://codeload.github.com/ropensci/rerddap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247217172,"owners_count":20903008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-client","erddap","noaa-data","r","r-package","rstats"],"created_at":"2024-08-03T03:01:16.030Z","updated_at":"2025-04-04T17:04:41.782Z","avatar_url":"https://github.com/ropensci.png","language":"R","funding_links":[],"categories":["ERDDAP Clients","Resources for `R`"],"sub_categories":["Testing your code"],"readme":"rerddap\n=====\n\n```{r echo=FALSE}\nknitr::opts_chunk$set(\n  comment = \"#\u003e\",\n  collapse = TRUE,\n  warning = FALSE,\n  message = FALSE\n)\n```\n\u003c!-- badges: start --\u003e\n[![cran checks](https://cranchecks.info/badges/worst/rerddap)](https://cranchecks.info/pkgs/rerddap)\n  [![R-CMD-check](https://github.com/ropensci/rerddap/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/ropensci/rerddap/actions/workflows/R-CMD-check.yaml)\n[![codecov.io](https://codecov.io/github/ropensci/rerddap/coverage.svg?branch=master)](https://codecov.io/github/ropensci/rerddap?branch=master)\n[![rstudio mirror downloads](https://cranlogs.r-pkg.org/badges/rerddap)](https://github.com/r-hub/cranlogs.app)\n[![cran version](https://www.r-pkg.org/badges/version/rerddap)](https://cran.r-project.org/package=rerddap)\n\u003c!-- badges: end --\u003e\n\n`rerddap` is a general purpose R client for working with ERDDAP servers.\n\nPackage Docs: \u003chttps://docs.ropensci.org/rerddap/\u003e\n\n## Installation\n\nFrom CRAN\n\n```{r eval=FALSE}\ninstall.packages(\"rerddap\")\n```\n\nOr development version from GitHub\n\n```{r eval=FALSE}\nremotes::install_github(\"ropensci/rerddap\")\n```\n\n```{r}\nlibrary(\"rerddap\")\n```\n\nSome users may experience an installation error, stating to install 1 or more \npackages, e.g., you may need `DBI`, in which case do, for example, \n`install.packages(\"DBI\")` before installing `rerddap`.\n\n## Background\n\nERDDAP is a server built on top of OPenDAP, which serves some NOAA data. You can get gridded data (griddap (\u003chttps://upwell.pfeg.noaa.gov/erddap/griddap/documentation.html\u003e)), which lets you query from gridded datasets, or table data (tabledap (\u003chttps://upwell.pfeg.noaa.gov/erddap/tabledap/documentation.html\u003e)) which lets you query from tabular datasets. In terms of how we interface with them, there are similarities, but some differences too. We try to make a similar interface to both data types in `rerddap`.\n\n## NetCDF\n\n`rerddap` supports NetCDF format, and is the default when using the `griddap()` function. NetCDF is a binary file format, and will have a much smaller footprint on your disk than csv. The binary file format means it's harder to inspect, but the `ncdf4` package makes it easy to pull data out and write data back into a NetCDF file. Note the the file extension for NetCDF files is `.nc`. Whether you choose NetCDF or csv for small files won't make much of a difference, but will with large files.\n\n## Caching\n\nData files downloaded are cached in a single directory on your machine determined by the `hoardr` package. When you use `griddap()` or `tabledap()` functions, we construct a MD5 hash from the base URL, and any query parameters - this way each query is separately cached. Once we have the hash, we look in the cache directory for a matching hash. If there's a match we use that file on disk - if no match, we make a http request for the data to the ERDDAP server you specify.\n\n## ERDDAP servers\n\nYou can get a data.frame of ERDDAP servers using the function `servers()`. Most I think serve some kind of NOAA data, but there are a few that aren't NOAA data.  If you know of more ERDDAP servers, send a pull request, or let us know.\n\n## Meta\n\n* Please [report any issues or bugs](https://github.com/ropensci/rerddap/issues).\n* License: MIT\n* Get citation information for `rerddap` in R doing `citation(package = 'rerddap')`\n* 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Frerddap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fropensci%2Frerddap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Frerddap/lists"}