PyStormTracker 0.7.0__tar.gz → 0.8.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (198) hide show
  1. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/dependabot.yml +8 -4
  2. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/ci.yml +18 -14
  3. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/docker-build.yml +5 -4
  4. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/docker-publish.yml +1 -1
  5. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/python-publish.yml +3 -3
  6. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.pre-commit-config.yaml +16 -3
  7. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.zenodo.json +1 -1
  8. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/CITATION.cff +1 -1
  9. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/PKG-INFO +20 -15
  10. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/README.md +16 -12
  11. pystormtracker-0.8.0/docs/_static/layout.css +25 -0
  12. pystormtracker-0.8.0/docs/algorithms.md +9 -0
  13. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/api.md +7 -4
  14. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/architecture.md +16 -7
  15. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/changelog.md +18 -0
  16. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/cli.md +1 -1
  17. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/conf.py +19 -1
  18. pystormtracker-0.8.0/docs/development.md +11 -0
  19. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/healpix.md +10 -4
  20. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/hodges.md +37 -30
  21. pystormtracker-0.8.0/docs/index.md +18 -0
  22. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/quickstart.md +4 -1
  23. pystormtracker-0.8.0/docs/reference.md +10 -0
  24. pystormtracker-0.8.0/docs/roadmap.md +84 -0
  25. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/pyproject.toml +9 -4
  26. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/__init__.py +4 -0
  27. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/backends.py +11 -7
  28. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/cli.py +6 -2
  29. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/compare.py +4 -0
  30. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/convert.py +4 -0
  31. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/healpix/__init__.py +4 -0
  32. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/healpix/constants.py +4 -0
  33. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/healpix/detector.py +4 -0
  34. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/healpix/tracker.py +8 -1
  35. pystormtracker-0.8.0/src/pystormtracker/hodges/__init__.py +7 -0
  36. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/constants.py +4 -0
  37. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/detections.py +4 -0
  38. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/detector.py +4 -0
  39. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/linker.py +4 -0
  40. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/mge.py +4 -0
  41. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/progress.py +6 -2
  42. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/rsplice.py +4 -0
  43. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/segments.py +4 -0
  44. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/tracker.py +8 -4
  45. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/__init__.py +4 -0
  46. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/data_loader.py +8 -4
  47. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/format.py +4 -0
  48. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/imilast.py +4 -0
  49. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/track.py +4 -0
  50. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/trackjson.py +4 -0
  51. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/__init__.py +4 -0
  52. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/compare.py +4 -0
  53. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/cross_validation.py +4 -0
  54. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/eulerian.py +5 -1
  55. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/lagrangian.py +5 -1
  56. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/weighting.py +4 -0
  57. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/__init__.py +4 -0
  58. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/_cftime.py +4 -0
  59. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/center.py +5 -0
  60. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/geo.py +4 -0
  61. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/time.py +4 -0
  62. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/tracker.py +4 -0
  63. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/tracks.py +4 -0
  64. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/units.py +4 -0
  65. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/__init__.py +4 -0
  66. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/kinematics.py +166 -79
  67. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/regrid.py +166 -60
  68. pystormtracker-0.8.0/src/pystormtracker/preprocessing/spectral.py +803 -0
  69. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/spherical_geometry.py +4 -0
  70. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/taper.py +4 -0
  71. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/tracking.py +4 -0
  72. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/refinement/__init__.py +4 -0
  73. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/refinement/bspline.py +4 -0
  74. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/refinement/quadratic.py +4 -0
  75. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/sample.py +4 -0
  76. pystormtracker-0.8.0/src/pystormtracker/schemas/__init__.py +5 -0
  77. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/schemas/generate.py +4 -0
  78. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/schemas/trackjson.schema.json +12 -0
  79. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/__init__.py +4 -0
  80. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/constants.py +4 -0
  81. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/detector.py +5 -0
  82. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/linker.py +5 -0
  83. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/tracker.py +8 -1
  84. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/track.py +4 -0
  85. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/utils/cli.py +4 -0
  86. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/utils/docs.py +4 -0
  87. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/utils/logging.py +6 -2
  88. pystormtracker-0.8.0/tests/__init__.py +3 -0
  89. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/conftest.py +4 -0
  90. pystormtracker-0.8.0/tests/integration/__init__.py +3 -0
  91. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_cli_extra.py +4 -0
  92. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_hodges.py +4 -0
  93. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_io.py +4 -0
  94. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_parallel_backends.py +4 -0
  95. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_projection.py +4 -0
  96. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_reduced_gaussian.py +4 -0
  97. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_simple.py +4 -0
  98. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_trackjson.py +4 -0
  99. pystormtracker-0.8.0/tests/parity/__init__.py +3 -0
  100. pystormtracker-0.8.0/tests/parity/legacy/__init__.py +3 -0
  101. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/parity/legacy/test_simple_v0_0_2_parity.py +4 -0
  102. pystormtracker-0.8.0/tests/parity/ncl_spherepack/__init__.py +3 -0
  103. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/parity/ncl_spherepack/test_spectral_ncl.py +4 -0
  104. pystormtracker-0.8.0/tests/unit/__init__.py +3 -0
  105. pystormtracker-0.8.0/tests/unit/healpix/__init__.py +3 -0
  106. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/healpix/test_detector.py +4 -0
  107. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/healpix/test_tracker.py +4 -0
  108. pystormtracker-0.8.0/tests/unit/hodges/__init__.py +3 -0
  109. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_detector.py +4 -0
  110. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_linker.py +4 -0
  111. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_mge.py +4 -0
  112. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_progress.py +4 -0
  113. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_segments.py +4 -0
  114. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_tracker.py +4 -0
  115. pystormtracker-0.8.0/tests/unit/io/__init__.py +3 -0
  116. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_data_loader.py +4 -0
  117. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_format.py +4 -0
  118. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_imilast.py +4 -0
  119. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_track.py +4 -0
  120. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_trackjson.py +4 -0
  121. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_cross_validation.py +4 -0
  122. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_eulerian.py +4 -0
  123. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_lagrangian.py +4 -0
  124. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_rsplice.py +4 -0
  125. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_weighting.py +4 -0
  126. pystormtracker-0.8.0/tests/unit/models/__init__.py +3 -0
  127. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/models/test_center.py +4 -0
  128. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/models/test_geo.py +4 -0
  129. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/models/test_tracks.py +4 -0
  130. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/models/test_units.py +4 -0
  131. pystormtracker-0.8.0/tests/unit/preprocessing/__init__.py +3 -0
  132. pystormtracker-0.8.0/tests/unit/preprocessing/test_kinematics.py +447 -0
  133. pystormtracker-0.8.0/tests/unit/preprocessing/test_regrid.py +396 -0
  134. pystormtracker-0.8.0/tests/unit/preprocessing/test_spectral.py +542 -0
  135. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/refinement/test_bspline.py +4 -0
  136. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/refinement/test_quadratic.py +4 -0
  137. pystormtracker-0.8.0/tests/unit/simple/__init__.py +3 -0
  138. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/simple/test_detector.py +4 -0
  139. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/simple/test_linker.py +4 -0
  140. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/simple/test_tracker.py +4 -0
  141. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_api.py +4 -0
  142. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_backends.py +4 -0
  143. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_cli.py +4 -0
  144. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_compare.py +4 -0
  145. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_convert.py +4 -0
  146. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_observability.py +4 -0
  147. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_preprocessing.py +4 -0
  148. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_sample.py +4 -0
  149. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_time.py +4 -0
  150. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_track_cli.py +4 -0
  151. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_utils.py +4 -0
  152. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/utils.py +4 -0
  153. pystormtracker-0.8.0/uv.lock +4996 -0
  154. pystormtracker-0.7.0/docs/index.md +0 -35
  155. pystormtracker-0.7.0/docs/readme.md +0 -4
  156. pystormtracker-0.7.0/docs/roadmap.md +0 -338
  157. pystormtracker-0.7.0/src/pystormtracker/hodges/__init__.py +0 -3
  158. pystormtracker-0.7.0/src/pystormtracker/preprocessing/spectral.py +0 -754
  159. pystormtracker-0.7.0/src/pystormtracker/schemas/__init__.py +0 -1
  160. pystormtracker-0.7.0/tests/__init__.py +0 -0
  161. pystormtracker-0.7.0/tests/integration/__init__.py +0 -0
  162. pystormtracker-0.7.0/tests/parity/__init__.py +0 -0
  163. pystormtracker-0.7.0/tests/parity/legacy/__init__.py +0 -0
  164. pystormtracker-0.7.0/tests/parity/ncl_spherepack/__init__.py +0 -0
  165. pystormtracker-0.7.0/tests/unit/__init__.py +0 -0
  166. pystormtracker-0.7.0/tests/unit/healpix/__init__.py +0 -0
  167. pystormtracker-0.7.0/tests/unit/hodges/__init__.py +0 -0
  168. pystormtracker-0.7.0/tests/unit/io/__init__.py +0 -0
  169. pystormtracker-0.7.0/tests/unit/models/__init__.py +0 -0
  170. pystormtracker-0.7.0/tests/unit/preprocessing/__init__.py +0 -0
  171. pystormtracker-0.7.0/tests/unit/preprocessing/test_kinematics.py +0 -137
  172. pystormtracker-0.7.0/tests/unit/preprocessing/test_regrid.py +0 -205
  173. pystormtracker-0.7.0/tests/unit/preprocessing/test_spectral.py +0 -217
  174. pystormtracker-0.7.0/tests/unit/simple/__init__.py +0 -0
  175. pystormtracker-0.7.0/uv.lock +0 -4575
  176. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.dockerignore +0 -0
  177. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.gitattributes +0 -0
  178. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/pull_request_template.md +0 -0
  179. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/dependency-review.yml +0 -0
  180. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.gitignore +0 -0
  181. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.python-version +0 -0
  182. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.readthedocs.yaml +0 -0
  183. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/AGENTS.md +0 -0
  184. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/CONTRIBUTING.md +0 -0
  185. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/Dockerfile +0 -0
  186. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/LICENSE +0 -0
  187. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/codecov.yml +0 -0
  188. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/_static/IntercomparisonProtocol.pdf +0 -0
  189. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/_static/era5_msl_nh.png +0 -0
  190. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/_static/explorer.png +0 -0
  191. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/benchmark.md +0 -0
  192. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/development/testing.md +0 -0
  193. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/puppeteer-config.json +0 -0
  194. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/trackjson.md +0 -0
  195. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/scripts/generate_trackjson_schema.py +0 -0
  196. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/py.typed +0 -0
  197. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/data/era5/era5_msl_2025-12_2.5x2.5.nc +0 -0
  198. {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/data/ncl/era5_msl_2025-12-01_0000_2.5x2.5_t5-42.nc +0 -0
@@ -4,7 +4,8 @@ updates:
4
4
  - package-ecosystem: uv
5
5
  directory: /
6
6
  schedule:
7
- interval: daily
7
+ interval: weekly
8
+ versioning-strategy: increase-if-necessary
8
9
  groups:
9
10
  python-minor-and-patch:
10
11
  patterns: ['*']
@@ -13,7 +14,7 @@ updates:
13
14
  - package-ecosystem: pre-commit
14
15
  directory: /
15
16
  schedule:
16
- interval: daily
17
+ interval: weekly
17
18
  groups:
18
19
  pre-commit:
19
20
  patterns: ['*']
@@ -21,7 +22,7 @@ updates:
21
22
  - package-ecosystem: github-actions
22
23
  directory: /
23
24
  schedule:
24
- interval: daily
25
+ interval: weekly
25
26
  groups:
26
27
  github-actions:
27
28
  patterns: ['*']
@@ -29,4 +30,7 @@ updates:
29
30
  - package-ecosystem: docker
30
31
  directory: /
31
32
  schedule:
32
- interval: daily
33
+ interval: weekly
34
+ groups:
35
+ docker:
36
+ patterns: ['*']
@@ -122,7 +122,7 @@ jobs:
122
122
 
123
123
  - name: Set up uv
124
124
  if: ${{ !cancelled() }}
125
- uses: astral-sh/setup-uv@v10.0.1
125
+ uses: astral-sh/setup-uv@v10.3.0
126
126
  with:
127
127
  version: ${{ env.UV_VERSION }}
128
128
  enable-cache: true
@@ -144,6 +144,10 @@ jobs:
144
144
  if: ${{ !cancelled() }}
145
145
  run: uv run --no-sync mypy
146
146
 
147
+ - name: Check SPDX headers
148
+ if: ${{ !cancelled() }}
149
+ run: uvx prek run spdx --all-files
150
+
147
151
  unit-tests:
148
152
  name: Unit tests (${{ matrix.os }}, Python ${{ matrix.python-version }}${{ matrix.mode != 'normal' && format(', {0}', matrix.mode) || '' }})
149
153
  needs: [select-test-matrix, code-quality]
@@ -157,7 +161,7 @@ jobs:
157
161
  with:
158
162
  persist-credentials: false
159
163
 
160
- - uses: astral-sh/setup-uv@v10.0.1
164
+ - uses: astral-sh/setup-uv@v10.3.0
161
165
  with:
162
166
  version: ${{ env.UV_VERSION }}
163
167
  enable-cache: true
@@ -177,9 +181,9 @@ jobs:
177
181
  if: matrix.mode == 'min-deps'
178
182
  run: uv sync --all-extras --resolution lowest-direct
179
183
 
180
- - name: Install free-threaded dependencies (without EOF, GRIB, or Zarr)
184
+ - name: Install free-threaded dependencies
181
185
  if: matrix.mode == 'free-threaded'
182
- run: uv sync --frozen --extra mpi --extra netcdf4
186
+ run: uv sync --frozen
183
187
 
184
188
  - name: Smoke-check GRIB and Zarr dependencies
185
189
  if: matrix.mode != 'free-threaded'
@@ -222,7 +226,7 @@ jobs:
222
226
 
223
227
  - name: Upload coverage
224
228
  if: matrix.mode == 'coverage' || matrix.mode == 'jit-coverage' || matrix.mode == 'disabled-jit-coverage'
225
- uses: codecov/codecov-action@v7.0.0
229
+ uses: codecov/codecov-action@v7.1.1
226
230
  with:
227
231
  files: ./coverage.xml
228
232
  disable_search: true
@@ -232,7 +236,7 @@ jobs:
232
236
 
233
237
  - name: Upload test results
234
238
  if: ${{ !cancelled() && matrix.mode == 'coverage' }}
235
- uses: codecov/codecov-action@v7.0.0
239
+ uses: codecov/codecov-action@v7.1.1
236
240
  with:
237
241
  files: ./junit.xml
238
242
  disable_search: true
@@ -253,7 +257,7 @@ jobs:
253
257
  with:
254
258
  persist-credentials: false
255
259
 
256
- - uses: astral-sh/setup-uv@v10.0.1
260
+ - uses: astral-sh/setup-uv@v10.3.0
257
261
  with:
258
262
  version: ${{ env.UV_VERSION }}
259
263
  enable-cache: true
@@ -280,7 +284,7 @@ jobs:
280
284
 
281
285
  - name: Upload coverage
282
286
  if: matrix.coverage == true
283
- uses: codecov/codecov-action@v7.0.0
287
+ uses: codecov/codecov-action@v7.1.1
284
288
  with:
285
289
  files: ./coverage.xml
286
290
  disable_search: true
@@ -290,7 +294,7 @@ jobs:
290
294
 
291
295
  - name: Upload test results
292
296
  if: ${{ !cancelled() && matrix.coverage == true }}
293
- uses: codecov/codecov-action@v7.0.0
297
+ uses: codecov/codecov-action@v7.1.1
294
298
  with:
295
299
  files: ./junit.xml
296
300
  disable_search: true
@@ -311,7 +315,7 @@ jobs:
311
315
  with:
312
316
  persist-credentials: false
313
317
 
314
- - uses: astral-sh/setup-uv@v10.0.1
318
+ - uses: astral-sh/setup-uv@v10.3.0
315
319
  with:
316
320
  version: ${{ env.UV_VERSION }}
317
321
  enable-cache: true
@@ -333,7 +337,7 @@ jobs:
333
337
 
334
338
  - name: Upload coverage
335
339
  if: matrix.coverage == true
336
- uses: codecov/codecov-action@v7.0.0
340
+ uses: codecov/codecov-action@v7.1.1
337
341
  with:
338
342
  files: ./coverage.xml
339
343
  disable_search: true
@@ -343,7 +347,7 @@ jobs:
343
347
 
344
348
  - name: Upload test results
345
349
  if: ${{ !cancelled() && matrix.coverage == true }}
346
- uses: codecov/codecov-action@v7.0.0
350
+ uses: codecov/codecov-action@v7.1.1
347
351
  with:
348
352
  files: ./junit.xml
349
353
  disable_search: true
@@ -361,7 +365,7 @@ jobs:
361
365
  with:
362
366
  persist-credentials: false
363
367
 
364
- - uses: astral-sh/setup-uv@v10.0.1
368
+ - uses: astral-sh/setup-uv@v10.3.0
365
369
  with:
366
370
  version: ${{ env.UV_VERSION }}
367
371
  enable-cache: true
@@ -417,7 +421,7 @@ jobs:
417
421
  with:
418
422
  persist-credentials: false
419
423
 
420
- - uses: astral-sh/setup-uv@v10.0.1
424
+ - uses: astral-sh/setup-uv@v10.3.0
421
425
  with:
422
426
  version: ${{ env.UV_VERSION }}
423
427
  enable-cache: true
@@ -115,7 +115,7 @@ jobs:
115
115
  ref: ${{ needs.select-platforms.outputs.source_sha }}
116
116
  persist-credentials: false
117
117
 
118
- - uses: docker/setup-buildx-action@v4.3.0
118
+ - uses: docker/setup-buildx-action@v4.4.1
119
119
 
120
120
  - name: Set image tag
121
121
  id: image
@@ -133,7 +133,7 @@ jobs:
133
133
 
134
134
  - name: Build image
135
135
  id: build
136
- uses: docker/build-push-action@v7.3.0
136
+ uses: docker/build-push-action@v7.4.0
137
137
  with:
138
138
  context: .
139
139
  load: ${{ needs.select-platforms.outputs.push_images != 'true' }}
@@ -176,7 +176,8 @@ jobs:
176
176
 
177
177
  - name: Scan critical vulnerabilities
178
178
  if: matrix.arch == 'amd64'
179
- uses: aquasecurity/trivy-action@v0.36.0
179
+ uses: aquasecurity/trivy-action@6abccf398f78b4c337599c0656f933d91efb91a0
180
+ continue-on-error: true
180
181
  with:
181
182
  image-ref: ${{ steps.test-image.outputs.reference }}
182
183
  format: table
@@ -194,7 +195,7 @@ jobs:
194
195
  outputs:
195
196
  source_tag: ${{ needs.select-platforms.outputs.source_tag }}
196
197
  steps:
197
- - uses: docker/setup-buildx-action@v4.3.0
198
+ - uses: docker/setup-buildx-action@v4.4.1
198
199
 
199
200
  - name: Log in to Docker Hub test repository
200
201
  uses: docker/login-action@v4.6.0
@@ -63,7 +63,7 @@ jobs:
63
63
  runs-on: ubuntu-26.04
64
64
  timeout-minutes: 20
65
65
  steps:
66
- - uses: docker/setup-buildx-action@v4.3.0
66
+ - uses: docker/setup-buildx-action@v4.4.1
67
67
 
68
68
  - name: Log in to Docker Hub
69
69
  uses: docker/login-action@v4.6.0
@@ -40,7 +40,7 @@ jobs:
40
40
 
41
41
  steps:
42
42
  - name: Retrieve tested distributions
43
- uses: actions/download-artifact@v8.0.1
43
+ uses: actions/download-artifact@v8.0.2
44
44
  with:
45
45
  name: release-dists
46
46
  path: dist/
@@ -53,7 +53,7 @@ jobs:
53
53
  github-token: ${{ github.token }}
54
54
 
55
55
  - name: Set up uv
56
- uses: astral-sh/setup-uv@v10.0.1
56
+ uses: astral-sh/setup-uv@v10.3.0
57
57
  with:
58
58
  version: '0.12.1'
59
59
  python-version: '3.14'
@@ -87,7 +87,7 @@ jobs:
87
87
 
88
88
  steps:
89
89
  - name: Retrieve tested distributions
90
- uses: actions/download-artifact@v8.0.1
90
+ uses: actions/download-artifact@v8.0.2
91
91
  with:
92
92
  name: release-dists
93
93
  path: dist/
@@ -12,12 +12,12 @@ repos:
12
12
  - id: trailing-whitespace
13
13
 
14
14
  - repo: https://github.com/astral-sh/uv-pre-commit
15
- rev: 0.12.9
15
+ rev: 0.13.0
16
16
  hooks:
17
17
  - id: uv-lock
18
18
 
19
19
  - repo: https://github.com/astral-sh/ruff-pre-commit
20
- rev: v0.16.6
20
+ rev: v0.17.0
21
21
  hooks:
22
22
  - id: ruff-check
23
23
  types_or: [ python, pyproject ]
@@ -26,7 +26,7 @@ repos:
26
26
  types_or: [ python ]
27
27
 
28
28
  - repo: https://github.com/astral-sh/ty-pre-commit
29
- rev: v0.0.78
29
+ rev: v0.0.86
30
30
  hooks:
31
31
  - id: ty
32
32
  args: [ --all-extras, --isolated ]
@@ -42,3 +42,16 @@ repos:
42
42
  - mdformat-gfm-alerts
43
43
  - mdformat-simple-breaks
44
44
  - mdformat-web
45
+
46
+ - repo: local
47
+ hooks:
48
+ - id: spdx
49
+ name: Add SPDX headers
50
+ entry: uvx reuse==6.2.0 annotate
51
+ language: system
52
+ args:
53
+ - --copyright=Albert M. W. Yau
54
+ - --license=BSD-3-Clause
55
+ - --merge-copyrights
56
+ - --skip-unrecognised
57
+ files: '^(pyproject\.toml|(?:src|tests)/.*\.(?:py|pyi))$'
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "title": "PyStormTracker: A High-Performance Cyclone Tracker in Python",
3
- "description": "PyStormTracker is an open-source Python package for high-performance cyclone detection, trajectory construction, comparison, and storm-track analysis in gridded meteorological data.",
3
+ "description": "PyStormTracker is an open-source Python package for high-performance cyclone detection, trajectory construction, comparison, and storm track analysis in gridded meteorological data.",
4
4
  "creators": [
5
5
  {
6
6
  "name": "Yau, Albert M. W.",
@@ -7,7 +7,7 @@ type: software
7
7
 
8
8
  abstract: >-
9
9
  PyStormTracker is an open-source Python package for high-performance
10
- cyclone detection, trajectory construction, comparison, and storm-track
10
+ cyclone detection, trajectory construction, comparison, and storm track
11
11
  analysis in gridded meteorological data.
12
12
 
13
13
  authors:
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: PyStormTracker
3
- Version: 0.7.0
3
+ Version: 0.8.0
4
4
  Summary: A High-Performance Cyclone Tracker in Python
5
5
  Project-URL: Homepage, https://pystormtracker.readthedocs.io/
6
6
  Project-URL: Repository, https://github.com/mwyau/PyStormTracker.git
@@ -24,12 +24,13 @@ Requires-Dist: msgspec>=0.20.0
24
24
  Requires-Dist: numba>=0.67.0
25
25
  Requires-Dist: numpy>=2.5.0
26
26
  Requires-Dist: scipy>=1.16.1
27
+ Requires-Dist: spharmgrid<0.6,>=0.5.0
27
28
  Requires-Dist: xarray>=2024.9.0
28
29
  Provides-Extra: all
29
30
  Requires-Dist: cfgrib>=0.9.15.1; extra == 'all'
30
31
  Requires-Dist: cftime>=1.6.5; extra == 'all'
31
32
  Requires-Dist: eccodes>=2.46.0; extra == 'all'
32
- Requires-Dist: eccodeslib>=2.46.0; (sys_platform != 'win32') and extra == 'all'
33
+ Requires-Dist: eccodeslib<=2.49.0.30,>=2.46.0; (sys_platform != 'win32') and extra == 'all'
33
34
  Requires-Dist: fsspec[http]>=2024.9.0; extra == 'all'
34
35
  Requires-Dist: mpi4py>=4.1.0; extra == 'all'
35
36
  Requires-Dist: netcdf4>=1.7.2; extra == 'all'
@@ -40,7 +41,7 @@ Requires-Dist: xeofs[etc]>=3.0.3; extra == 'eof'
40
41
  Provides-Extra: grib
41
42
  Requires-Dist: cfgrib>=0.9.15.1; extra == 'grib'
42
43
  Requires-Dist: eccodes>=2.46.0; extra == 'grib'
43
- Requires-Dist: eccodeslib>=2.46.0; (sys_platform != 'win32') and extra == 'grib'
44
+ Requires-Dist: eccodeslib<=2.49.0.30,>=2.46.0; (sys_platform != 'win32') and extra == 'grib'
44
45
  Provides-Extra: mpi
45
46
  Requires-Dist: mpi4py>=4.1.0; extra == 'mpi'
46
47
  Provides-Extra: netcdf4
@@ -57,7 +58,6 @@ Description-Content-Type: text/markdown
57
58
  [![Documentation Status](https://readthedocs.org/projects/pystormtracker/badge/?version=latest)](https://pystormtracker.readthedocs.io/en/latest/?badge=latest)
58
59
  [![codecov](https://codecov.io/github/mwyau/PyStormTracker/graph/badge.svg?token=JmTabGA3cq)](https://codecov.io/github/mwyau/PyStormTracker)
59
60
  [![PyPI version](https://img.shields.io/pypi/v/PyStormTracker)](https://pypi.org/project/PyStormTracker/)
60
- [![TestPyPI Version](https://img.shields.io/pypi/v/PyStormTracker?pypiBaseUrl=https://test.pypi.org&label=testpypi)](https://test.pypi.org/project/PyStormTracker/)
61
61
  [![Conda Version](https://img.shields.io/conda/vn/conda-forge/pystormtracker)](https://anaconda.org/channels/conda-forge/packages/pystormtracker/overview)
62
62
  [![GitHub License](https://img.shields.io/github/license/mwyau/PyStormTracker)](https://github.com/mwyau/PyStormTracker/blob/main/LICENSE)
63
63
  [![PyPI Python Version](https://img.shields.io/pypi/pyversions/PyStormTracker)](https://pypi.org/project/PyStormTracker/)
@@ -65,16 +65,18 @@ Description-Content-Type: text/markdown
65
65
  [![GHCR](https://img.shields.io/badge/ghcr.io-xddd%2Fpystormtracker-blue?logo=github)](https://github.com/orgs/xddd/packages/container/package/pystormtracker)
66
66
  [![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.18764813-blue.svg)](https://doi.org/10.5281/zenodo.18764813)
67
67
 
68
- **PyStormTracker** is a Python package for cyclone trajectory analysis. It provides cyclone detection, trajectory construction, and track-based analysis for meteorological and climate datasets. The package includes a Numba Simple Tracker implementation with high-level concept lineage from **Yau and Chang (2020)** and TRACK-compatible algorithms with scientific lineage from **Hodges (1994, 1995, 1999)**. The project was initially developed at the **National Center for Atmospheric Research (NCAR)** during the **2015 SIParCS** program.
68
+ <!-- docs-start -->
69
+
70
+ **PyStormTracker** is a Python package for cyclone trajectory analysis. It provides cyclone detection, trajectory construction, track comparison, variable sampling, and storm track statistics for meteorological and climate datasets. The package includes a Numba implementation of the Simple Tracker used in **Yau and Chang (2020)** and tracking methods based on **Hodges (1994, 1995, 1999)**. The project was initially developed at the **National Center for Atmospheric Research (NCAR)** during the **2015 SIParCS** program.
69
71
 
70
72
  ## Features
71
73
 
72
- - Simple, TRACK-compatible Hodges, and HEALPix tracking.
73
- - NetCDF, GRIB, Zarr, TrackJSON, TRACK tdump, and IMILAST support across regular, Gaussian, reduced-Gaussian, projected, and HEALPix grids.
74
- - Spectral preprocessing, feature refinement, track comparison, variable sampling, and storm-track metrics.
75
- - Serial, Dask, and MPI execution with Numba-accelerated numerical kernels.
74
+ - Simple tracking with nearest-neighbor linking; Hodges and HEALPix tracking with adaptive constraints and Modified Greedy Exchange.
75
+ - NetCDF, GRIB, and Zarr input on regular, Gaussian, reduced-Gaussian, projected, and HEALPix grids; TrackJSON, TRACK tdump, and IMILAST track formats.
76
+ - Spectral preprocessing, feature refinement, track comparison, variable sampling, and storm track metrics.
77
+ - Serial, Dask, and MPI execution with Numba-accelerated numerical kernels and array-backed track storage.
76
78
 
77
- ## Quick start
79
+ ## Usage
78
80
 
79
81
  PyStormTracker requires **Python 3.12+**.
80
82
 
@@ -104,7 +106,7 @@ See the [Quickstart](docs/quickstart.md) for installation options, CLI and Pytho
104
106
 
105
107
  [Documentation](https://pystormtracker.readthedocs.io/) · [Quickstart](docs/quickstart.md) · [CLI](docs/cli.md) · [API](docs/api.md) · [Architecture](docs/architecture.md) · [Hodges / TRACK](docs/hodges.md) · [HEALPix](docs/healpix.md) · [TrackJSON](docs/trackjson.md) · [Benchmarks](docs/benchmark.md)
106
108
 
107
- ## Citations
109
+ ## References
108
110
 
109
111
  If you use PyStormTracker in research, please cite the software:
110
112
 
@@ -114,21 +116,24 @@ PyStormTracker was originally presented as:
114
116
 
115
117
  - **Yau, A. M. W., K. Paul, and J. Dennis**, 2016: PyStormTracker: A Parallel Object-Oriented Cyclone Tracker in Python. *96th American Meteorological Society Annual Meeting*, New Orleans, LA. Zenodo, [doi:10.5281/zenodo.18868625](https://doi.org/10.5281/zenodo.18868625).
116
118
 
117
- For methods used by the Simple tracker and storm-track analysis:
119
+ For `SimpleTracker` and storm track metrics:
118
120
 
119
121
  - **Yau, A. M. W., and E. K. M. Chang**, 2020: Finding Storm Track Activity Metrics That Are Highly Correlated with Weather Impacts. Part I: Frameworks for Evaluation and Accumulated Track Activity. *J. Climate*, **33**, 10169–10186, [doi:10.1175/JCLI-D-20-0393.1](https://doi.org/10.1175/JCLI-D-20-0393.1).
120
122
 
121
- For the feature-identification and trajectory-linking methods implemented by `HodgesTracker`:
123
+ For the methods implemented by `HodgesTracker`:
122
124
 
123
125
  - **Hodges, K. I.**, 1994: A General Method for Tracking Analysis and Its Application to Meteorological Data. *Mon. Wea. Rev.*, **122**, 2573–2586, [doi:10.1175/1520-0493(1994)122\<2573:AGMFTA>2.0.CO;2](https://doi.org/10.1175/1520-0493%281994%29122%3C2573%3AAGMFTA%3E2.0.CO%3B2).
124
126
  - **Hodges, K. I.**, 1995: Feature Tracking on the Unit Sphere. *Mon. Wea. Rev.*, **123**, 3458–3465, [doi:10.1175/1520-0493(1995)123\<3458:FTOTUS>2.0.CO;2](https://doi.org/10.1175/1520-0493%281995%29123%3C3458%3AFTOTUS%3E2.0.CO%3B2).
125
127
  - **Hodges, K. I.**, 1999: Adaptive Constraints for Feature Tracking. *Mon. Wea. Rev.*, **127**, 1362–1373, [doi:10.1175/1520-0493(1999)127\<1362:ACFFT>2.0.CO;2](https://doi.org/10.1175/1520-0493%281999%29127%3C1362%3AACFFT%3E2.0.CO%3B2).
126
128
 
127
- PyStormTracker uses `ducc0` for spherical-harmonic transforms and related spherical numerical operations:
129
+ PyStormTracker uses `spharmgrid` for spherical harmonic filtering, regridding, and wind kinematics on Gauss–Legendre and Clenshaw–Curtis grids. It uses `ducc0` directly for reduced Gaussian and HEALPix grids, polar regridding, and regional cosine transforms:
130
+
131
+ - **Yau, A. M. W.**, 2026: *spharmgrid*. Zenodo,
132
+ [doi:10.5281/zenodo.22559210](https://doi.org/10.5281/zenodo.22559210).
128
133
 
129
134
  - **Reinecke, M.**, 2020: DUCC: Distinctly Useful Code Collection. *Astrophysics Source Code Library*, record [ascl:2008.023](https://ascl.net/2008.023).
130
135
 
131
- For the IMILAST cyclone-tracking intercomparison:
136
+ For the IMILAST intercomparison:
132
137
 
133
138
  - **Neu, U., et al.**, 2013: IMILAST: A Community Effort to Intercompare Extratropical Cyclone Detection and Tracking Algorithms. *Bull. Amer. Meteor. Soc.*, **94**, 529–547, [doi:10.1175/BAMS-D-11-00154.1](https://doi.org/10.1175/BAMS-D-11-00154.1).
134
139
 
@@ -4,7 +4,6 @@
4
4
  [![Documentation Status](https://readthedocs.org/projects/pystormtracker/badge/?version=latest)](https://pystormtracker.readthedocs.io/en/latest/?badge=latest)
5
5
  [![codecov](https://codecov.io/github/mwyau/PyStormTracker/graph/badge.svg?token=JmTabGA3cq)](https://codecov.io/github/mwyau/PyStormTracker)
6
6
  [![PyPI version](https://img.shields.io/pypi/v/PyStormTracker)](https://pypi.org/project/PyStormTracker/)
7
- [![TestPyPI Version](https://img.shields.io/pypi/v/PyStormTracker?pypiBaseUrl=https://test.pypi.org&label=testpypi)](https://test.pypi.org/project/PyStormTracker/)
8
7
  [![Conda Version](https://img.shields.io/conda/vn/conda-forge/pystormtracker)](https://anaconda.org/channels/conda-forge/packages/pystormtracker/overview)
9
8
  [![GitHub License](https://img.shields.io/github/license/mwyau/PyStormTracker)](https://github.com/mwyau/PyStormTracker/blob/main/LICENSE)
10
9
  [![PyPI Python Version](https://img.shields.io/pypi/pyversions/PyStormTracker)](https://pypi.org/project/PyStormTracker/)
@@ -12,16 +11,18 @@
12
11
  [![GHCR](https://img.shields.io/badge/ghcr.io-xddd%2Fpystormtracker-blue?logo=github)](https://github.com/orgs/xddd/packages/container/package/pystormtracker)
13
12
  [![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.18764813-blue.svg)](https://doi.org/10.5281/zenodo.18764813)
14
13
 
15
- **PyStormTracker** is a Python package for cyclone trajectory analysis. It provides cyclone detection, trajectory construction, and track-based analysis for meteorological and climate datasets. The package includes a Numba Simple Tracker implementation with high-level concept lineage from **Yau and Chang (2020)** and TRACK-compatible algorithms with scientific lineage from **Hodges (1994, 1995, 1999)**. The project was initially developed at the **National Center for Atmospheric Research (NCAR)** during the **2015 SIParCS** program.
14
+ <!-- docs-start -->
15
+
16
+ **PyStormTracker** is a Python package for cyclone trajectory analysis. It provides cyclone detection, trajectory construction, track comparison, variable sampling, and storm track statistics for meteorological and climate datasets. The package includes a Numba implementation of the Simple Tracker used in **Yau and Chang (2020)** and tracking methods based on **Hodges (1994, 1995, 1999)**. The project was initially developed at the **National Center for Atmospheric Research (NCAR)** during the **2015 SIParCS** program.
16
17
 
17
18
  ## Features
18
19
 
19
- - Simple, TRACK-compatible Hodges, and HEALPix tracking.
20
- - NetCDF, GRIB, Zarr, TrackJSON, TRACK tdump, and IMILAST support across regular, Gaussian, reduced-Gaussian, projected, and HEALPix grids.
21
- - Spectral preprocessing, feature refinement, track comparison, variable sampling, and storm-track metrics.
22
- - Serial, Dask, and MPI execution with Numba-accelerated numerical kernels.
20
+ - Simple tracking with nearest-neighbor linking; Hodges and HEALPix tracking with adaptive constraints and Modified Greedy Exchange.
21
+ - NetCDF, GRIB, and Zarr input on regular, Gaussian, reduced-Gaussian, projected, and HEALPix grids; TrackJSON, TRACK tdump, and IMILAST track formats.
22
+ - Spectral preprocessing, feature refinement, track comparison, variable sampling, and storm track metrics.
23
+ - Serial, Dask, and MPI execution with Numba-accelerated numerical kernels and array-backed track storage.
23
24
 
24
- ## Quick start
25
+ ## Usage
25
26
 
26
27
  PyStormTracker requires **Python 3.12+**.
27
28
 
@@ -51,7 +52,7 @@ See the [Quickstart](docs/quickstart.md) for installation options, CLI and Pytho
51
52
 
52
53
  [Documentation](https://pystormtracker.readthedocs.io/) · [Quickstart](docs/quickstart.md) · [CLI](docs/cli.md) · [API](docs/api.md) · [Architecture](docs/architecture.md) · [Hodges / TRACK](docs/hodges.md) · [HEALPix](docs/healpix.md) · [TrackJSON](docs/trackjson.md) · [Benchmarks](docs/benchmark.md)
53
54
 
54
- ## Citations
55
+ ## References
55
56
 
56
57
  If you use PyStormTracker in research, please cite the software:
57
58
 
@@ -61,21 +62,24 @@ PyStormTracker was originally presented as:
61
62
 
62
63
  - **Yau, A. M. W., K. Paul, and J. Dennis**, 2016: PyStormTracker: A Parallel Object-Oriented Cyclone Tracker in Python. *96th American Meteorological Society Annual Meeting*, New Orleans, LA. Zenodo, [doi:10.5281/zenodo.18868625](https://doi.org/10.5281/zenodo.18868625).
63
64
 
64
- For methods used by the Simple tracker and storm-track analysis:
65
+ For `SimpleTracker` and storm track metrics:
65
66
 
66
67
  - **Yau, A. M. W., and E. K. M. Chang**, 2020: Finding Storm Track Activity Metrics That Are Highly Correlated with Weather Impacts. Part I: Frameworks for Evaluation and Accumulated Track Activity. *J. Climate*, **33**, 10169–10186, [doi:10.1175/JCLI-D-20-0393.1](https://doi.org/10.1175/JCLI-D-20-0393.1).
67
68
 
68
- For the feature-identification and trajectory-linking methods implemented by `HodgesTracker`:
69
+ For the methods implemented by `HodgesTracker`:
69
70
 
70
71
  - **Hodges, K. I.**, 1994: A General Method for Tracking Analysis and Its Application to Meteorological Data. *Mon. Wea. Rev.*, **122**, 2573–2586, [doi:10.1175/1520-0493(1994)122\<2573:AGMFTA>2.0.CO;2](https://doi.org/10.1175/1520-0493%281994%29122%3C2573%3AAGMFTA%3E2.0.CO%3B2).
71
72
  - **Hodges, K. I.**, 1995: Feature Tracking on the Unit Sphere. *Mon. Wea. Rev.*, **123**, 3458–3465, [doi:10.1175/1520-0493(1995)123\<3458:FTOTUS>2.0.CO;2](https://doi.org/10.1175/1520-0493%281995%29123%3C3458%3AFTOTUS%3E2.0.CO%3B2).
72
73
  - **Hodges, K. I.**, 1999: Adaptive Constraints for Feature Tracking. *Mon. Wea. Rev.*, **127**, 1362–1373, [doi:10.1175/1520-0493(1999)127\<1362:ACFFT>2.0.CO;2](https://doi.org/10.1175/1520-0493%281999%29127%3C1362%3AACFFT%3E2.0.CO%3B2).
73
74
 
74
- PyStormTracker uses `ducc0` for spherical-harmonic transforms and related spherical numerical operations:
75
+ PyStormTracker uses `spharmgrid` for spherical harmonic filtering, regridding, and wind kinematics on Gauss–Legendre and Clenshaw–Curtis grids. It uses `ducc0` directly for reduced Gaussian and HEALPix grids, polar regridding, and regional cosine transforms:
76
+
77
+ - **Yau, A. M. W.**, 2026: *spharmgrid*. Zenodo,
78
+ [doi:10.5281/zenodo.22559210](https://doi.org/10.5281/zenodo.22559210).
75
79
 
76
80
  - **Reinecke, M.**, 2020: DUCC: Distinctly Useful Code Collection. *Astrophysics Source Code Library*, record [ascl:2008.023](https://ascl.net/2008.023).
77
81
 
78
- For the IMILAST cyclone-tracking intercomparison:
82
+ For the IMILAST intercomparison:
79
83
 
80
84
  - **Neu, U., et al.**, 2013: IMILAST: A Community Effort to Intercompare Extratropical Cyclone Detection and Tracking Algorithms. *Bull. Amer. Meteor. Soc.*, **94**, 529–547, [doi:10.1175/BAMS-D-11-00154.1](https://doi.org/10.1175/BAMS-D-11-00154.1).
81
85
 
@@ -0,0 +1,25 @@
1
+ .bd-page-width {
2
+ max-width: 110rem;
3
+ }
4
+
5
+ .bd-main .bd-content .bd-article-container {
6
+ max-width: 75rem;
7
+ }
8
+
9
+ @media (min-width: 992px) {
10
+ #pst-primary-sidebar.bd-sidebar-primary {
11
+ flex: 0 0 var(--pst-sidebar-primary-width);
12
+ width: var(--pst-sidebar-primary-width);
13
+ max-width: var(--pst-sidebar-primary-width);
14
+ }
15
+
16
+ #pst-primary-sidebar.bd-sidebar-primary:not(.pst-squeeze) {
17
+ --pst-sidebar-primary-width: 16rem;
18
+ }
19
+
20
+ .bd-sidebar-primary.hide-on-wide {
21
+ display: flex;
22
+ visibility: hidden;
23
+ border-right: 0;
24
+ }
25
+ }
@@ -0,0 +1,9 @@
1
+ # Algorithms
2
+
3
+ ```{toctree}
4
+ ---
5
+ maxdepth: 1
6
+ ---
7
+ Hodges (TRACK) implementation <hodges>
8
+ HEALPix support <healpix>
9
+ ```
@@ -34,10 +34,13 @@ tracks.write("tracks.trackjson")
34
34
  ```
35
35
 
36
36
  For `HodgesTracker`, `frame_workers` controls concurrent frame tasks,
37
- `sht_threads` controls DUCC0 threads per active spherical-harmonic transform,
38
- and `mge_workers` controls concurrent MGE segment tasks. `segment_frames`
39
- controls the scientific temporal segment length independently of these
40
- execution controls.
37
+ `sht_threads` controls threads per active spherical-harmonic transform, and
38
+ `mge_workers` controls concurrent MGE segment tasks. The value is passed to
39
+ spharmgrid on supported rectangular operations and to direct DUCC operations
40
+ for reduced-Gaussian, HEALPix, polar, regional-DCT, and explicit-`lmax`
41
+ vector-kinematics paths.
42
+ `segment_frames` controls the scientific temporal segment length independently
43
+ of these execution controls.
41
44
 
42
45
  ## Package API
43
46
 
@@ -88,6 +88,13 @@ Optional filtering and transform bandwidth are distinct. Regridding may require
88
88
  a finite transform bandwidth even when no scientific spectral filter was
89
89
  requested.
90
90
 
91
+ Public `spharmgrid` operations provide rectangular Gauss--Legendre and
92
+ Clenshaw--Curtis filtering, triangular-band spherical regridding, and default
93
+ xarray vorticity/divergence calculations. PyStormTracker supplies preprocessing
94
+ policy, provenance, NumPy-to-xarray adapters, and direct implementations for
95
+ reduced-Gaussian, HEALPix, polar, regional-DCT, and explicit-`lmax`
96
+ vector-kinematics paths.
97
+
91
98
  For Dask execution, preprocessing remains in the xarray/Dask graph.
92
99
  `extract_dask_frame_delayed_blocks()` produces one complete spatial block per
93
100
  time step. Small coordinate and time arrays are materialized eagerly; the full
@@ -166,8 +173,9 @@ flowchart TB
166
173
  Each frame task includes its lazy source read, any required preprocessing/SHT,
167
174
  object and candidate detection, and feature-point refinement. Frame tasks are
168
175
  independent across time steps and produce small immutable
169
- `HodgesCenterFrame` objects. Each SHT call uses `sht_threads` DUCC0 native
170
- threads per active task.
176
+ `HodgesCenterFrame` objects. Each spherical-harmonic call uses `sht_threads`
177
+ threads per active task; supported rectangular xarray calls use spharmgrid and
178
+ special-grid calls use direct DUCC.
171
179
 
172
180
  The detection objects are computed before MGE segment tasks are built. Overlap
173
181
  lists reference the same detection objects; full filtered frame arrays are not
@@ -185,11 +193,12 @@ Numba-compiled and `nogil`, but one MGE segment is not internally divided into
185
193
  parallel pair-exchange tasks.
186
194
 
187
195
  When omitted, Dask `frame_workers` and `mge_workers` resolve independently to
188
- available process CPU concurrency. `sht_threads=None` resolves to one DUCC0
189
- thread per active transform for Dask and MPI, and to DUCC0's hardware-thread
190
- default (`nthreads=0`) for serial execution. Explicit frame and MGE worker
191
- controls apply only to Dask; explicit `sht_threads` is also meaningful for
192
- serial and MPI rank-local transforms.
196
+ available process CPU concurrency. `sht_threads=None` resolves to one thread
197
+ per active transform for Dask and MPI. Serial operations use the native
198
+ default of their numerical path: spharmgrid receives `None`, while direct DUCC
199
+ paths use the existing zero-thread configuration. Explicit frame and MGE
200
+ worker controls apply only to Dask; explicit `sht_threads` is also meaningful
201
+ for serial and MPI rank-local transforms.
193
202
 
194
203
  `HealpixTracker` follows the same frame-task and MGE-segment organization. Its
195
204
  frame-level detection uses HEALPix pixel topology before passing refined feature
@@ -1,5 +1,23 @@
1
1
  # Changelog
2
2
 
3
+ ## v0.8.0 - 2026-10-17
4
+
5
+ ### Spectral preprocessing
6
+
7
+ - Moved rectangular Gauss--Legendre and Clenshaw--Curtis filtering, triangular-band regular-grid regridding, and default wind kinematics to `spharmgrid`.
8
+ - Used direct `ducc0` for reduced-Gaussian, HEALPix, polar, regional-DCT, and explicit-`lmax` vector-kinematics paths.
9
+ - Removed the unused `DH` geometry, unified NumPy and Xarray rectangular-grid handling, and rejected unsupported non-triangular regular-grid `mmax` requests.
10
+ - Raised the minimum `spharmgrid` version to 0.5.0.
11
+
12
+ ### Documentation and repository metadata
13
+
14
+ - Switched the documentation site to the PyData Sphinx Theme and made the README and quickstart the main entry points.
15
+ - Updated the spharmgrid citation and removed the TestPyPI badge.
16
+ - Added BSD-3-Clause SPDX metadata and CI checks.
17
+ - Updated the pinned Trivy action.
18
+
19
+ ---
20
+
3
21
  ## v0.7.0 - 2026-09-07
4
22
 
5
23
  ### Tracking and preprocessing
@@ -75,7 +75,7 @@ The production default relative-vorticity threshold is `1e-5 s^-1`. The `1e-4 s^
75
75
  | `-b`, `--backend` | `dask`, `serial`, or `mpi`. Default: `dask` (or `mpi` if an active MPI environment is detected). |
76
76
  | `-w`, `--workers` | Generic Dask worker count for Simple/HEALPix. Defaults to available process CPU concurrency; not accepted by Hodges. |
77
77
  | `--frame-workers` | Hodges Dask frame-processing tasks, including lazy source reads, preprocessing, detection, and refinement. |
78
- | `--sht-threads` | DUCC0 native threads per active Hodges spherical-harmonic transform. |
78
+ | `--sht-threads` | Threads per active Hodges spherical-harmonic transform; passed to spharmgrid on supported rectangular paths and to direct DUCC special paths. |
79
79
  | `--mge-workers` | Hodges Dask MGE segment-linking tasks that may run concurrently. |
80
80
  | `-c`, `--segment-frames` | MGE temporal segment length for Hodges/HEALPix; default `62`. Not used by Simple and independent of worker counts. An explicit value cannot be combined with `--no-segmentation`. |
81
81
  | `-e`, `--engine` | Xarray engine: `h5netcdf` by default, or explicitly `netcdf4` for legacy NetCDF3 and `cfgrib` for GRIB. |
@@ -43,9 +43,27 @@ exclude_patterns = [
43
43
  ]
44
44
 
45
45
  # -- Options for HTML output -------------------------------------------------
46
- html_theme = "sphinx_rtd_theme"
46
+ html_title = project
47
+ html_theme = "pydata_sphinx_theme"
48
+ html_theme_options = {
49
+ "icon_links": [
50
+ {
51
+ "name": "GitHub",
52
+ "url": "https://github.com/mwyau/PyStormTracker",
53
+ "icon": "fa-brands fa-github",
54
+ }
55
+ ],
56
+ "use_edit_page_button": True,
57
+ }
47
58
  html_static_path = ["_static"]
59
+ html_css_files = ["layout.css"]
48
60
  html_extra_path = ["../LICENSE", "../CONTRIBUTING.md"]
61
+ html_context = {
62
+ "github_user": "mwyau",
63
+ "github_repo": "PyStormTracker",
64
+ "github_version": "main",
65
+ "doc_path": "docs/",
66
+ }
49
67
 
50
68
  # -- MyST Parser configuration -----------------------------------------------
51
69
  myst_heading_anchors = 3