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

Description Usage Arguments Details Value Author(s) References Examples

R wrapper for gdalinfo

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

`datasetname`	Character. A raster dataset name. It can be either file name.
`json`	Logical. Display the output in json format.
`mm`	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.
`nofl`	Logical. (GDAL >= 1.9.0) Only display the first file of the file list.
`checksum`	Logical. Force computation of the checksum for each band in the dataset.
`proj4`	Logical. (GDAL >= 1.9.0) Report a PROJ.4 string corresponding to the file's coordinate system.
`oo`	Character. (starting with GDAL 2.0) NAME=VALUE. Dataset open option (format specific).
`mdd`	Character. Report metadata for the specified domain.
`sd`	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.
`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 update (ie. supports Create). A 'v' is appended for formats supporting virtual IO (/vsimem, /vsigzip, /vsizip, etc). A 's' is appended for formats supporting subdatasets. Note: The valid formats for the output of gdalwarp are formats that support the Create() method (marked as rw+), not just the CreateCopy() method.
`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 the GDAL "data" directory). Individual drivers may be influenced by other configuration options.
`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.
`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).
`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.

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.

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

Jonathan A. Greenberg (gdalUtils@estarcion.net) and Matteo Mattiuzzi (wrapper) and Frank Warmerdam (GDAL lead developer).

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

# We'll pre-check to make sure there is a valid GDAL install.
# Note this isn't strictly neccessary, as executing the function will
# force a search for a valid GDAL install.
gdal_setInstallation()
valid_install <- !is.null(getOption("gdalUtils_gdalPath"))
if(valid_install)
{
src_dataset <- system.file("external/tahoe_highrez.tif", package="gdalUtils")
# Command-line gdalinfo call:
# gdalinfo tahoe_highrez.tif
gdalinfo(src_dataset,verbose=TRUE)
}