gdalUtils (version 2.0.3.2)

get_subdatasets: get_subdatasets

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.

Value

character vector of subdataset names that can be used in gdal_translate.

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.

References

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

Examples

# NOT RUN {
hdf4_dataset <- system.file("external/test_modis.hdf", package="gdalUtils")
get_subdatasets(hdf4_dataset)
# }