get_subdatasets

Description

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

Usage

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

Arguments

datasetname

Character. Input HDF4/5 or NetCDF file.

names_only

Logical. Return subdataset names only? Default=TRUE.

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 (gdalUtils@estarcion.net) and Matteo Mattiuzzi (wrapper) and Frank Warmerdam (GDAL lead developer).

References

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

Examples

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

## End(Not run)