read_output

list, a `options` object that was created by the `create_tool`
function that contains the parameters for a particular tool and its
outputs.

output

character, either "raster" or "terra"

backend

logical, whether to load the output as an R object

.intern

Primary function to read data sets (raster, vector, tabular) that are output
by saga_cmd

internal

Provides an R scripting interface to the open-source 'SAGA-GIS'
(System for Automated Geoscientific Analyses Geographical Information
System) software. 'Rsagacmd' dynamically generates R functions for every
'SAGA-GIS' geoprocessing tool based on the user's currently installed
'SAGA-GIS' version. These functions are contained within an S3 object
and are accessed as a named list of libraries and tools. This structure
facilitates an easier scripting experience by organizing the large number
of 'SAGA-GIS' geoprocessing tools (>700) by their respective library.
Interactive scripting can fully take advantage of code autocompletion tools
(e.g. in 'Rstudio'), allowing for each tools syntax to be quickly
recognized. Furthermore, the most common types of spatial data (via the
'raster', 'terra', 'sp', and 'sf' packages) along with non-spatial data are
automatically passed from R to the 'SAGA-GIS' command line tool for
geoprocessing operations, and the results are loaded as the appropriate R
object. Outputs from individual 'SAGA-GIS' tools can also be chained using
pipes from the 'magrittr' and 'dplyr' packages to combine complex
geoprocessing operations together in a single statement. 'SAGA-GIS' is
available under a GPLv2 / LGPLv2 licence from
<https://sourceforge.net/projects/saga-gis/> including Windows x86/x64
binaries. SAGA-GIS is also included in Debian/Ubuntu default software
repositories and is available for macOS using homebrew (<https://brew.sh/>)
from the osgeo/osgeo4mac (<https://github.com/OSGeo/homebrew-osgeo4mac>)
formula tap, as well as being bundled within the 'QGIS' application bundle
for macOS. Rsagacmd has currently been tested on 'SAGA-GIS' versions
from 2.3.1 to 8.0.1 on Windows, Linux and macOS.

read_output: Primary function to read data sets (raster, vector, tabular) that are output by saga_cmd

Description

Usage

Arguments

Value