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.
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/dependabot.yml +8 -4
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/ci.yml +18 -14
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/docker-build.yml +5 -4
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/docker-publish.yml +1 -1
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/python-publish.yml +3 -3
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.pre-commit-config.yaml +16 -3
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.zenodo.json +1 -1
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/CITATION.cff +1 -1
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/PKG-INFO +20 -15
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/README.md +16 -12
- pystormtracker-0.8.0/docs/_static/layout.css +25 -0
- pystormtracker-0.8.0/docs/algorithms.md +9 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/api.md +7 -4
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/architecture.md +16 -7
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/changelog.md +18 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/cli.md +1 -1
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/conf.py +19 -1
- pystormtracker-0.8.0/docs/development.md +11 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/healpix.md +10 -4
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/hodges.md +37 -30
- pystormtracker-0.8.0/docs/index.md +18 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/quickstart.md +4 -1
- pystormtracker-0.8.0/docs/reference.md +10 -0
- pystormtracker-0.8.0/docs/roadmap.md +84 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/pyproject.toml +9 -4
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/__init__.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/backends.py +11 -7
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/cli.py +6 -2
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/compare.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/convert.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/healpix/__init__.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/healpix/constants.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/healpix/detector.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/healpix/tracker.py +8 -1
- pystormtracker-0.8.0/src/pystormtracker/hodges/__init__.py +7 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/constants.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/detections.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/detector.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/linker.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/mge.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/progress.py +6 -2
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/rsplice.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/segments.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/hodges/tracker.py +8 -4
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/__init__.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/data_loader.py +8 -4
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/format.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/imilast.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/track.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/io/trackjson.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/__init__.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/compare.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/cross_validation.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/eulerian.py +5 -1
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/lagrangian.py +5 -1
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/metrics/weighting.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/__init__.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/_cftime.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/center.py +5 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/geo.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/time.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/tracker.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/tracks.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/models/units.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/__init__.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/kinematics.py +166 -79
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/regrid.py +166 -60
- pystormtracker-0.8.0/src/pystormtracker/preprocessing/spectral.py +803 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/spherical_geometry.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/taper.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/tracking.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/refinement/__init__.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/refinement/bspline.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/refinement/quadratic.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/sample.py +4 -0
- pystormtracker-0.8.0/src/pystormtracker/schemas/__init__.py +5 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/schemas/generate.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/schemas/trackjson.schema.json +12 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/__init__.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/constants.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/detector.py +5 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/linker.py +5 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/tracker.py +8 -1
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/track.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/utils/cli.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/utils/docs.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/utils/logging.py +6 -2
- pystormtracker-0.8.0/tests/__init__.py +3 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/conftest.py +4 -0
- pystormtracker-0.8.0/tests/integration/__init__.py +3 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_cli_extra.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_hodges.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_io.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_parallel_backends.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_projection.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_reduced_gaussian.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_simple.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/integration/test_trackjson.py +4 -0
- pystormtracker-0.8.0/tests/parity/__init__.py +3 -0
- pystormtracker-0.8.0/tests/parity/legacy/__init__.py +3 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/parity/legacy/test_simple_v0_0_2_parity.py +4 -0
- pystormtracker-0.8.0/tests/parity/ncl_spherepack/__init__.py +3 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/parity/ncl_spherepack/test_spectral_ncl.py +4 -0
- pystormtracker-0.8.0/tests/unit/__init__.py +3 -0
- pystormtracker-0.8.0/tests/unit/healpix/__init__.py +3 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/healpix/test_detector.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/healpix/test_tracker.py +4 -0
- pystormtracker-0.8.0/tests/unit/hodges/__init__.py +3 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_detector.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_linker.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_mge.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_progress.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_segments.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/hodges/test_tracker.py +4 -0
- pystormtracker-0.8.0/tests/unit/io/__init__.py +3 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_data_loader.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_format.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_imilast.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_track.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/io/test_trackjson.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_cross_validation.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_eulerian.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_lagrangian.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_rsplice.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/metrics/test_weighting.py +4 -0
- pystormtracker-0.8.0/tests/unit/models/__init__.py +3 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/models/test_center.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/models/test_geo.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/models/test_tracks.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/models/test_units.py +4 -0
- pystormtracker-0.8.0/tests/unit/preprocessing/__init__.py +3 -0
- pystormtracker-0.8.0/tests/unit/preprocessing/test_kinematics.py +447 -0
- pystormtracker-0.8.0/tests/unit/preprocessing/test_regrid.py +396 -0
- pystormtracker-0.8.0/tests/unit/preprocessing/test_spectral.py +542 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/refinement/test_bspline.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/refinement/test_quadratic.py +4 -0
- pystormtracker-0.8.0/tests/unit/simple/__init__.py +3 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/simple/test_detector.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/simple/test_linker.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/simple/test_tracker.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_api.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_backends.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_cli.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_compare.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_convert.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_observability.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_preprocessing.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_sample.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_time.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_track_cli.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/unit/test_utils.py +4 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/utils.py +4 -0
- pystormtracker-0.8.0/uv.lock +4996 -0
- pystormtracker-0.7.0/docs/index.md +0 -35
- pystormtracker-0.7.0/docs/readme.md +0 -4
- pystormtracker-0.7.0/docs/roadmap.md +0 -338
- pystormtracker-0.7.0/src/pystormtracker/hodges/__init__.py +0 -3
- pystormtracker-0.7.0/src/pystormtracker/preprocessing/spectral.py +0 -754
- pystormtracker-0.7.0/src/pystormtracker/schemas/__init__.py +0 -1
- pystormtracker-0.7.0/tests/__init__.py +0 -0
- pystormtracker-0.7.0/tests/integration/__init__.py +0 -0
- pystormtracker-0.7.0/tests/parity/__init__.py +0 -0
- pystormtracker-0.7.0/tests/parity/legacy/__init__.py +0 -0
- pystormtracker-0.7.0/tests/parity/ncl_spherepack/__init__.py +0 -0
- pystormtracker-0.7.0/tests/unit/__init__.py +0 -0
- pystormtracker-0.7.0/tests/unit/healpix/__init__.py +0 -0
- pystormtracker-0.7.0/tests/unit/hodges/__init__.py +0 -0
- pystormtracker-0.7.0/tests/unit/io/__init__.py +0 -0
- pystormtracker-0.7.0/tests/unit/models/__init__.py +0 -0
- pystormtracker-0.7.0/tests/unit/preprocessing/__init__.py +0 -0
- pystormtracker-0.7.0/tests/unit/preprocessing/test_kinematics.py +0 -137
- pystormtracker-0.7.0/tests/unit/preprocessing/test_regrid.py +0 -205
- pystormtracker-0.7.0/tests/unit/preprocessing/test_spectral.py +0 -217
- pystormtracker-0.7.0/tests/unit/simple/__init__.py +0 -0
- pystormtracker-0.7.0/uv.lock +0 -4575
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.dockerignore +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.gitattributes +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/pull_request_template.md +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.github/workflows/dependency-review.yml +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.gitignore +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.python-version +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/.readthedocs.yaml +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/AGENTS.md +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/CONTRIBUTING.md +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/Dockerfile +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/LICENSE +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/codecov.yml +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/_static/IntercomparisonProtocol.pdf +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/_static/era5_msl_nh.png +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/_static/explorer.png +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/benchmark.md +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/development/testing.md +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/puppeteer-config.json +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/docs/trackjson.md +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/scripts/generate_trackjson_schema.py +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/src/pystormtracker/py.typed +0 -0
- {pystormtracker-0.7.0 → pystormtracker-0.8.0}/tests/data/era5/era5_msl_2025-12_2.5x2.5.nc +0 -0
- {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:
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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
|
|
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
|
|
184
|
+
- name: Install free-threaded dependencies
|
|
181
185
|
if: matrix.mode == 'free-threaded'
|
|
182
|
-
run: uv sync --frozen
|
|
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.
|
|
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.
|
|
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
|
|
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.
|
|
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.
|
|
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
|
|
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.
|
|
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.
|
|
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
|
|
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
|
|
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.
|
|
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.
|
|
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@
|
|
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.
|
|
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
|
|
@@ -40,7 +40,7 @@ jobs:
|
|
|
40
40
|
|
|
41
41
|
steps:
|
|
42
42
|
- name: Retrieve tested distributions
|
|
43
|
-
uses: actions/download-artifact@v8.0.
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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
|
[](https://pystormtracker.readthedocs.io/en/latest/?badge=latest)
|
|
58
59
|
[](https://codecov.io/github/mwyau/PyStormTracker)
|
|
59
60
|
[](https://pypi.org/project/PyStormTracker/)
|
|
60
|
-
[](https://test.pypi.org/project/PyStormTracker/)
|
|
61
61
|
[](https://anaconda.org/channels/conda-forge/packages/pystormtracker/overview)
|
|
62
62
|
[](https://github.com/mwyau/PyStormTracker/blob/main/LICENSE)
|
|
63
63
|
[](https://pypi.org/project/PyStormTracker/)
|
|
@@ -65,16 +65,18 @@ Description-Content-Type: text/markdown
|
|
|
65
65
|
[](https://github.com/orgs/xddd/packages/container/package/pystormtracker)
|
|
66
66
|
[](https://doi.org/10.5281/zenodo.18764813)
|
|
67
67
|
|
|
68
|
-
|
|
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
|
|
73
|
-
- NetCDF, GRIB,
|
|
74
|
-
- Spectral preprocessing, feature refinement, track comparison, variable sampling, and storm
|
|
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
|
-
##
|
|
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
|
-
##
|
|
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
|
|
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
|
|
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 `
|
|
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
|
|
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
|
[](https://pystormtracker.readthedocs.io/en/latest/?badge=latest)
|
|
5
5
|
[](https://codecov.io/github/mwyau/PyStormTracker)
|
|
6
6
|
[](https://pypi.org/project/PyStormTracker/)
|
|
7
|
-
[](https://test.pypi.org/project/PyStormTracker/)
|
|
8
7
|
[](https://anaconda.org/channels/conda-forge/packages/pystormtracker/overview)
|
|
9
8
|
[](https://github.com/mwyau/PyStormTracker/blob/main/LICENSE)
|
|
10
9
|
[](https://pypi.org/project/PyStormTracker/)
|
|
@@ -12,16 +11,18 @@
|
|
|
12
11
|
[](https://github.com/orgs/xddd/packages/container/package/pystormtracker)
|
|
13
12
|
[](https://doi.org/10.5281/zenodo.18764813)
|
|
14
13
|
|
|
15
|
-
|
|
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
|
|
20
|
-
- NetCDF, GRIB,
|
|
21
|
-
- Spectral preprocessing, feature refinement, track comparison, variable sampling, and storm
|
|
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
|
-
##
|
|
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
|
-
##
|
|
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
|
|
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
|
|
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 `
|
|
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
|
|
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
|
+
}
|
|
@@ -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
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
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
|
|
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
|
|
189
|
-
|
|
190
|
-
default
|
|
191
|
-
|
|
192
|
-
|
|
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` |
|
|
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
|
-
|
|
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
|