wbt_init: Initialize WhiteboxTools

Description

wbt_init(): Check if a suitable WhiteboxTools executable is present. Search default path in package directory or set it manually with exe_path.

wbt_options(): Get/set package options

whitebox.exe_path - character. Path to executable file. The default value is the package installation directory, subdirectory "WBT", followed by whitebox_tools.exe or whitebox_tools. Set the whitebox.exe_path option using wbt_init() exe_path argument
whitebox.wd - character. Path to WhiteboxTools working directory. Used as --wd argument for tools that support it when wd is not specified elsewhere.
whitebox.verbose - logical. Should standard output from calls to executable be cat() out for readability? Default is result of interactive(). Individual tools may have verbose_mode setting that produce only single-line output when FALSE. These argument values are left as the defaults defined in the package documentation for that function. When whitebox.verbose=FALSE no output is produced. Set the value of whitebox.verbose with wbt_verbose() verbose argument.
whitebox.compress_rasters - logical. Should raster output from WhiteboxTools be compressed? Default: FALSE. Set the value of whitebox.compress_rasters with wbt_compress_rasters() compress_rasters argument.
whitebox.max_procs - integer. Maximum number of processes for tools that run in parallel or partially parallelize. Default: -1 uses all of the available cores.

wbt_exe_path(): Get the file path of the WhiteboxTools executable.

wbt_wd(): Get or set the WhiteboxTools working directory. Default: "" (unset) is your R working directory if no other options are set.

wbt_verbose(): Check verbose options for WhiteboxTools

wbt_compress_rasters(): Check raster compression option for WhiteboxTools. Default: FALSE

wbt_max_procs(): Check maximum number of processes for for tools that run in parallel or partially parallelize. Default: -1 uses all of the available cores.

Usage

wbt_init(exe_path = wbt_exe_path(shell_quote = FALSE), ...)
wbt_options(
  exe_path = NULL,
  wd = NULL,
  verbose = NULL,
  compress_rasters = NULL,
  max_procs = NULL
)
wbt_exe_path(exe_path = NULL, shell_quote = TRUE)
wbt_default_path()
wbt_wd(wd = NULL)
wbt_verbose(verbose = NULL)
wbt_compress_rasters(compress_rasters = NULL)
wbt_max_procs(max_procs = NULL)

Value

wbt_init(): logical; TRUE if binary file is found at exe_path

wbt_options(): an invisible list containing current whitebox.exe_path, whitebox.verbose, whitebox.compress_rasters, and whitebox.max_procs options

Returns the file path of WhiteboxTools executable.

wbt_wd(): character; when working directory is unset, will not add --wd= arguments to calls and should be the same as using getwd(). See Details.

wbt_verbose(): logical; defaults to result of interactive()

wbt_compress_rasters(): logical; defaults to NA

wbt_max_procs(): integer; defaults to NA_integer_

Arguments

exe_path: Optional: User-supplied path to WhiteboxTools executable. Default: NULL
...: additional arguments to wbt_options()
wd: character; Default: NULL; if set the package option whitebox.wd is set specified path (if directory exists)
verbose: Default: NULL; if logical, set the package option whitebox.verbose to specified value
compress_rasters: Default: NULL; if logical, set the package option whitebox.compress_rasters to specified value
max_procs: Default: NULL; if integer, set the package option whitebox.max_procs to specified value
shell_quote: Return shQuote() result?

Details

wbt_exe_path(): Checks system environment variable R_WHITEBOX_EXE_PATH and package option whitebox.exe_path. Set your desired path with either Sys.setenv(R_WHITEBOX_EXE_PATH = "C:/path/to/whitebox_tools.exe") or options(whitebox.exe_path = "C:/path/to/whitebox_tools.exe"). The default, backwards-compatible path is returned by wbt_default_path()

wbt_wd(): Before you set the working directory in a session the default output will be in your current R working directory unless otherwise specified. You can change working directory at any time by setting the wd argument to wbt_wd() and running a tool. Note that once you have set a working directory, the directory needs to be set somewhere to "replace" the old value; just dropping the flag will not change the working directory back to the R working directory. To "unset" the option in the R package you can use wbt_wd("") which is equivalent to wbt_wd(getwd()).

Examples

Run this code

if (FALSE) {
## wbt_init():

# set path to binary as an argument
# wbt_init(exe_path = "not/a/valid/path/whitebox_tools.exe")
}
if (FALSE) {

## wbt_options():

# set multiple options (e.g. exe_path and verbose) with wbt_options()
wbt_options(exe_path = "not/a/valid/path/whitebox_tools.exe", verbose = TRUE)

}
if (FALSE) {
wbt_exe_path()
}
if (FALSE) {

## wbt_wd():

# set WBT working directory to R working directory
wbt_wd(wd = getwd())
}
if (FALSE) {

## wbt_verbose():

wbt_verbose(verbose = TRUE)
}
if (FALSE) {

## wbt_compress_rasters():

wbt_compress_rasters(compress_rasters = TRUE)
}
if (FALSE) {

## wbt_max_procs():

wbt_max_procs(max_procs = 2)
}