gdalinfo: gdalinfo

Description

R wrapper for gdalinfo

Usage

gdalinfo(datasetname, mm, stats, approx_stats, hist, nogcp, nomd, nrat, noct,
  nofl, checksum, proj4, mdd, sd, version, formats, format, optfile, config,
  debug, additional_commands, raw_output = TRUE, verbose = FALSE)

Arguments

datasetname

Character. A raster dataset name. It can be either file name.

Logical. Force computation of the actual min/max values for each band in the dataset?

stats

Logical. Read and display image statistics. Force computation if no statistics are stored in an image.

approx_stats

Logical. Read and display image statistics. Force computation if no statistics are stored in an image. However, they may be computed based on overviews or a subset of all tiles. Useful if you are in a hurry and don't want precise stats.

hist

Logical. Report histogram information for all bands.

nogcp

Logical. Suppress ground control points list printing. It may be useful for datasets with huge amount of GCPs, such as L1B AVHRR or HDF4 MODIS which contain thousands of them.

nomd

Logical. Suppress metadata printing. Some datasets may contain a lot of metadata strings.

nrat

Logical. Suppress printing of raster attribute table.

noct

Logical. Suppress printing of color table.

checksum

Logical. Force computation of the checksum for each band in the dataset.

mdd

Character. Report metadata for the specified domain.

nofl

Logical. (GDAL >= 1.9.0) Only display the first file of the file list.

Numeric. (GDAL >= 1.9.0) If the input dataset contains several subdatasets read and display a subdataset with specified number (starting from 1). This is an alternative of giving the full subdataset name.

proj4

Logical. (GDAL >= 1.9.0) Report a PROJ.4 string corresponding to the file's coordinate system.

version

Logical. Report the version of GDAL and exit.

formats

Logical. List all raster formats supported by this GDAL build (read-only and read-write) and exit. The format support is indicated as follows: 'ro' is read-only driver; 'rw' is read or write (ie. supports CreateCopy); 'rw+' is read, write and upda

format

Character. List detailed information about a single format driver. The format should be the short name reported in the --formats list, such as GTiff.

optfile

Character. Read the named file and substitute the contents into the commandline options list. Lines beginning with # will be ignored. Multi-word arguments may be kept together with double quotes.

config

Character. Sets the named configuration keyword to the given value, as opposed to setting them as environment variables. Some common configuration keywords are GDAL_CACHEMAX (memory used internally for caching in megabytes) and GDAL_DATA (path of

debug

Character. Control what debugging messages are emitted. A value of ON will enable all debug messages. A value of OFF will disable all debug messages. Another value will select only debug messages containing that string in the debug prefix code.

additional_commands

Character. Additional commands to pass directly to gdalinfo.

raw_output

Logical. Dump the raw output of the gdalinfo (default=TRUE). If not, attempt to return a clean list (not all parameters will be retained, at present).

verbose

Logical.

Value

character (if raw_output=TRUE) or list (if raw_output=FALSE).

Details

This is an R wrapper for the 'gdalinfo' 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://www.gdal.org/gdalinfo.html), or, in some cases, can use R vectors to achieve the same end.

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.

By default, this will return the gdalinfo as a character vector, one line of the output per element. The user can choose raw_output=FALSE for a cleaner format (similar to GDALinfo in the rgdal package), although not all parameters are preserved.

References

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

Examples

Run this code

src_dataset <- system.file("external/tahoe_highrez.tif", package="gdalUtils")
# Command-line gdalinfo call:
# gdalinfo tahoe_highrez.tif
gdalinfo(src_dataset)

Run the code above in your browser using DataCamp Workspace