Roy Mendelssohn - NOAA Federal
2017-Dec-22 23:35 UTC
[R] Development versions of xtractomatic and rerddapXtracto
If you are a user of the R package "xtractomatic", I have a new development version available, as well as a test version of the package "rerddapXtracto". The biggest changes are functions that can take the output of any of the data download functions and quickly map the data. These functions use the package "plotdap". Also, a lot of the code in the development version of "xtractomatic" has been cleaned up and simplified. If you have used "xtractomatic" before, be certain to read the vignette (https://rmendels.github.io/Usingxtractomatic_Dev.nb.html) as there have been some changes, most notably in the order that arguments are passed in the function calls, what is optional in the call, and the two new plotting routines. These changes were made to support the idea that "data" should be the first argument in the function calls, and also to make the xtractomatic functions very close to the calls in "rerddapXtracto". This is important because this will likely be the last version of "xtractomatic", with future development being put on "rerddapXtracto". "rerddapXtracto" has the same functionality as "xtractomatic" but will work with any gridded dataset on any ERDDAP server, by making use of the R package "rerddap", while "xtractomatic" only works with certain datasets on the ERD ERDDAP server. The advantage of the "xtractomatic" approach is we chose what we thought were the most useful datasets (out of over 1000 datasets), and information about those datasets are built into the program. But that means the "xtractomatic" package can not be used to access a large number of datasets. "rerddapXtracto" is much more general, but the user must know the ERDDAP server they want to access, which dataset, and must first obtain information about that dataset by using the function rerddap::info(). "rerddapXtracto" also now has simple mapping of the data using the package "plotdap". The vignette for "rerddapXtracto" is at https://rmendels.github.io/UsingrerddapXtracto.nb.html. I have not submitted these packages to CRAN because at the moment they depend either on packages or versions of packages that are only on Github, not CRAN. While I know there are ways around this when submitting to CRAN, I feel that this defeats a lot of the purpose of CRAN. CRAN checks consistency of package with other packages, with development versions of R, and also notifies developers when packages they use are changed, and provides an uniform installation of compatible packages. These packages will be submitted to CRAN when the packages they depend on are available. The best information on installation is the vignettes. The quick start version, the development version of "xtractomatic" can be installed using: devtools::install_github("rmendels/xtractomatic", ref = "development") and "rerddapXtracto" can be installed using: devtools::install_github("rmendels/rerddapXtracto") Several warnings about the installations: 1. Both packages use the package "plotdap" for graphics. This package at the moment is available only on Github, at: https://github.com/ropensci/plotdap 2. "plotdap" itself depends on a fairly large number of packages, In some testing, people sometimes had to get a more recent, non-CRAN version of other packages to have correct functionality. If you run into problems let me know. 3. "rerddapXtracto" depends on the package "rerddap", but not on the CRAN version. There was some changes in functionality in the Github version, in particular the handling of caches, as well as some code changes. To use "rerddapXtracto" you must install the Github version of "rerddap" available from https://github.com/ropensci/rerddap. Basically the initial installation of either package may not go cleanly, if there are problems let me know, it may take several attempts to get all the dependencies correct. As noted earlier, this is one of the benefits provided by CRAN, and why I do not want to put these packages on CRAN until all of their dependencies are there also. -Roy ********************** "The contents of this message do not reflect any position of the U.S. Government or NOAA." ********************** Roy Mendelssohn Supervisory Operations Research Analyst NOAA/NMFS Environmental Research Division Southwest Fisheries Science Center ***Note new street address*** 110 McAllister Way Santa Cruz, CA 95060 Phone: (831)-420-3666 Fax: (831) 420-3980 e-mail: Roy.Mendelssohn at noaa.gov www: http://www.pfeg.noaa.gov/ "Old age and treachery will overcome youth and skill." "From those who have been given much, much will be expected" "the arc of the moral universe is long, but it bends toward justice" -MLK Jr.