Cryoswath

pip & PyPI

cryoswath is, now, installable - and available on PyPI. See the updated readme for install instructions.

directory structure

The directory and branch structure was refactored. The main branch, now, only includes the code. A new command line function `cryoswath-init` pulls the data and scripts branches, which contain the previous data and scripts directories, to set up an altimetry-project directory structure.

This allows to have one general virtual environment with the cryoswath installation and multiple projects using cryoswath in separated directories.

compatibility

cryoswath is, now, compatible back to python version 3.11 which is available in many repositories.

---------------------------------------------------------------------------------------------------------------------------
**Full Changelog**: https://github.com/j-haacker/cryoswath/compare/v0.2.0...v0.2.1

There is less untouched than changed - I will not be able to provide an overview.

The new version offers a versatile method to grid the point elevation estimates using parallelism based on the dask package. By default the `l3.build_dataset` calculates the median elevation difference to the reference DEM. You can pass a custom aggregation function in case you are interested in other statistics.

For my testing region, I could run it on my local notebook, it took only 10 minutes for a 2-by-2 km grid on 16 CPUs, and less than 30 minutes for the "full-resolution" 500-by-500 m grid.



There are some limitations, however. So far, the aggregation period has to be a number of months and the aggregation function always works on the elevation difference to the reference DEM. The latter is fairly easy to adapt to your needs by changing the `build_dataset` function.

Processing L1b data to L2 is now parallelized.

Also, downloading L1b data now uses multiple threads.

However, it is, yet, not possible to have a backgroud thread to download the data while processing L1b files.

Previous version occasionally discarded waveforms if POCA couldn't be found.

This is the second pre-release. Never the less, this version is better tested and there were substantial improvements.

For the test cases, swath processing including group recognition and POCA retrieval behave as expected.


**Full Changelog**: https://github.com/j-haacker/cryoswath/compare/v0.0.0...v0.1.0