In ptaconet/getRemoteData: R functions to download & import various spatio-temporal data

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
require(kableExtra)
require(dplyr)
require(purrr)
require(getremotedata)

getremotedata

getremotedata is an R package that provides functions to harmonize the download of various open data collections available on the web.

Installation

The package can be installed with:

# install.packages("devtools")
devtools::install_github("ptaconet/getremotedata", build_vignettes = T, build_manual = T)

Collections available in getremotedata {#coll-available}

Currently getremotedata supports download of r nrow(grd_list_collections()) data collections. Most data collections provided through getremotedata have a spatial and a temporal component and a global coverage. Details of each product available for download are provided in the table above or through the function grd_list_collections(). Want more details on a specific collection ? Click on the "DOI" column !

Data collections available for download with getremotedata (click to expand)

getremotedata::grd_list_collections() %>%
  dplyr::select(collection,long_name,source,nature,doi,url_programmatic_access,param_variables,param_roi,param_time_range) %>%
  dplyr::rename(Collection=collection,Nature=nature,Name=long_name,DOI=doi,url_data_server=url_programmatic_access,Source=source) %>%
  kable() %>%
  kable_styling()

Get Started

Downloading the data with getremotedata is a simple two-steps workflow :

• With the function grd_get_url(), get the URL(s) of the data for :

• a collection : see previous section,

• (eventually) variables,
• (eventually) a region of interest,

• (eventually) a time range.

• With any data download function (e.g. httr::GET() or opendapr::odr_download_data()), download the data.

Additional functions include : list collection available for download ( gdr_list_collections() ), list variables available for the collections that have variables ( gdr_list_variables() )

Example

Have a look at the vignette("get-started") for a data download, import and plot workflow !

Acknowledgment

We thank the data providers for making their data freely available, and implementing open data access protocols that enable to download chunks of data.

This research has made use of IMCCE's Miriade VO tool

The initial development and first release of this package were financed by the MIVEGEC unit of the French Research Institute for Sustainable Development, as part of the REACT project.

ptaconet/getRemoteData documentation built on March 11, 2020, 11:08 p.m.