inspectDataset: Obtain information about a GDAL raster or vector dataset
| inspectDataset | R Documentation |
Obtain information about a GDAL raster or vector dataset
Description
inspectDataset() returns information about the format and content
of a dataset. The function first calls identifyDriver(), and then opens
the dataset as raster and/or vector to obtain information about its content.
The return value is a list with named elements.
Usage
inspectDataset(filename, ...)
Arguments
filename |
Character string containing the name of the file to access. This may not refer to a physical file, but instead contain information for the driver on how to access a dataset (e.g., connection string, URL, etc.) |
... |
Additional arguments passed to |
Value
A list with the following named elements:
-
$format: character string, the format short name -
$supports_raster: logical,TRUEif the format supports raster data -
$contains_raster: logical,TRUEif this is a raster dataset or the source contains raster subdatasets -
$supports_subdatasets: logical,TRUEif the format supports raster subdatasets -
$contains_subdatasets: logical,TRUEif the source contains subdatasets -
$subdataset_names: character vector containing the subdataset names, or empty vector if subdatasets are not supported or not present -
$supports_vector: logical,TRUEif the format supports vector data -
$contains_vector: logical,TRUEif the source contains one or more vector layers -
$layer_names: character vector containing the vector layer names, or empty vector if the format does not support vector or the source does not contain any vector layers
Note
Subdataset names are the character strings that can be used to
instantiate GDALRaster objects.
See https://gdal.org/en/stable/en/latest/user/raster_data_model.html#subdatasets-domain.
See Also
gdal_formats(), identifyDriver()
Examples
src <- system.file("extdata/ynp_fires_1984_2022.gpkg", package="gdalraster")
inspectDataset(src)
