What's Changed
This new 2022 release will provide the users a nice overview of the mapped SAR Sentinel-1 product into `xarray-datatree` to support groups/nodes of variables.
The original `xarray.Dataset` containing the high resolution variables is still available for users but extra `xarray.Dataset` from .xml annotations are now provided to the users. These annotations are :
- Doppler estimates,
- bursts information,
- image information,
- low resolution geo-location,
- FM rate information,
- ...etc...
Rationales
The main motivations for this release are:
- making `xsar` outputs more self discoverable
- starting to separate as much as possible the decoding of the SAR product and the "interpretation layer" (i.e. interpolation, calibration denoising). In particular this release will enable expert SAR users to perform their own operations on the data using directly the annotations.
- keeping the traceability of each variable in `xsar` using:
- the attributes `origin` (xpath),
- the .xsd files to have official ESA definition of variables
- keeping the exact same names for the variables
Disclaimer
For now the datatree v0.0.9 is not supporting the [double mutability](https://gist.github.com/TomNicholas/01c5a74ffbdef4e63bd61b2a2cabbae0), it means that only the changes in the `datatree` will affect the `dataset`s but opposite way is not yet supported (see: https://github.com/xarray-contrib/datatree/issues/80 ).
It means that modifications done on the`dataset`s should be `assign` explicitely with such syntaxe:
`datatree['measurement'] = datatree['measurement'].assign(dataset)`
Contributors
agrouaze , thanks to keewis for his hints and to lanougue for his feedbacks