Deepsensor

What's Changed
* Support non-Gaussian `ConvNP` likelihoods in low-level and high-level prediction interfaces by tom-andersson in https://github.com/alan-turing-institute/deepsensor/pull/97
* [Fix multiple N-D target sets case in ConvNP; Update ConvNP API](https://github.com/alan-turing-institute/deepsensor/commit/4241544c6ca7f03928693c821cdc77847d90028f)
* Minor suggestions to installation docs. by davidwilby in https://github.com/alan-turing-institute/deepsensor/pull/98

New Contributors
* davidwilby made their first contribution in https://github.com/alan-turing-institute/deepsensor/pull/98

**Full Changelog**: https://github.com/alan-turing-institute/deepsensor/compare/v0.3.5...v0.3.6

What's changed
* Fix bug in batchwise `Trainer` training with multi-dimensional context sets (https://github.com/tom-andersson/deepsensor/issues/93; thanks nilsleh)

**Full Changelog**: https://github.com/tom-andersson/deepsensor/compare/v0.3.4...v0.3.5

* Fix PyPI upload by removing `get-station-data` dependency; instead raise error that it must be installed manually if user calls the function that uses it

**Full Changelog**: https://github.com/tom-andersson/deepsensor/compare/v0.3.3...v0.3.4

What's Changed
* New documentation by tom-andersson and kallewesterling, containing steps for getting started, a user guide, learning resources, a list of research ideas, community information, and more. Uses the Jupyter Book system with fully reproducible notebooks demoing features of the package.
* New `deepsensor.data.sources` module for downloading ERA5, GHCNd, topography, and land mask data directly into DeepSensor xarray/pandas format. Results can be cached to disk to avoid re-downloading. Leverages [`get-station-data`](https://github.com/scotthosking/get-station-data) tool by scotthosking, magnusross, and tom-andersson.
* New plotting tools: `deepsensor.plot.prediction` and `deepsensor.plot.task`.
* Various bug fixes.

Breaking changes
* The `ConvNP` hyperparameter `points_per_unit` has been renamed to `internal_density` to be more intuitive. Instances of `points_per_unit` in code and model JSON configuration files will need to be renamed to `internal_density`.

New Contributors
* scotthosking made their first contribution in https://github.com/tom-andersson/deepsensor/pull/86

**Full Changelog**: https://github.com/tom-andersson/deepsensor/compare/v0.3.2...v0.3.3

* Fix bug in `ContextDist` acquisition function (thanks acocac)

What's Changed
* New `Prediction` object output by `model.predict`, containing xarray or pandas data (https://github.com/tom-andersson/deepsensor/issues/53)
* New `TaskLoader` functionality for generating satellite gap-filling training tasks (https://github.com/tom-andersson/deepsensor/issues/23, [example](https://github.com/tom-andersson/deepsensor/issues/23#issuecomment-1767041826))
* `DataProcessor` scales each spatial dimension equally to fix stripe artefacts, and raises a warning if user-provided coord mappings don't do this (https://github.com/tom-andersson/deepsensor/issues/77)
* `Task` operations now work like `task.operation_method()` and are tracked in the `task["ops"]` list
* `TaskLoader` does not sample target data for the `Task` if `target_sampling` isn't provided (supports context-only `Task`s for inference with `model.predict`)
* Support spatiotemporal `aux_at_targets` xarray data (with a time dim), not spatial-only
* Fix `model.predict` not permitting numerical noise in `X_t` coordinates (https://github.com/tom-andersson/deepsensor/issues/78)
* Key classes are now exposed from higher import levels (https://github.com/tom-andersson/deepsensor/commit/de876d46cf0b59602b125f4c47471b27949022bb)
* Add [`CONTRIBUTING.md`](https://github.com/tom-andersson/deepsensor/blob/main/CONTRIBUTING.md) and [`CODE_OF_CONDUCT.md`](https://github.com/tom-andersson/deepsensor/blob/main/CODE_OF_CONDUCT.md) by kallewesterling
* [Issue templates](https://github.com/tom-andersson/deepsensor/issues/new/choose) by kallewesterling
* Google docstrings added to the majority of the package by kallewesterling
* [DeepSensor Slack channel request form](https://docs.google.com/forms/d/e/1FAIpQLScsI8EiXDdSfn1huMp1vj5JAxi9NIeYLljbEUlMceZvwVpugw/viewform)
* Preliminary `sphinx` [readthedocs page](https://tom-andersson.github.io/deepsensor/) by kallewesterling

Breaking changes
* Replace any `mean_ds, pred_ds, samples_ds = model.predict(...)` with `pred = model.predict(...)`. Prediction pandas/xarray objects can now be accessed with `pred["<var_ID>"]`.
* Replace any `remove_nans_from_task_Y_t_if_present(task)` with `task.remove_target_nans()`
* `DataProcessor` now auto-normalises coordinates differently to preserve aspect ratio - see https://github.com/tom-andersson/deepsensor/issues/77. If you aren't specifying spatial coordinate normalisation mapping explicitly (through `x1_map`/`x2_map` or through config), your trained models may start receiving different data.

**Full Changelog**: https://github.com/tom-andersson/deepsensor/compare/v0.2.5...v0.3.0