hydromt.data_adapter.GeoDatasetAdapter#

class hydromt.data_adapter.GeoDatasetAdapter(path, driver=None, filesystem='local', crs=None, nodata=None, rename={}, unit_mult={}, unit_add={}, meta={}, **kwargs)[source]#

Initiates data adapter for geospatial timeseries data.

This object contains all properties required to read supported files into a single unified GeoDataset, i.e. xarray.Dataset with geospatial point geometries. In addition it keeps meta data to be able to reproduce which data is used.

Parameters:

path (str, Path) – Path to data source. If the dataset consists of multiple files, the path may contain {variable}, {year}, {month} placeholders as well as path search pattern using a ‘*’ wildcard.
driver ({'vector', 'netcdf', 'zarr'}, optional) – Driver to read files with, for ‘vector’ open_geodataset(), for ‘netcdf’ xarray.open_mfdataset(). By default the driver is inferred from the file extension and falls back to ‘vector’ if unknown.
filesystem ({'local', 'gcs', 's3'}, optional) – Filesystem where the data is stored (local, cloud, http etc.). By default, local.
crs (int, dict, or str, optional) – Coordinate Reference System. Accepts EPSG codes (int or str); proj (str or dict) or wkt (str). Only used if the data has no native CRS.
nodata (float, int, optional) – Missing value number. Only used if the data has no native missing value. Nodata values can be differentiated between variables using a dictionary.
rename (dict, optional) – Mapping of native data source variable to output source variable name as required by hydroMT.
unit_mult (dict, optional) – Scaling multiplication and addition to change to map from the native data unit to the output data unit as required by hydroMT.
unit_add (dict, optional) – Scaling multiplication and addition to change to map from the native data unit to the output data unit as required by hydroMT.
meta (dict, optional) – Metadata information of dataset, prefably containing the following keys: {‘source_version’, ‘source_url’, ‘source_license’, ‘paper_ref’, ‘paper_doi’, ‘category’}
placeholders (dict, optional) – Placeholders to expand yaml entry to multiple entries (name and path) based on placeholder values
**kwargs – Additional key-word arguments passed to the driver.

__init__(path, driver=None, filesystem='local', crs=None, nodata=None, rename={}, unit_mult={}, unit_add={}, meta={}, **kwargs)[source]#

Initiates data adapter for geospatial timeseries data.

Parameters:

path (str, Path) – Path to data source. If the dataset consists of multiple files, the path may contain {variable}, {year}, {month} placeholders as well as path search pattern using a ‘*’ wildcard.
driver ({'vector', 'netcdf', 'zarr'}, optional) – Driver to read files with, for ‘vector’ open_geodataset(), for ‘netcdf’ xarray.open_mfdataset(). By default the driver is inferred from the file extension and falls back to ‘vector’ if unknown.
filesystem ({'local', 'gcs', 's3'}, optional) – Filesystem where the data is stored (local, cloud, http etc.). By default, local.
crs (int, dict, or str, optional) – Coordinate Reference System. Accepts EPSG codes (int or str); proj (str or dict) or wkt (str). Only used if the data has no native CRS.
nodata (float, int, optional) – Missing value number. Only used if the data has no native missing value. Nodata values can be differentiated between variables using a dictionary.
rename (dict, optional) – Mapping of native data source variable to output source variable name as required by hydroMT.
unit_mult (dict, optional) – Scaling multiplication and addition to change to map from the native data unit to the output data unit as required by hydroMT.
unit_add (dict, optional) – Scaling multiplication and addition to change to map from the native data unit to the output data unit as required by hydroMT.
meta (dict, optional) – Metadata information of dataset, prefably containing the following keys: {‘source_version’, ‘source_url’, ‘source_license’, ‘paper_ref’, ‘paper_doi’, ‘category’}
placeholders (dict, optional) – Placeholders to expand yaml entry to multiple entries (name and path) based on placeholder values
**kwargs – Additional key-word arguments passed to the driver.

Methods

`__init__`(path[, driver, filesystem, crs, ...])	Initiates data adapter for geospatial timeseries data.
`get_data`([bbox, geom, buffer, variables, ...])	Returns a clipped, sliced and unified GeoDataset based on the properties of this GeoDatasetAdapter.
`get_filesystem`(**kwargs)	Return an initialised filesystem object based on self.filesystem and **kwargs
`resolve_paths`([time_tuple, variables, ...])	Resolve {year}, {month} and {variable} keywords in self.path based on 'time_tuple' and 'variables' arguments
`summary`()	Returns a dictionary summary of the data adapter.
`to_dict`()	Returns a dictionary view of the data source.
`to_file`(data_root, data_name[, bbox, ...])	Save a data slice to file.

Attributes

data_type