Ouranosinc / xscen / 21871047982

90%

push

github

Obs utils (#619)

<!-- Please ensure the PR fulfills the following requirements! -->
<!-- If this is your first PR, make sure to add your details to the
AUTHORS.rst! -->
### Pull Request Checklist:
- [ ] This PR addresses an already opened issue (for bug fixes /
features)
    - This PR fixes #xyz
- [x] (If applicable) Documentation has been added / updated (for bug
fixes / features).
- [x] (If applicable) Tests have been added.
- [x] This PR does not seem to break the templates.
- [x] CHANGELOG.rst has been updated (with summary of main changes).
- [x] Link to issue (:issue:`number`) and pull request (:pull:`number`)
has been added.

### What kind of change does this PR introduce?

Adds the  following functions to `xs.spatial`

- `dataset_extent` which returns a "region" dict with the extent of a
given dataset.
- `merge_duplicated_stations` : merges stations with the same location
from a station-obs dataset
- `voronoi_weights` : For a stations dataset, return a weight that is
inversely proportional to the station density around each station. The
idea is to remove station density bias when taking means of parameters
computed over stations.
- Fast-track for `subset(..., 'gridpoint')` : When the CRS of the source
is known, we convert the requested lat/lon points to this CRS allowing
the use of xarray's `sel` instead of having to compute distances in
rotated 2D space. Only works, when none of the fancy options of
`clisops` are requested.

Also, these changes:
- Fix for scipy 1.16. This fix is different than what @juliettelavoie
did in #616. Here, I preserve the behaviour. Which do we prefer ?
- Fixes in `subset`:
+ `method='gridpoint'` : when the lon/lat is a DataArray, its dimension
name is preserved (instead of being replaced by `site`)
    + `method='shape'` : a shapely polygon is also accepted
- `get_grid_mapping` : allow a grid mapping to be in the data vars as
well
- Doc of regions : I tried to add a `Region` typevar in the aim of
having better anno... (continued)

95 of 128 new or added lines in 4 files covered. (74.22%)

4374 of 4867 relevant lines covered (89.87%)

3.59 hits per line