Easily Visualize Data from 'ERDDAP™' Servers via the 'rerddap' Package

Easily visualize and animate 'tabledap' and 'griddap' objects obtained via the 'rerddap' package in a simple one-line command, using either base graphics or 'ggplot2' graphics. 'plotdap' handles extracting and reshaping the data, map projections and continental outlines. Optionally the data can be animated through time using the 'gganmiate' package.


plotdap

The plotdap package makes it easy to map data acquired via the rerddap functions tabledap() or griddap().

Installation

You can install the released version of plotdap from CRAN with:

install.packages("plotdap")

The development version is available from Github and can be installed with:

devtools::install_github('rmendels/plotdap')

Functions

plotdap has six main functions and can produce plots in both base graphics and ggplot2 graphics, though certain features ony work wih ggplot2:

  • plotdap() which sets up the base map:

    • plotdap(method = c("ggplot2", "base"), mapData = maps::map("world", plot = FALSE, fill = TRUE), crs = NULL, datum = sf::st_crs(4326), mapTitle = NULL, mapFill = "gray80", mapColor = "gray90", ...)
  • add_tabledap() which adds the results from a rerddap::tabledap() call:

    • add_tabledap(plot, table, var, color = c("#132B43", "#56B1F7"), size = 1.5, shape = 19, animate = FALSE, cumulative = FALSE, ...)
  • add_griddap() which adds the results from a rerddap::griddap() call:

    • add_griddap(plot, grid, var, fill = "viridis", maxpixels = 10000, time = mean, animate = FALSE, cumulative = FALSE, ...)
  • add_ggplot() allows customization of the plot when ggplot2 is used:

    • add_ggplot(plot, ...)
  • bbox_set() which resets the bounding box as well as prepare the object foe interactive plotting:

    • ‘bbox_set(plotobj, landmask = TRUE, xlim = NULL, ylim = NULL, interactive = FALSE)’
  • add_griddap_contours() which adds contours to a add_griddap() object:

    • add_griddap_contours <- function(p, data, var, n_breaks = 10L, breaks = NULL, lon_col = "longitude", lat_col = "latitude", color = "black", linewidth = 0.3, alpha = 1, crs = 4326L)

Examples

Extensive examples are gven in the vignette, which can also be viewed at:

https://rmendels.github.io/Using_plotdap.html

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("plotdap")

1.2.0 by Roy Mendelssohn, 5 months ago


https://github.com/rmendels/plotdap


Report a bug at https://github.com/rmendels/plotdap/issues


Browse source code at https://github.com/cran/plotdap


Authors: Carson Sievert [aut] , Roy Mendelssohn [aut, ctb, cre]


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports cmocean, dplyr, gganimate, ggnewscale, ggplot2, isoband, lazyeval, lubridate, magrittr, mapdata, maps, raster, rerddap, rlang, scales, sf, tidyr, viridis

Suggests Cairo, knitr, plotly, rmarkdown, testthat


Imported by rerddapXtracto.


See at CRAN