Options and environment variables
are available to manage {qgisprocess}
behaviour. Several
options have a corresponding environment variable. When both have a
value, the option will be given priority.
Options are typically harder to isolate from the R code that you collaborate on. Consequently, it is advised to:
options()
where this affects behaviour that must be
the same across users and machines for reproducibility. Put these inside
your script, or at least in a .Rprofile
file that is shared
together with the other project files..Renviron
file in your
working directory and ignore it in distributed version control. Or you
can set the environment variable at a higher level, e.g. in a
.Renviron
file in your home directory. See
base::Startup
for more information.Below table lists the available options and environment variables.
Option | Environment variable | Type |
---|---|---|
qgisprocess.path |
R_QGISPROCESS_PATH |
string (filepath) |
qgisprocess.tmp_vector_ext |
not available | string (file extension) |
qgisprocess.tmp_raster_ext |
not available | string (file extension) |
qgisprocess.detect_newer_qgis |
R_QGISPROCESS_DETECT_NEWER_QGIS |
logical |
qgisprocess.use_json_input |
R_QGISPROCESS_USE_JSON_INPUT |
logical |
qgisprocess.use_json_output |
R_QGISPROCESS_USE_JSON_OUTPUT |
logical |
qgisprocess.cachefiles_days_keep |
R_QGISPROCESS_CACHEFILES_DAYS_KEEP |
numeric |
qgisprocess.use_cached_help |
R_QGISPROCESS_USE_CACHED_HELP |
logical |
qgisprocess.env |
not available | named list |
Following descriptions are applicable to both option and environment variable:
qgisprocess.path
: sets the path to ‘qgis_process’; see
qgis_configure()
qgisprocess.tmp_vector_ext
: sets the vector file
extension for temporary files; see qgis_tmp_vector()
qgisprocess.tmp_raster_ext
: sets the raster file
extension for temporary files; see qgis_tmp_raster()
qgisprocess.detect_newer_qgis
: for Windows and macOS;
will report availability of an installed (standalone) QGIS version that
is more recent than the cached versionqgisprocess.use_json_input
: control whether the JSON
input method is used; see qgis_using_json_input()
qgisprocess.use_json_output
: control whether the JSON
output method is used; see qgis_using_json_output()
qgisprocess.cachefiles_days_keep
: control a cache
file’s age (as days) that must be exceeded for it to be deleted when
loading the package (default is 90); see
?qgis_delete_old_cachefiles
qgisprocess.use_cached_help
: whether to fetch an
algorithm’s documentation from a cached file (corresponding to the QGIS
and {qgisprocess}
versions in use) if this file exists
(default is TRUE
; if FALSE
, always (re)query
documentation from QGIS)qgisprocess.env
: named list of environment variable
values used in each call to ‘qgis_process’; see
qgis_run()