/rgrassdoc

Consult GRASS GIS Documentation in the RStudio Viewer or your Browser.

Primary LanguageR

rgrassdoc

License: GPL v3 R build status Codecov test coverage

CRAN Version Downloads

Are you a user of rgrass7, the R interfacte to GRASS GIS? Do you find yourself looking at the online GRASS manuals all the time? rgrassdoc provide two simple functions, man and browse, which allow you to visualize the GRASS GIS manual page for any GRASS module, right in the RStudio Viewer pane (or to easily open the manual page in your browser). The goal is to fluidify your workflow when using rgrass7.

Installation

Install from CRAN as such:

install.packages("rgrassdoc")

You can also install the dev version from GitHub like so:

devtools::install_github("vlucet/rgrassdoc")

Example

The man function supports non standard evaluation for even less typing and faster access to the information:

library(rgrassdoc)
#> ℹ GRASS GIS documentation - set to GRASS version 7.8

man(r.in.gdal)
#> ✓ Displaying module r.in.gdal in viewer
#> Session is not interactive - viewer cannot be used

man also supports partial matching:

man(r.gdal)
#> x No manual entry exists for module r.gdal
#> → Did you mean:
#>    r.in.gdal
#>    r.out.gdal
#> ✓ Displaying module r.in.gdal in viewer
#> Session is not interactive - viewer cannot be used

You can also open the page in your browser with browse. Your browser will then of course support links to other pages of the manual:

browse(v.overlay)

Using the RStudio viewer pane, this is what you can expect to see:

Viewer Pane