Openeo

Changed

- Eliminate dependency on `distutils.version.LooseVersion` which started to trigger deprecation warnings ([316](https://github.com/Open-EO/openeo-python-client/issues/316)).

Removed

- Remove old `Connection.oidc_auth_user_id_token_as_bearer` workaround flag ([300](https://github.com/Open-EO/openeo-python-client/issues/300))

Fixed

- Fix refresh token handling in case of OIDC token request with refresh token grant ([326](https://github.com/Open-EO/openeo-python-client/issues/326))

Added

- Allow passing raw JSON string, JSON file path or URL to `Connection.download()`,
`Connection.execute()` and `Connection.create_job()`
- Add support for reverse math operators on DataCube in `apply` mode ([323](https://github.com/Open-EO/openeo-python-client/issues/323))
- Add `DataCube.print_json()` to simplify exporting process graphs in Jupyter or other interactive environments ([324](https://github.com/Open-EO/openeo-python-client/issues/324))
- Raise `DimensionAlreadyExistsException` when trying to `add_dimension()` a dimension with existing name ([Open-EO/openeo-geopyspark-driver205](https://github.com/Open-EO/openeo-geopyspark-driver/issues/205))

Changed

- `DataCube.execute_batch()` now also guesses the output format from the filename,
and allows using `format` argument next to the current `out_format`
to align with the `DataCube.download()` method. ([240](https://github.com/Open-EO/openeo-python-client/issues/240))
- Better client-side handling of merged band name metadata in `DataCube.merge_cubes()`

Removed

- Remove legacy `DataCube.graph` and `DataCube.flatten()` to prevent usage patterns that cause interoperability issues
([155](https://github.com/Open-EO/openeo-python-client/issues/155), [#209](https://github.com/Open-EO/openeo-python-client/issues/209), [#324](https://github.com/Open-EO/openeo-python-client/issues/324))

Added

- Add support for passing a PGNode/VectorCube as geometry to `aggregate_spatial`, `mask_polygon`, ...
- Add support for second order callbacks e.g. `is_valid` in `count` in `reduce_dimension` ([317](https://github.com/Open-EO/openeo-python-client/issues/317))

Changed

- Rename `RESTJob` class name to less cryptic and more user-friendly `BatchJob`.
Original `RESTJob` is still available as deprecated alias.
([280](https://github.com/Open-EO/openeo-python-client/issues/280))
- Dropped default reducer ("max") from `DataCube.reduce_temporal_simple()`
- Various documentation improvements:
- general styling, landing page and structure tweaks ([285](https://github.com/Open-EO/openeo-python-client/issues/285))
- batch job docs ([286](https://github.com/Open-EO/openeo-python-client/issues/286))
- getting started docs ([308](https://github.com/Open-EO/openeo-python-client/issues/308))
- part of UDF docs ([309](https://github.com/Open-EO/openeo-python-client/issues/309))
- added process-to-method mapping docs
- Drop hardcoded `h5netcdf` engine from `XarrayIO.from_netcdf_file()`
and `XarrayIO.to_netcdf_file()` ([314](https://github.com/Open-EO/openeo-python-client/issues/314))
- Changed argument name of `Connection.describe_collection()` from `name` to `collection_id`
to be more in line with other methods/functions.

Fixed

- Fix `context`/`condition` confusion bug with `count` callback in `DataCube.reduce_dimension()` ([317](https://github.com/Open-EO/openeo-python-client/issues/317))

Added

- Add `context` parameter to `DataCube.aggregate_spatial()`, `DataCube.apply_dimension()`,
`DataCube.apply_neighborhood()`, `DataCube.apply()`, `DataCube.merge_cubes()`.
([291](https://github.com/Open-EO/openeo-python-client/issues/291))
- Add `DataCube.fit_regr_random_forest()` ([293](https://github.com/Open-EO/openeo-python-client/issues/293))
- Add `PGNode.update_arguments()`, which combined with `DataCube.result_node()` allows to do advanced process graph argument tweaking/updating without using `._pg` hacks.
- `JobResults.download_files()`: also download (by default) the job result metadata as STAC JSON file ([184](https://github.com/Open-EO/openeo-python-client/issues/184))
- OIDC handling in `Connection`: try to automatically refresh access token when expired ([298](https://github.com/Open-EO/openeo-python-client/issues/298))
- `Connection.create_job` raises exception if response does not contain a valid job_id
- Add `openeo.udf.debug.inspect` for using the openEO `inspect` process in a UDF ([302](https://github.com/Open-EO/openeo-python-client/issues/302))
- Add `openeo.util.to_bbox_dict()` to simplify building a openEO style bbox dictionary, e.g. from a list or shapely geometry ([304](https://github.com/Open-EO/openeo-python-client/issues/304))

Removed

- Removed deprecated (and non-functional) `zonal_statistics` method from old `ImageCollectionClient` API. ([144](https://github.com/Open-EO/openeo-python-client/issues/144))

Added

- Add support for comparison operators (`<`, `>`, `<=` and `>=`) in callback process building
- Added `Connection.describe_process()` to retrieve and show a single process
- Added `DataCube.flatten_dimensions()` and `DataCube.unflatten_dimension`
([Open-EO/openeo-processes308](https://github.com/Open-EO/openeo-processes/issues/308), [Open-EO/openeo-processes#316](https://github.com/Open-EO/openeo-processes/pull/316))
- Added `VectorCube.run_udf` (to avoid non-standard `process_with_node(UDF(...))` usage)
- Added `DataCube.fit_class_random_forest()` and `Connection.load_ml_model()` to train and load Machine Learning models
([279](https://github.com/Open-EO/openeo-python-client/issues/279))
- Added `DataCube.predict_random_forest()` to easily use `reduce_dimension` with a `predict_random_forest` reducer
using a `MlModel` (trained with `fit_class_random_forest`)
([279](https://github.com/Open-EO/openeo-python-client/issues/279))
- Added `DataCube.resample_cube_temporal` ([284](https://github.com/Open-EO/openeo-python-client/issues/284))
- Add `target_dimension` argument to `DataCube.aggregate_spatial` ([288](https://github.com/Open-EO/openeo-python-client/issues/288))
- Add basic configuration file system to define a default back-end URL and enable auto-authentication ([264](https://github.com/Open-EO/openeo-python-client/issues/264), [#187](https://github.com/Open-EO/openeo-python-client/issues/187))
- Add `context` argument to `DataCube.chunk_polygon()`
- Add `Connection.version_info()` to list version information about the client, the API and the back-end

Changed

- Include openEO API error id automatically in exception message to simplify user support and post-mortem analysis.
- Use `Connection.default_timeout` (when set) also on version discovery request
- Drop `ImageCollection` from `DataCube`'s class hierarchy.
This practically removes very old (pre-0.4.0) methods like `date_range_filter` and `bbox_filter` from `DataCube`.
([100](https://github.com/Open-EO/openeo-python-client/issues/100), [#278](https://github.com/Open-EO/openeo-python-client/issues/278))
- Deprecate `DataCube.send_job` in favor of `DataCube.create_job` for better consistency (internally and with other libraries) ([276](https://github.com/Open-EO/openeo-python-client/issues/276))
- Update (autogenerated) `openeo.processes` module to 1.2.0 release (2021-12-13) of openeo-processes
- Update (autogenerated) `openeo.processes` module to draft version of 2022-03-16 (e4df8648) of openeo-processes
- Update `openeo.extra.spectral_indices` to a post-0.0.6 version of [Awesome Spectral Indices](https://awesome-ee-spectral-indices.readthedocs.io/en/latest/)

Removed

- Removed deprecated `zonal_statistics` method from `DataCube`. ([144](https://github.com/Open-EO/openeo-python-client/issues/144))
- Deprecate old-style `DataCube.polygonal_mean_timeseries()`, `DataCube.polygonal_histogram_timeseries()`,
`DataCube.polygonal_median_timeseries()` and `DataCube.polygonal_standarddeviation_timeseries()`

Fixed

- Support `rename_labels` on temporal dimension ([274](https://github.com/Open-EO/openeo-python-client/issues/274))
- Basic support for mixing `DataCube` and `ProcessBuilder` objects/processing ([275](https://github.com/Open-EO/openeo-python-client/issues/275))

Added

- Add experimental support for `chunk_polygon` process ([Open-EO/openeo-processes287](https://github.com/Open-EO/openeo-processes/issues/287))
- Add support for `spatial_extent`, `temporal_extent` and `bands` to `Connection.load_result()`
- Setting the environment variable `OPENEO_BASEMAP_URL` allows to set a new templated URL to a XYZ basemap for the Vue Components library, `OPENEO_BASEMAP_ATTRIBUTION` allows to set the attribution for the basemap ([260](https://github.com/Open-EO/openeo-python-client/issues/260))
- Initial support for experimental "federation:missing" flag on partial openEO Platform user job listings ([Open-EO/openeo-api419](https://github.com/Open-EO/openeo-api/pull/419))
- Best effort detection of mistakenly using Python builtin `sum` or `all` functions in callbacks ([Forum 113](https://discuss.eodc.eu/t/reducing-masks-in-openeo/113))
- Automatically print batch job logs when job doesn't finish successfully (using `execute_batch/run_synchronous/start_and_wait`).