get_subdatasets: get_subdatasets

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

Description

Returns HDF4, HDF5, and NetCDF subdataset names for standardized files.

Usage

get_subdatasets(
  datasetname,
  names_only = TRUE,
  normalizePath = FALSE,
  verbose = FALSE
)

Arguments

datasetname	Character. Input HDF4/5 or NetCDF file.
names_only	Logical. Return subdataset names only? Default=TRUE.
normalizePath	Logical. Normalize the file path? Default=FALSE.
verbose	Logical. Enable verbose execution? Default is FALSE.

Details

Currently, this only returns the subdataset names of HDF4, HDF5, and NetCDF files, assuming they follow the SUBDATASET_n_NAME convention. This can be used with gdal_translate to extract a single subdataset (or with gdal_translate(...,sd_index=n)

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 vector of subdataset names that can be used in gdal_translate.

Author(s)

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

References

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

Examples

## Not run:  
hdf4_dataset <- system.file("external/test_modis.hdf", package="gdalUtils")
get_subdatasets(hdf4_dataset)

## End(Not run)

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