v0.2.5

Changelog

All notable changes are documented in this file.

v0.2.5 (2026-02-15)

• Range: v0.2.4..ee58532
• Snapshot commit date: 2026-02-15

User impact summary

This change set is primarily a stability and portability update rather than a major new algorithm release.

What it means for CryoSwath usage

• Day-to-day processing in l1b, l2, l3, l4, gis, and misc is more robust on edge cases (empty chunks/windows, missing columns, unnamed indexes, scalar coordinates, and missing region matches).
• Error handling is clearer in several paths that previously relied on assertions; failures should now be easier to diagnose in production runs.
• l2 multiprocessing is safer across platforms (spawn context + CPU core detection), which helps on macOS/Windows and mixed cluster environments.
• l3 chunk-time reindexing for zarr should reduce write/read issues related to non-contiguous chunk regions.
• Tutorial notebooks were updated to current APIs and now have automated workflow coverage, making the tutorial path more reliable as a usage reference.

New features

• Pixi-first environment support and workflow hardening were added and expanded (including locked runtime solve strategy and feature-scoped tasks).
• A production optional dependency group was introduced.
• Tutorial workflow automation was expanded with Snakemake and tox entrypoints for notebook/pipeline validation.
• A CRISTAL mission portability checklist was added to docs.

Compatibility notes

• Dependency manifests now pin xarray < 2025.12 due to upstream regression handling in this cycle.
• If your environment already uses newer xarray, expect to align to the pinned version before running CryoSwath reliably.

Commits since v0.2.4

• 2025-08-31 2629767 chore: add gitignores
• 2025-08-31 4e8cb24 chore: bump version
• 2025-12-20 6d039f5 misc: update rgi_code_translator
• 2025-12-20 ea142fe update pyproject.toml
• 2025-12-20 d6c4bd8 misc: fix previous commit
• 2026-01-24 a8a2313 fix(misc): allow scalar dimensions in fill_missing_coords
• 2026-01-28 403658c fix: revise download_dem
• 2026-01-29 8c55ef1 chore(l1b): polish code a bit
• 2026-01-29 296ec1a fix(test_plots): correct label
• 2026-01-29 1239d01 fix(misc): use make_valid in load_glacier_outlines
• 2026-01-29 81be744 chore(misc): format
• 2026-01-29 a9d55a7 chore: update readme
• 2026-01-29 d87a946 chore: update docker
• 2026-01-29 075adc2 Add pixi compatibility and installation instructions
• 2026-01-30 09f7c90 fix(misc): fix index issue
• 2026-01-30 bdd8a0c Merge pull request #52 from Tanmay-Ts/add-pixi-support
• 2026-02-01 436de23 !fix(misc): update default DEM names
• 2026-02-01 5faa58a Merge remote-tracking branch 'origin' into develop
• 2026-02-11 117c755 chore: add opt.dep. group production
• 2026-02-11 89d1447 fix(misc): fix building paths from config
• 2026-02-11 3a94789 chore(l2): simplify code
• 2026-02-11 27c7079 fix(l3): fix handling even agg. windows
• 2026-02-11 bb4d0f4 fix(l2): guard grid chunk split for small data
• 2026-02-11 a9a61d1 fix(misc): handle default dir in ESRI conversion
• 2026-02-11 e67840b fix(gis): robust ESRI feather target path
• 2026-02-11 9973b3f fix(l4): guard optional filled_flag updates
• 2026-02-11 97c1f26 fix(l3): raise for unsupported joined L2 aggregation
• 2026-02-11 a39ba02 fix(l4): raise reference deviation sanity check
• 2026-02-11 bf819eb fix(gis): accept scalar lon/lat in CRS selection
• 2026-02-11 b2ccf6c fix(l2): replace assert-based stale cache checks
• 2026-02-11 eab85a5 fix(l2): handle unnamed index in l1b conversion
• 2026-02-11 8e0f77a fix(l2): guard empty grid aggregation paths
• 2026-02-11 40ab2e4 fix(l1b): replace assert-only threshold checks
• 2026-02-11 ba8ea86 fix(l4): call local elevation reference helper
• 2026-02-11 f5860f6 fix(l4): use coefficient arrays in trend reconstruction
• 2026-02-11 cf15928 fix(misc): fail clearly when region lookup is empty
• 2026-02-11 4daf415 fix(l3): honor l2_type when reading cache chunks
• 2026-02-11 3d652ba fix(gis): fail clearly when no o2 region matches
• 2026-02-12 59443cb fix(l1b): narrow xarray timedelta patch version gate
• 2026-02-12 a48cd87 docs(cryoswath): revise RTD pages and API docstrings
• 2026-02-12 13a0e48 docs(sphinx): refine docs style and refresh README warnings
• 2026-02-12 7af912d docs(theme): switch to pydata and clean sidebar/header
• 2026-02-13 d8ec019 docs(linkcode): resolve source refs from git metadata
• 2026-02-13 de9fda1 docs: move env warning to install pages and align manager wording
• 2026-02-13 d5e1cef merge(main): integrate develop (docs refresh, linkcode hardening, and processing fixes)
• 2026-02-14 8c86f40 fix(l2): detect CPU cores cross-platform (refs #38)
• 2026-02-14 100418c fix(l2): use spawn context for multiprocessing safety (refs #35)
• 2026-02-14 eadd824 fix(l3): reindex chunk time to contiguous zarr regions (refs #37)
• 2026-02-14 5ce48ec docs: add CRISTAL portability checklist (refs #42)
• 2026-02-14 4e49632 build: document and harden pixi workflow (refs #51)
• 2026-02-14 bf771bc refactor(l1b): clarify download status messages (refs #20)
• 2026-02-14 7b1d3b8 Pin xarray below 2025.12 across dependency manifests
• 2026-02-14 b66e084 chore: finalize xarray<2025.12 regression fix
• 2026-02-14 0761831 build(deps): align dependency policy and add py3.13 CI coverage
• 2026-02-14 a00e721 fix(test_plots): update dem_transect
• 2026-02-14 e6aec9e fix(l2): fix missing column issue
• 2026-02-14 822a044 test(reports): rename notebooks and add Snakemake conda workflow
• 2026-02-15 7f36903 fix(tests): remove debugging helpers
• 2026-02-15 5d85e9e chore(test): add non-failing anonymous FTP login probe
• 2026-02-15 4e9d342 fix(misc): recover stale cache backup and guard writes with lock
• 2026-02-15 3eec709 fix(l3): handle empty roll aggregations in build_dataset
• 2026-02-15 f2da694 fix(tutorial): use misc.fill_missing_coords in step-by-step notebook
• 2026-02-15 c376355 build(pixi): modernize pyproject metadata and dependency ownership
• 2026-02-15 e8929b5 fix(tutorial): call l4.append_elevation_reference in step-by-step notebook
• 2026-02-15 637377a fix(tutorial): call l4.fill_voids in step-by-step notebook
• 2026-02-15 9905f68 build: scope pixi tasks by feature and align setup docs
• 2026-02-15 ad7410a build(pixi): pin runtime solve strategy and add locked env workflow
• 2026-02-15 6b98cc7 fix(tutorial): replace removed misc.load_basins in process-first-swath
• 2026-02-15 8c725d4 test(tutorials): add snakemake workflow for tutorial notebooks
• 2026-02-15 1840ad0 test(pipeline): add tox entrypoint, config templates, and netrc helper tests
• 2026-02-15 5bf70af test(pipeline): add tutorial notebook workflow and update tutorial API calls
• 2026-02-15 ee58532 merge(build): integrate codex/pixi-followup-envdocs into main