PyStormTracker 0.7.0__tar.gz → 0.8.1__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 (186) hide show
  1. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.github/dependabot.yml +8 -4
  2. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.github/workflows/ci.yml +54 -18
  3. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.github/workflows/docker-build.yml +9 -8
  4. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.github/workflows/docker-publish.yml +3 -3
  5. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.github/workflows/python-publish.yml +5 -5
  6. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.pre-commit-config.yaml +8 -3
  7. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.zenodo.json +1 -1
  8. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/CITATION.cff +1 -1
  9. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/Dockerfile +2 -2
  10. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/PKG-INFO +26 -20
  11. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/README.md +16 -12
  12. pystormtracker-0.8.1/docs/_static/layout.css +25 -0
  13. pystormtracker-0.8.1/docs/algorithms.md +9 -0
  14. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/api.md +7 -4
  15. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/architecture.md +16 -7
  16. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/changelog.md +29 -0
  17. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/cli.md +1 -1
  18. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/conf.py +23 -1
  19. pystormtracker-0.8.1/docs/development.md +11 -0
  20. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/healpix.md +10 -4
  21. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/hodges.md +37 -30
  22. pystormtracker-0.8.1/docs/index.md +18 -0
  23. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/quickstart.md +7 -2
  24. pystormtracker-0.8.1/docs/reference.md +10 -0
  25. pystormtracker-0.8.1/docs/roadmap.md +84 -0
  26. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/pyproject.toml +15 -9
  27. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/scripts/generate_trackjson_schema.py +4 -0
  28. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/__init__.py +4 -0
  29. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/backends.py +11 -7
  30. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/cli.py +6 -2
  31. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/compare.py +4 -0
  32. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/convert.py +4 -0
  33. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/healpix/__init__.py +4 -0
  34. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/healpix/constants.py +4 -0
  35. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/healpix/detector.py +6 -2
  36. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/healpix/tracker.py +8 -1
  37. pystormtracker-0.8.1/src/pystormtracker/hodges/__init__.py +7 -0
  38. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/hodges/constants.py +4 -0
  39. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/hodges/detections.py +4 -0
  40. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/hodges/detector.py +4 -0
  41. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/hodges/linker.py +4 -0
  42. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/hodges/mge.py +4 -0
  43. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/hodges/progress.py +6 -2
  44. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/hodges/rsplice.py +4 -0
  45. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/hodges/segments.py +4 -0
  46. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/hodges/tracker.py +8 -4
  47. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/io/__init__.py +4 -0
  48. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/io/data_loader.py +8 -4
  49. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/io/format.py +4 -0
  50. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/io/imilast.py +4 -0
  51. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/io/track.py +4 -0
  52. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/io/trackjson.py +4 -0
  53. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/metrics/__init__.py +4 -0
  54. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/metrics/compare.py +4 -0
  55. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/metrics/cross_validation.py +4 -0
  56. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/metrics/eulerian.py +5 -1
  57. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/metrics/lagrangian.py +5 -1
  58. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/metrics/weighting.py +4 -0
  59. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/models/__init__.py +4 -0
  60. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/models/_cftime.py +4 -0
  61. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/models/center.py +5 -0
  62. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/models/geo.py +4 -0
  63. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/models/time.py +4 -0
  64. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/models/tracker.py +4 -0
  65. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/models/tracks.py +4 -0
  66. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/models/units.py +4 -0
  67. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/preprocessing/__init__.py +4 -0
  68. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/preprocessing/kinematics.py +166 -79
  69. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/preprocessing/regrid.py +166 -60
  70. pystormtracker-0.8.1/src/pystormtracker/preprocessing/spectral.py +803 -0
  71. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/preprocessing/spherical_geometry.py +4 -0
  72. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/preprocessing/taper.py +4 -0
  73. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/preprocessing/tracking.py +4 -0
  74. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/refinement/__init__.py +4 -0
  75. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/refinement/bspline.py +4 -0
  76. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/refinement/quadratic.py +4 -0
  77. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/sample.py +4 -0
  78. pystormtracker-0.8.1/src/pystormtracker/schemas/__init__.py +5 -0
  79. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/schemas/generate.py +4 -0
  80. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/schemas/trackjson.schema.json +12 -0
  81. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/simple/__init__.py +4 -0
  82. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/simple/constants.py +4 -0
  83. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/simple/detector.py +9 -6
  84. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/simple/linker.py +5 -0
  85. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/simple/tracker.py +8 -1
  86. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/track.py +4 -0
  87. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/utils/cli.py +4 -0
  88. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/utils/docs.py +4 -0
  89. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/utils/logging.py +6 -2
  90. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/conftest.py +4 -0
  91. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/integration/test_cli_extra.py +4 -0
  92. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/integration/test_hodges.py +4 -0
  93. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/integration/test_io.py +4 -0
  94. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/integration/test_parallel_backends.py +5 -1
  95. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/integration/test_projection.py +4 -0
  96. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/integration/test_reduced_gaussian.py +4 -0
  97. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/integration/test_simple.py +4 -0
  98. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/integration/test_trackjson.py +4 -0
  99. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/parity/legacy/test_simple_v0_0_2_parity.py +4 -0
  100. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/parity/ncl_spherepack/test_spectral_ncl.py +4 -0
  101. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/healpix/test_detector.py +4 -0
  102. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/healpix/test_tracker.py +4 -0
  103. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/hodges/test_detector.py +4 -0
  104. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/hodges/test_linker.py +4 -0
  105. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/hodges/test_mge.py +4 -0
  106. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/hodges/test_progress.py +4 -0
  107. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/hodges/test_segments.py +4 -0
  108. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/hodges/test_tracker.py +4 -0
  109. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/io/test_data_loader.py +4 -0
  110. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/io/test_format.py +4 -0
  111. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/io/test_imilast.py +4 -0
  112. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/io/test_track.py +4 -0
  113. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/io/test_trackjson.py +4 -0
  114. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/metrics/test_cross_validation.py +4 -0
  115. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/metrics/test_eulerian.py +4 -0
  116. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/metrics/test_lagrangian.py +4 -0
  117. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/metrics/test_rsplice.py +4 -0
  118. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/metrics/test_weighting.py +4 -0
  119. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/models/test_center.py +4 -0
  120. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/models/test_geo.py +4 -0
  121. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/models/test_tracks.py +4 -0
  122. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/models/test_units.py +4 -0
  123. pystormtracker-0.8.1/tests/unit/preprocessing/test_kinematics.py +447 -0
  124. pystormtracker-0.8.1/tests/unit/preprocessing/test_regrid.py +396 -0
  125. pystormtracker-0.8.1/tests/unit/preprocessing/test_spectral.py +542 -0
  126. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/refinement/test_bspline.py +4 -0
  127. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/refinement/test_quadratic.py +4 -0
  128. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/simple/test_detector.py +4 -0
  129. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/simple/test_linker.py +4 -0
  130. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/simple/test_tracker.py +4 -0
  131. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_api.py +4 -0
  132. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_backends.py +4 -0
  133. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_cli.py +4 -0
  134. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_compare.py +4 -0
  135. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_convert.py +4 -0
  136. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_observability.py +4 -0
  137. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_preprocessing.py +4 -0
  138. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_sample.py +4 -0
  139. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_time.py +4 -0
  140. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_track_cli.py +4 -0
  141. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/test_utils.py +4 -0
  142. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/utils.py +4 -0
  143. pystormtracker-0.8.1/uv.lock +5160 -0
  144. pystormtracker-0.7.0/docs/index.md +0 -35
  145. pystormtracker-0.7.0/docs/readme.md +0 -4
  146. pystormtracker-0.7.0/docs/roadmap.md +0 -338
  147. pystormtracker-0.7.0/src/pystormtracker/hodges/__init__.py +0 -3
  148. pystormtracker-0.7.0/src/pystormtracker/preprocessing/spectral.py +0 -754
  149. pystormtracker-0.7.0/src/pystormtracker/schemas/__init__.py +0 -1
  150. pystormtracker-0.7.0/tests/unit/preprocessing/test_kinematics.py +0 -137
  151. pystormtracker-0.7.0/tests/unit/preprocessing/test_regrid.py +0 -205
  152. pystormtracker-0.7.0/tests/unit/preprocessing/test_spectral.py +0 -217
  153. pystormtracker-0.7.0/uv.lock +0 -4575
  154. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.dockerignore +0 -0
  155. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.gitattributes +0 -0
  156. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.github/pull_request_template.md +0 -0
  157. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.github/workflows/dependency-review.yml +0 -0
  158. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.gitignore +0 -0
  159. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.python-version +0 -0
  160. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/.readthedocs.yaml +0 -0
  161. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/AGENTS.md +0 -0
  162. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/CONTRIBUTING.md +0 -0
  163. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/LICENSE +0 -0
  164. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/codecov.yml +0 -0
  165. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/_static/IntercomparisonProtocol.pdf +0 -0
  166. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/_static/era5_msl_nh.png +0 -0
  167. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/_static/explorer.png +0 -0
  168. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/benchmark.md +0 -0
  169. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/development/testing.md +0 -0
  170. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/puppeteer-config.json +0 -0
  171. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/docs/trackjson.md +0 -0
  172. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/src/pystormtracker/py.typed +0 -0
  173. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/__init__.py +0 -0
  174. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/data/era5/era5_msl_2025-12_2.5x2.5.nc +0 -0
  175. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/data/ncl/era5_msl_2025-12-01_0000_2.5x2.5_t5-42.nc +0 -0
  176. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/integration/__init__.py +0 -0
  177. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/parity/__init__.py +0 -0
  178. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/parity/legacy/__init__.py +0 -0
  179. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/parity/ncl_spherepack/__init__.py +0 -0
  180. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/__init__.py +0 -0
  181. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/healpix/__init__.py +0 -0
  182. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/hodges/__init__.py +0 -0
  183. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/io/__init__.py +0 -0
  184. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/models/__init__.py +0 -0
  185. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/preprocessing/__init__.py +0 -0
  186. {pystormtracker-0.7.0 → pystormtracker-0.8.1}/tests/unit/simple/__init__.py +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: ['*']
@@ -17,7 +17,7 @@ permissions:
17
17
  contents: read
18
18
 
19
19
  env:
20
- UV_VERSION: '0.12.1'
20
+ UV_VERSION: '0.13.9'
21
21
  PYTHON_VERSION: '3.14'
22
22
 
23
23
  jobs:
@@ -43,6 +43,8 @@ jobs:
43
43
  {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "coverage", "coverage_flag": "unit"},
44
44
  {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "jit-coverage", "coverage_flag": "unit-jit-coverage"},
45
45
  {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "disabled-jit-coverage", "coverage_flag": "unit-jit-disabled"},
46
+ {"os": "ubuntu-26.04", "python-version": "3.15", "mode": "normal"},
47
+ {"os": "ubuntu-26.04", "python-version": "3.15t", "mode": "free-threaded"},
46
48
  {"os": "windows-2025", "python-version": "3.13", "mode": "normal"},
47
49
  {"os": "macos-26", "python-version": "3.14", "mode": "normal"}
48
50
  ]
@@ -67,6 +69,8 @@ jobs:
67
69
  {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "jit-coverage", "coverage_flag": "unit-jit-coverage"},
68
70
  {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "disabled-jit-coverage", "coverage_flag": "unit-jit-disabled"},
69
71
  {"os": "ubuntu-26.04", "python-version": "3.14t", "mode": "free-threaded"},
72
+ {"os": "ubuntu-26.04", "python-version": "3.15", "mode": "normal"},
73
+ {"os": "ubuntu-26.04", "python-version": "3.15t", "mode": "free-threaded"},
70
74
  {"os": "windows-2025", "python-version": "3.13", "mode": "normal"},
71
75
  {"os": "macos-26", "python-version": "3.14", "mode": "normal"}
72
76
  ]
@@ -122,12 +126,24 @@ jobs:
122
126
 
123
127
  - name: Set up uv
124
128
  if: ${{ !cancelled() }}
125
- uses: astral-sh/setup-uv@v10.0.1
129
+ uses: astral-sh/setup-uv@v10.3.3
126
130
  with:
127
131
  version: ${{ env.UV_VERSION }}
128
132
  enable-cache: true
129
133
  python-version: ${{ env.PYTHON_VERSION }}
130
134
 
135
+ - name: Run pre-commit hooks
136
+ if: ${{ !cancelled() }}
137
+ run: >-
138
+ uvx prek run --all-files
139
+ check-json check-merge-conflict check-toml check-yaml
140
+ end-of-file-fixer fix-byte-order-marker mixed-line-ending
141
+ trailing-whitespace mdformat
142
+
143
+ - name: Check lockfile
144
+ if: ${{ !cancelled() }}
145
+ run: uv lock --check
146
+
131
147
  - name: Install type-checking environment
132
148
  if: ${{ !cancelled() }}
133
149
  run: uv sync --frozen --all-extras
@@ -138,12 +154,18 @@ jobs:
138
154
 
139
155
  - name: Ty
140
156
  if: ${{ !cancelled() }}
141
- run: uv run --no-sync ty check
157
+ run: >-
158
+ uv check --quiet --preview-features=check-command
159
+ --ty-version=0.0.107 --all-extras --isolated
142
160
 
143
161
  - name: Mypy
144
162
  if: ${{ !cancelled() }}
145
163
  run: uv run --no-sync mypy
146
164
 
165
+ - name: Check SPDX headers
166
+ if: ${{ !cancelled() }}
167
+ uses: mwyau/spdx-header-check@v0.1.0
168
+
147
169
  unit-tests:
148
170
  name: Unit tests (${{ matrix.os }}, Python ${{ matrix.python-version }}${{ matrix.mode != 'normal' && format(', {0}', matrix.mode) || '' }})
149
171
  needs: [select-test-matrix, code-quality]
@@ -157,7 +179,7 @@ jobs:
157
179
  with:
158
180
  persist-credentials: false
159
181
 
160
- - uses: astral-sh/setup-uv@v10.0.1
182
+ - uses: astral-sh/setup-uv@v10.3.3
161
183
  with:
162
184
  version: ${{ env.UV_VERSION }}
163
185
  enable-cache: true
@@ -169,20 +191,34 @@ jobs:
169
191
  with:
170
192
  mpi: msmpi
171
193
 
194
+ - name: Install HDF5 build dependencies for Python 3.15
195
+ if: startsWith(matrix.python-version, '3.15')
196
+ run: |
197
+ sudo apt-get update
198
+ sudo apt-get install -y libhdf5-dev pkg-config
199
+
172
200
  - name: Install dependencies
173
- if: matrix.mode == 'normal' || matrix.mode == 'coverage' || matrix.mode == 'jit-coverage' || matrix.mode == 'disabled-jit-coverage'
201
+ if: >-
202
+ (matrix.mode == 'normal' && matrix.python-version != '3.15') ||
203
+ matrix.mode == 'coverage' ||
204
+ matrix.mode == 'jit-coverage' ||
205
+ matrix.mode == 'disabled-jit-coverage'
174
206
  run: uv sync --frozen --all-extras
175
207
 
208
+ - name: Install Python 3.15 dependencies
209
+ if: matrix.python-version == '3.15'
210
+ run: uv sync --frozen --extra netcdf4
211
+
176
212
  - name: Install minimum direct dependencies
177
213
  if: matrix.mode == 'min-deps'
178
214
  run: uv sync --all-extras --resolution lowest-direct
179
215
 
180
- - name: Install free-threaded dependencies (without EOF, GRIB, or Zarr)
216
+ - name: Install free-threaded dependencies
181
217
  if: matrix.mode == 'free-threaded'
182
- run: uv sync --frozen --extra mpi --extra netcdf4
218
+ run: uv sync --frozen
183
219
 
184
220
  - name: Smoke-check GRIB and Zarr dependencies
185
- if: matrix.mode != 'free-threaded'
221
+ if: matrix.mode != 'free-threaded' && matrix.python-version != '3.15'
186
222
  run: |
187
223
  uv run --no-sync python -m cfgrib selfcheck
188
224
  uv run --no-sync python -c 'import zarr; print("zarr import success")'
@@ -222,7 +258,7 @@ jobs:
222
258
 
223
259
  - name: Upload coverage
224
260
  if: matrix.mode == 'coverage' || matrix.mode == 'jit-coverage' || matrix.mode == 'disabled-jit-coverage'
225
- uses: codecov/codecov-action@v7.0.0
261
+ uses: codecov/codecov-action@v7.1.1
226
262
  with:
227
263
  files: ./coverage.xml
228
264
  disable_search: true
@@ -232,7 +268,7 @@ jobs:
232
268
 
233
269
  - name: Upload test results
234
270
  if: ${{ !cancelled() && matrix.mode == 'coverage' }}
235
- uses: codecov/codecov-action@v7.0.0
271
+ uses: codecov/codecov-action@v7.1.1
236
272
  with:
237
273
  files: ./junit.xml
238
274
  disable_search: true
@@ -253,7 +289,7 @@ jobs:
253
289
  with:
254
290
  persist-credentials: false
255
291
 
256
- - uses: astral-sh/setup-uv@v10.0.1
292
+ - uses: astral-sh/setup-uv@v10.3.3
257
293
  with:
258
294
  version: ${{ env.UV_VERSION }}
259
295
  enable-cache: true
@@ -280,7 +316,7 @@ jobs:
280
316
 
281
317
  - name: Upload coverage
282
318
  if: matrix.coverage == true
283
- uses: codecov/codecov-action@v7.0.0
319
+ uses: codecov/codecov-action@v7.1.1
284
320
  with:
285
321
  files: ./coverage.xml
286
322
  disable_search: true
@@ -290,7 +326,7 @@ jobs:
290
326
 
291
327
  - name: Upload test results
292
328
  if: ${{ !cancelled() && matrix.coverage == true }}
293
- uses: codecov/codecov-action@v7.0.0
329
+ uses: codecov/codecov-action@v7.1.1
294
330
  with:
295
331
  files: ./junit.xml
296
332
  disable_search: true
@@ -311,7 +347,7 @@ jobs:
311
347
  with:
312
348
  persist-credentials: false
313
349
 
314
- - uses: astral-sh/setup-uv@v10.0.1
350
+ - uses: astral-sh/setup-uv@v10.3.3
315
351
  with:
316
352
  version: ${{ env.UV_VERSION }}
317
353
  enable-cache: true
@@ -333,7 +369,7 @@ jobs:
333
369
 
334
370
  - name: Upload coverage
335
371
  if: matrix.coverage == true
336
- uses: codecov/codecov-action@v7.0.0
372
+ uses: codecov/codecov-action@v7.1.1
337
373
  with:
338
374
  files: ./coverage.xml
339
375
  disable_search: true
@@ -343,7 +379,7 @@ jobs:
343
379
 
344
380
  - name: Upload test results
345
381
  if: ${{ !cancelled() && matrix.coverage == true }}
346
- uses: codecov/codecov-action@v7.0.0
382
+ uses: codecov/codecov-action@v7.1.1
347
383
  with:
348
384
  files: ./junit.xml
349
385
  disable_search: true
@@ -361,7 +397,7 @@ jobs:
361
397
  with:
362
398
  persist-credentials: false
363
399
 
364
- - uses: astral-sh/setup-uv@v10.0.1
400
+ - uses: astral-sh/setup-uv@v10.3.3
365
401
  with:
366
402
  version: ${{ env.UV_VERSION }}
367
403
  enable-cache: true
@@ -417,7 +453,7 @@ jobs:
417
453
  with:
418
454
  persist-credentials: false
419
455
 
420
- - uses: astral-sh/setup-uv@v10.0.1
456
+ - uses: astral-sh/setup-uv@v10.3.3
421
457
  with:
422
458
  version: ${{ env.UV_VERSION }}
423
459
  enable-cache: true
@@ -15,7 +15,7 @@ on:
15
15
  uv_version:
16
16
  description: uv image version for Docker builds
17
17
  required: false
18
- default: latest
18
+ default: '0.13.9'
19
19
  type: string
20
20
  secrets:
21
21
  DOCKER_HUB_ACCESS_TOKEN:
@@ -35,7 +35,7 @@ on:
35
35
  uv_version:
36
36
  description: uv image version for Docker builds
37
37
  required: false
38
- default: latest
38
+ default: '0.13.9'
39
39
  type: string
40
40
 
41
41
  concurrency:
@@ -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
@@ -126,14 +126,14 @@ jobs:
126
126
 
127
127
  - name: Log in to Docker Hub test repository
128
128
  if: needs.select-platforms.outputs.push_images == 'true'
129
- uses: docker/login-action@v4.6.0
129
+ uses: docker/login-action@v4.8.0
130
130
  with:
131
131
  username: ${{ vars.DOCKER_HUB_USERNAME }}
132
132
  password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
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@38b337fff0a2f984d5be173c99e3f633438167ec
180
+ continue-on-error: true
180
181
  with:
181
182
  image-ref: ${{ steps.test-image.outputs.reference }}
182
183
  format: table
@@ -194,10 +195,10 @@ 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
- uses: docker/login-action@v4.6.0
201
+ uses: docker/login-action@v4.8.0
201
202
  with:
202
203
  username: ${{ vars.DOCKER_HUB_USERNAME }}
203
204
  password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
@@ -63,16 +63,16 @@ 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
- uses: docker/login-action@v4.6.0
69
+ uses: docker/login-action@v4.8.0
70
70
  with:
71
71
  username: ${{ vars.DOCKER_HUB_USERNAME }}
72
72
  password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
73
73
 
74
74
  - name: Log in to GHCR
75
- uses: docker/login-action@v4.6.0
75
+ uses: docker/login-action@v4.8.0
76
76
  with:
77
77
  registry: ghcr.io
78
78
  username: ${{ github.repository_owner }}
@@ -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,9 +53,9 @@ 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.3
57
57
  with:
58
- version: '0.12.1'
58
+ version: '0.13.9'
59
59
  python-version: '3.14'
60
60
 
61
61
  - name: Check distributions
@@ -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/
@@ -111,7 +111,7 @@ jobs:
111
111
  subject-path: dist/*
112
112
 
113
113
  - name: Publish distributions
114
- uses: pypa/gh-action-pypi-publish@v1.14.2
114
+ uses: pypa/gh-action-pypi-publish@v1.14.3
115
115
  with:
116
116
  packages-dir: dist/
117
117
  repository-url: >-
@@ -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.9
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.5
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.107
30
30
  hooks:
31
31
  - id: ty
32
32
  args: [ --all-extras, --isolated ]
@@ -42,3 +42,8 @@ repos:
42
42
  - mdformat-gfm-alerts
43
43
  - mdformat-simple-breaks
44
44
  - mdformat-web
45
+
46
+ - repo: https://github.com/mwyau/spdx-header-check
47
+ rev: v0.1.0
48
+ hooks:
49
+ - id: spdx-header-check
@@ -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,5 +1,5 @@
1
- # Local builds use the latest uv image; CI passes a pinned version.
2
- ARG UV_VERSION=latest
1
+ # Use the same pinned uv version in local and CI builds.
2
+ ARG UV_VERSION=0.13.9
3
3
  FROM ghcr.io/astral-sh/uv:${UV_VERSION} AS uv
4
4
 
5
5
  # --- Build Stage ---
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: PyStormTracker
3
- Version: 0.7.0
3
+ Version: 0.8.1
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
@@ -14,22 +14,24 @@ Classifier: Programming Language :: Python :: 3
14
14
  Classifier: Programming Language :: Python :: 3.12
15
15
  Classifier: Programming Language :: Python :: 3.13
16
16
  Classifier: Programming Language :: Python :: 3.14
17
+ Classifier: Programming Language :: Python :: 3.15
17
18
  Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
18
19
  Requires-Python: >=3.12
19
20
  Requires-Dist: dask>=2024.1.0
20
- Requires-Dist: ducc0>=0.39.0
21
- Requires-Dist: h5netcdf>=1.8.0
21
+ Requires-Dist: ducc0>=0.42.0
22
+ Requires-Dist: h5netcdf>=1.8.1
22
23
  Requires-Dist: h5py>=3.11.0
23
24
  Requires-Dist: msgspec>=0.20.0
24
25
  Requires-Dist: numba>=0.67.0
25
26
  Requires-Dist: numpy>=2.5.0
26
27
  Requires-Dist: scipy>=1.16.1
27
- Requires-Dist: xarray>=2024.9.0
28
+ Requires-Dist: spharmgrid<0.6,>=0.5.0
29
+ Requires-Dist: xarray>=2025.1.1
28
30
  Provides-Extra: all
29
31
  Requires-Dist: cfgrib>=0.9.15.1; extra == 'all'
30
32
  Requires-Dist: cftime>=1.6.5; extra == 'all'
31
- Requires-Dist: eccodes>=2.46.0; extra == 'all'
32
- Requires-Dist: eccodeslib>=2.46.0; (sys_platform != 'win32') and extra == 'all'
33
+ Requires-Dist: eccodes>=2.50.1; extra == 'all'
34
+ Requires-Dist: eccodeslib>=2.50.0.34; (sys_platform != 'win32') and extra == 'all'
33
35
  Requires-Dist: fsspec[http]>=2024.9.0; extra == 'all'
34
36
  Requires-Dist: mpi4py>=4.1.0; extra == 'all'
35
37
  Requires-Dist: netcdf4>=1.7.2; extra == 'all'
@@ -39,8 +41,8 @@ Provides-Extra: eof
39
41
  Requires-Dist: xeofs[etc]>=3.0.3; extra == 'eof'
40
42
  Provides-Extra: grib
41
43
  Requires-Dist: cfgrib>=0.9.15.1; extra == 'grib'
42
- Requires-Dist: eccodes>=2.46.0; extra == 'grib'
43
- Requires-Dist: eccodeslib>=2.46.0; (sys_platform != 'win32') and extra == 'grib'
44
+ Requires-Dist: eccodes>=2.50.1; extra == 'grib'
45
+ Requires-Dist: eccodeslib>=2.50.0.34; (sys_platform != 'win32') and extra == 'grib'
44
46
  Provides-Extra: mpi
45
47
  Requires-Dist: mpi4py>=4.1.0; extra == 'mpi'
46
48
  Provides-Extra: netcdf4
@@ -57,7 +59,6 @@ Description-Content-Type: text/markdown
57
59
  [![Documentation Status](https://readthedocs.org/projects/pystormtracker/badge/?version=latest)](https://pystormtracker.readthedocs.io/en/latest/?badge=latest)
58
60
  [![codecov](https://codecov.io/github/mwyau/PyStormTracker/graph/badge.svg?token=JmTabGA3cq)](https://codecov.io/github/mwyau/PyStormTracker)
59
61
  [![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
62
  [![Conda Version](https://img.shields.io/conda/vn/conda-forge/pystormtracker)](https://anaconda.org/channels/conda-forge/packages/pystormtracker/overview)
62
63
  [![GitHub License](https://img.shields.io/github/license/mwyau/PyStormTracker)](https://github.com/mwyau/PyStormTracker/blob/main/LICENSE)
63
64
  [![PyPI Python Version](https://img.shields.io/pypi/pyversions/PyStormTracker)](https://pypi.org/project/PyStormTracker/)
@@ -65,16 +66,18 @@ Description-Content-Type: text/markdown
65
66
  [![GHCR](https://img.shields.io/badge/ghcr.io-xddd%2Fpystormtracker-blue?logo=github)](https://github.com/orgs/xddd/packages/container/package/pystormtracker)
66
67
  [![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.18764813-blue.svg)](https://doi.org/10.5281/zenodo.18764813)
67
68
 
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.
69
+ <!-- docs-start -->
70
+
71
+ **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
72
 
70
73
  ## Features
71
74
 
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.
75
+ - Simple tracking with nearest-neighbor linking; Hodges and HEALPix tracking with adaptive constraints and Modified Greedy Exchange.
76
+ - NetCDF, GRIB, and Zarr input on regular, Gaussian, reduced-Gaussian, projected, and HEALPix grids; TrackJSON, TRACK tdump, and IMILAST track formats.
77
+ - Spectral preprocessing, feature refinement, track comparison, variable sampling, and storm track metrics.
78
+ - Serial, Dask, and MPI execution with Numba-accelerated numerical kernels and array-backed track storage.
76
79
 
77
- ## Quick start
80
+ ## Usage
78
81
 
79
82
  PyStormTracker requires **Python 3.12+**.
80
83
 
@@ -104,7 +107,7 @@ See the [Quickstart](docs/quickstart.md) for installation options, CLI and Pytho
104
107
 
105
108
  [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
109
 
107
- ## Citations
110
+ ## References
108
111
 
109
112
  If you use PyStormTracker in research, please cite the software:
110
113
 
@@ -114,21 +117,24 @@ PyStormTracker was originally presented as:
114
117
 
115
118
  - **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
119
 
117
- For methods used by the Simple tracker and storm-track analysis:
120
+ For `SimpleTracker` and storm track metrics:
118
121
 
119
122
  - **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
123
 
121
- For the feature-identification and trajectory-linking methods implemented by `HodgesTracker`:
124
+ For the methods implemented by `HodgesTracker`:
122
125
 
123
126
  - **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
127
  - **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
128
  - **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
129
 
127
- PyStormTracker uses `ducc0` for spherical-harmonic transforms and related spherical numerical operations:
130
+ 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:
131
+
132
+ - **Yau, A. M. W.**, 2026: *spharmgrid*. Zenodo,
133
+ [doi:10.5281/zenodo.22559210](https://doi.org/10.5281/zenodo.22559210).
128
134
 
129
135
  - **Reinecke, M.**, 2020: DUCC: Distinctly Useful Code Collection. *Astrophysics Source Code Library*, record [ascl:2008.023](https://ascl.net/2008.023).
130
136
 
131
- For the IMILAST cyclone-tracking intercomparison:
137
+ For the IMILAST intercomparison:
132
138
 
133
139
  - **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
140
 
@@ -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
+ }