Openeo

Added

- Jupyter integration: show process graph visualization of `DataCube` objects instead of generic `repr`. ([336](https://github.com/Open-EO/openeo-python-client/issues/336))
- Add `Connection.vectorcube_from_paths()` to load a vector cube
from files (on back-end) or URLs with `load_uploaded_files` process.
- Python 3.10 and 3.11 are now officially supported
(test run now also for 3.10 and 3.11 in GitHub Actions, [346](https://github.com/Open-EO/openeo-python-client/issues/346))
- Support for simplified OIDC device code flow, ([335](https://github.com/Open-EO/openeo-python-client/issues/335))
- Added MultiBackendJobManager, based on implementation from openeo-classification project
([361](https://github.com/Open-EO/openeo-python-client/issues/361))
- Added resilience to MultiBackendJobManager for backend failures ([365](https://github.com/Open-EO/openeo-python-client/issues/365))

Changed

- `execute_batch` also skips temporal `502 Bad Gateway errors`. [352](https://github.com/Open-EO/openeo-python-client/issues/352)

Fixed

- Fixed/improved math operator/process support for `DataCube`s in "apply" mode (non-"band math"),
allowing expressions like `10 * cube.log10()` and `~(cube == 0)`
([123](https://github.com/Open-EO/openeo-python-client/issues/123))
- Support `PrivateJsonFile` permissions properly on Windows, using oschmod library.
([198](https://github.com/Open-EO/openeo-python-client/issues/198))
- Fixed some broken unit tests on Windows related to path (separator) handling.
([350](https://github.com/Open-EO/openeo-python-client/issues/350))

Added

- Add `max_cloud_cover` argument to `load_collection()` to simplify setting maximum cloud cover (property `eo:cloud_cover`) ([328](https://github.com/Open-EO/openeo-python-client/issues/328))

Changed
- Improve default dimension metadata of a datacube created with `openeo.rest.datacube.DataCube.load_disk_collection`
- `DataCube.download()`: only automatically add `save_result` node when there is none yet.
- Deprecation warnings: make sure they are shown by default and can be hidden when necessary.
- Rework and improve `openeo.UDF` helper class for UDF usage
([312](https://github.com/Open-EO/openeo-python-client/issues/312)).
- allow loading directly from local file or URL
- autodetect `runtime` from file/URL suffix or source code
- hide implementation details around `data` argument (e.g.`data={"from_parameter": "x"}`)
- old usage patterns of `openeo.UDF` and `DataCube.apply_dimension()` still work but trigger deprecation warnings
- Show warning when using `load_collection` property filters that are not defined in the collection metadata (summaries).

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))