Hydromt

This release fixes a performance regression when reading geometry masks, relaxed warnings for empty raster datasets and updated the documentation of the new hydromt commands.

Fixed
-----
- Added back geometry mask when reading vector files with `fiona` as engine/ driver. (777)
- Relaxed empty data checking on `RasterDatasetAdapter`. (782)
- Add documentation for `hydromt check` and `hydromt export` commands. (767)

===================
This release fixes several bugs. Most notably the `NoDataSrategy` is available in much more data reading methods so plugins can use it more directly. Additionally there are some bug fixes relating to reading shapefiles and reading COGs.

Added
-----
- Test script for testing predefined catalogs locally. (735)
- Option to write a data catalog to a csv file (425)

Fixed
-----
- Reading Vector formats that consist of more than one file via geopandas. (691)
- Handle NoDataStrategy consistently when reading data in adapters (738)
- add option to ignore empty data sets when exporting data (743)
- Fix bug in `raster._check_dimensions` for datasets with multiple variables with varying dimension size (761)
- Fix bug when reading COGs at requested zoom level (758)

===================
This release adds additional bug fixes for the meridian offset functinality, and improvements to the new CLI commands.

Added
-----
- Export CLI now also accepts time tuples (660)
- New stats.skills VE and RSR (666)
- Check CLI command can now validate bbox and geom regions (664)

Changed
-------
- Export CLI now uses '-s' for source, '-t' for time and '-i' for config. (660)

Fixed
-----
- Double reading of model components when in appending mode. (695)
- Removed deprecated entrypoints library. (676)
- Bug in `raster.set_crs` if input_crs is of type CRS. (659)
- Export CLI now actually parses provided geoms. (660)
- Bug in stats.skills for computation of pbias and MSE / RMSE. (666)
- `Model.write_geoms` ow has an option to write GeoJSON coordinates in WGS84 if specified (510)
- Fix bug with lazy spatial_ref coordinate (682)
- Bug in gis_utils.meridian_offset. (692)

* Pyogrio io by Jaapel in https://github.com/Deltares/hydromt/pull/583
* fix some docs issues by savente93 in https://github.com/Deltares/hydromt/pull/619
* To stac by savente93 in https://github.com/Deltares/hydromt/pull/617
* Implement from stac for data catalog by savente93 in https://github.com/Deltares/hydromt/pull/625
* Transform boundary fix by Tjalling-dejong in https://github.com/Deltares/hydromt/pull/629
* Implement export data via cli by savente93 in https://github.com/Deltares/hydromt/pull/627
* Add more diagrams to the documentation for users. by savente93 in https://github.com/Deltares/hydromt/pull/631
* Add Pixi as a task runner by savente93 in https://github.com/Deltares/hydromt/pull/634
* Add validation methods for data catalog by savente93 in https://github.com/Deltares/hydromt/pull/632
* fix zoom level bugs by DirkEilander in https://github.com/Deltares/hydromt/pull/642
* Model config validation by savente93 in https://github.com/Deltares/hydromt/pull/643
* Fix meridian offset by DirkEilander in https://github.com/Deltares/hydromt/pull/649

This release contains several new features, here we highlight a few:
- Support in the DataCatalog for data sources from different providers or versions with better support for cloud and http data.
- Developers documentation to start your own plugin and accompanying template.
- Support multigrids in meshmodel (with example) and improved implementation VectorModel (was LumpedModel)
- Support for reading overviews (zoom levels) of Cloud Optimized GeoTIFFs (COGs).

Added
-----

Documentation
- docs now include a dropdown for selecting older versions of the docs. (PR 457)
- docs include a new example for MeshModel. (PR 595)
- Added documentation for how to start your own plugin (PR 446)

Data
- Support for loading the same data source but from different providers (e.g., local & aws) and versions (PR 438)
- Add support for reading and writing tabular data in ``parquet`` format. (PR 445)
- Add support for reading model configs in ``TOML`` format. (PR 444)
- add ``open_mfcsv`` function in ``io`` module for combining multiple CSV files into one dataset. (PR 486)
- Adapters can now clip data that is passed through a python object the same way as through the data catalog. (PR 481)
- Relevant data adapters now have functionality for reporting and detecting the spatial and temporal extent they cover (PR 503)
- Data catalogs have a ``hydromt_version`` meta key that is used to determine compatibility between the catalog and the installed hydromt version. (PR 506)
- Allow the root of a data catalog to point to an archive, this will be extracted to the ~/.hydromt_data folder. (PR 512)
- Support for reading overviews from (Cloud Optimized) GeoTIFFs using the zoom_level argument of ``DataCatalog.get_rasterdataset``. (PR 514)
- Support for http and other *filesystems* in path of data source (PR 515).

Model
- new ``force-overwrite`` option in ``hydromt update`` CLI to force overwritting updated netcdf files. (PR 460)
- Model objects now have a _MODEL_VERSION attribute that plugins can use for compatibility purposes (PR 495)
- ``set_forcing`` can now add pandas.DataFrame object to forcing. (PR 534)

Raster
- Model class now has methods for getting, setting, reading and writing arbitrary tabular data. (PR 502)
- Support for writing overviews to (Cloud Optimized) GeoTIFFs in the ``raster.to_raster`` method. (PR 514)
- New raster method ``to_slippy_tiles``: tiling of a raster dataset according to the slippy tile structure for e.g., webviewers (PR 440).

Changed
-------

Model
- Updated ``MeshModel`` and related methods to support multigrids instead of one single 2D grid. (PR 412)
- Renamed ``LumpedModel.response_units`` to ``VectorModel.vector`` and updated the base set, read, write methods. (531)
- possibility to ``load`` the data in the model read_ functions for netcdf files (default for read_grid in r+ mode). (PR 460)
- Internal model components (e.g. `Models._maps`, `GridModel._grid``) are now initialized with None and should not be accessed directly,
call the corresponding model property (e.g. `Model.maps`, `GridModel.grid`) instead. (PR 473)
- ``setup_mesh2d_from_rasterdataset`` and ``setup_mesh2d_from_raster_reclass`` now use xugrid Regridder methods. (PR 535)
- Use the Model.data_catalog to read the model region if defined by a geom or grid. (PR 479)

Vector
- ``vector.GeoDataset.from_gdf`` can use the gdf columns as data_vars instead of external xarray. (PR 412)

Fixed
-----
- when a model component (eg maps, forcing, grid) is updated using the set_ methods, it will first be read to avoid loosing data. (PR 460)
- open_geodataset with driver vector also works for other geometry type than points. (PR 509)
- overwrite model in update mode. (PR 534)
- fix stats.extremes methods for (dask) 3D arrays. (PR 505)
- raster gives better error on incompatible nodata (PR 544)

Deprecated
----------
- the dependencies ``pcraster`` and ``pygeos`` are no longer used and were removed. (PR 467)

This release contains several new features, including extreme value analysis, new generic methods for the ``GridModel`` class, setting variable attributes like units through the data catalog, and the ability to detect compatibility issues between Datacatalog and HydroMT versions. It also includes a minor breaking change since now geometry masks are only set if the `mask` in `raster.clip_geom` is set to `True` to improve memory usage.

What's Changed
Added
-----
- Support for unit attributes for all data types in the DataCatalog. PR 334
- Data catalog can now handle specification of HydroMT version
- New generic methods for ``GridModel``: ``setup_grid``, ``setup_grid_from_constant``, ``setup_grid_from_rasterdataset``, ``setup_grid_from_raster_reclass``, ``setup_grid_from_geodataframe``. PR 333
- New ``grid`` workflow methods to support the setup methods in ``GridModel``: ``grid_from_constant``, ``grid_from_rasterdataset``, ``grid_from_raster_reclass``, ``grid_from_geodataframe``.
PR 333
- New raster method ``rasterize_geometry``.
- New extreme valua analysis and design event (creation hydrographs) methods in stats submodule.
Note that these methods are experimental and may be moved elsewhere / change in signature. PR 85

Changed
-------
- Arguments to drivers in data catalog files and the `DataCatalog.get_` methods should now explicitly be called driver_kwargs instead of kwargs. PR 334
- New geom_type argument in `RasterDataArray.vector_grid` to specify the geometry type {'polygon', 'line', 'points'} of the vector grid. PR 351
- Added extrapolate option to `raster.interpolate_na` method. PR 348
- Name of methods ``setup_maps_from_raster`` and ``setup_mesh_from_raster`` to ``setup_maps_from_rasterdataset`` and ``setup_mesh_from_rasterdataset``. PR 333
- Add rename argument to ``setup_*_from_rasterdataset``, ``setup_*_from_raster_reclass`` to maps and mesh for consistency with grid. PR 333
- Introduced different merge options in `GeoDataset.from_gdf` and `GeoDataFrame.from_gdf`. PR 441
- ``DataCatalog.get_rasterdataset`` always uses bbox to clip raster data. PR 434
- ``raster.clip_geom`` only set a geometry mask if the mask argument is true to avoid memory issues. PR 434
- ``raster.clip_mask`` interface and behavior changed to be consistent with ``raster.clip_geom``. PR 318

Fixed
-----
- Order of renaming variables in ``DataCatalog.get_rasterdataset`` for x,y dimensions. PR 324
- fix bug in ``get_basin_geometry`` for region kind 'subbasin' if no stream or outlet option is specified.
- fix use of Path objects in ``DataCatalog.from_dict``. PR 429
- ``raster.reproject_like`` first clips the data to the target extent before reprojecting. PR 434