Description Usage Arguments Details Value Author(s) References Examples
View source: R/gdal_setInstallation.R
Sets local GDAL installation options
1 2 3 4 5 6
gdal_setInstallation( search_path = NULL, rescan = FALSE, ignore.full_scan = TRUE, verbose = FALSE )
Character. Force a search in a specified directory. This directory should contain the gdalinfo(.exe) executable. If a valid GDAL install is found in this path, this will force gdalUtils to use this installation. Remember to set rescan=TRUE if you have already set an install.
Logical. Force a rescan if neccessary (e.g. if you updated your GDAL install).
Logical. If FALSE, perform a brute-force scan if other installs are not found. Default is TRUE.
Logical. Enable verbose execution? Default is FALSE.
This function searches the local system for valid installations of GDAL, and returns a list, one item per valid GDAL install, containing the path to the installation, the version, the release date, available drivers, and available python utilities. The list will be sorted by release date, so in general the first entry is the one that is used by the various GDAL utilities. Note that this will automatically run every time a GDAL wrapper function is called, so the user does not have to explicitly run it.
gdal_setInstallation is designed to invoke consecutively more rigorous searches in able to find a valid GDAL install. Understanding the search routine may help debug problems on your system. The order of the searches is as follows, noting that as soon as a valid install is found (determined by running gdalinfo –version and getting the correct output), gdal_setInstallation stops further searching:
Checks a pre-determined location given by the search_path parameter.
Checks using Sys.which(). This is typically defined in the system's PATH, so will override any other install.
Checks in common install locations (OS specific).
(optional, if ignore.full_scan=FALSE) Finally, if it can't find a valid GDAL install anywhere else, it will brute-force search the entire local system (which may take a long time).
Sets an option "gdalUtils_gdalPath" with GDAL installation information.
Jonathan A. Greenberg (gdalUtils@estarcion.net) and Matteo Mattiuzzi
1 2 3 4 5 6 7 8 9 10 11 12
## Not run: # Assumes you have GDAL installed on your local machine. getOption("gdalUtils_gdalPath") gdal_setInstallation() getOption("gdalUtils_gdalPath") # If there is more than one installation of GDAL, this is the # most recent installation: getOption("gdalUtils_gdalPath")[] # The version number: getOption("gdalUtils_gdalPath")[]$version ## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.