gdalmanage: gdalmanage

In gearslaboratory/gdalUtils: Wrappers for the Geospatial Data Abstraction Library (GDAL) Utilities

Description

R wrapper for gdalmanage: Identify, delete, rename and copy raster data files

Usage

gdalmanage(
  mode,
  datasetname,
  newdatasetname,
  r,
  u,
  f,
  ignore.full_scan = TRUE,
  verbose = FALSE
)

Arguments

mode	Character. Mode of operation. "identify" | "copy" | "rename" | "delete". See details.
datasetname	Character. Raster file to operate on.
newdatasetname	Character. For copy and rename modes, you provide a source filename and a target filename, just like copy and move commands in an operating system.
r	Logical. Recursively scan files/folders for raster files.
u	Logical. Report failures if file type is unidentified.
f	Character. format. Specify format of raster file if unknown by the application. Uses short data format name (e.g. GTiff).
ignore.full_scan	Logical. If FALSE, perform a brute-force scan if other installs are not found. Default is TRUE.
verbose	Logical. Enable verbose execution? Default is FALSE.

Details

This is an R wrapper for the 'gdalmanage' function that is part of the Geospatial Data Abstraction Library (GDAL). It follows the parameter naming conventions of the original function, with some modifications to allow for more R-like parameters. For all parameters, the user can use a single character string following, precisely, the gdalinfo format (http://gdal.org/gdalmanage.html), or, in some cases, can use R vectors to achieve the same end.

Mode of operation

• mode="identify",datasetname: List data format of file.

• mode="copy",datasetname,newdatasetname: Create a copy of the raster file with a new name.

• mode="rename",datasetname,newdatasetname: Change the name of the raster file.

• mode="delete",datasetname: Delete raster file.

This function assumes the user has a working GDAL on their system. If the "gdalUtils_gdalPath" option has been set (usually by gdal_setInstallation), the GDAL found in that path will be used. If nothing is found, gdal_setInstallation will be executed to attempt to find a working GDAL.

Value

Character.

Author(s)

Jonathan A. Greenberg ([e-mail]) (wrapper) and Frank Warmerdam (GDAL lead developer).

References

http://www.gdal.org/gdalmanage.html

Examples

gdal_setInstallation()
valid_install <- !is.null(getOption("gdalUtils_gdalPath"))
if(valid_install)
{
	# Using identify mode
	# Report the data format of the raster file by using the identify mode 
 # and specifying a data file name:
	src_dataset <- system.file("external/tahoe_highrez.tif", package="gdalUtils")
	gdalmanage(mode="identify",datasetname=src_dataset)
	
	# Recursive mode will scan subfolders and report the data format:	
	src_dir <- system.file("external/", package="gdalUtils")
	gdalmanage(mode="identify",datasetname=src_dir,r=TRUE)
	
## Not run: 
		# Using copy mode	
		# Copy the raster data:
		file_copy <- tempfile(fileext=".tif")
		gdalmanage(mode="copy",src_dataset,file_copy)	
		file.exists(file_copy)
		
		# Using rename mode
		# Rename the raster data:
		new_name <- tempfile(fileext=".tif")
		gdalmanage(mode="rename",file_copy,new_name)	
		file.exists(new_name)
		
		# Using delete mode
		# Delete the raster data:
		gdalmanage(mode="delete",new_name)	
		file.exists(new_name)		

## End(Not run)
}

gearslaboratory/gdalUtils documentation built on Feb. 17, 2020, 8:09 a.m.