What’s New#

This page summarises the major changes and additions to Ocetrac. For a full list of commits and pull requests, see the GitHub changelog.

New Features#

  • Extended Ocetrac to support subsurface tracking via the new ocetrac.DeepTrack.DeepTracker class, which operates on fields with dimensions (time, depth, lat, lon).

  • Restructured the package so that the original tracking algorithm is now formalised as ocetrac.SurfTrack, giving each tracker a namespace and making it easier to add new trackers in the future.

  • Added connect_depth() for linking blobs across depth layers, anisotropic structuring element support via make_anisotropic_struct(), and cell volume computation via build_cell_volume().

Documentation#

  • Rebuilt the documentation using the pydata-sphinx-theme, including a redesigned homepage with an animated feature showcase.

  • Added a new Ocetrac Structure Overview page describing the package architecture and data flow pipeline.

  • Added a new DeepTrack tutorial notebook demonstrating end-to-end subsurface event tracking on CESM2 Large Ensemble data.

  • Restructured sidebar navigation with separate Overview and Tutorial sections and improved API reference with cleaner class signatures.

Internal Changes#

  • Reorganised the package into ocetrac.SurfTrack and ocetrac.DeepTrack submodules. The original algorithm is preserved and the ocetrac.SurfTrack interface is unchanged.