PyStormTracker 0.4.0__tar.gz → 0.4.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.
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/CITATION.cff +2 -2
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/PKG-INFO +6 -8
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/README.md +5 -5
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/ROADMAP.md +4 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/pyproject.toml +3 -6
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/__init__.py +1 -1
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/tests/conftest.py +8 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/uv.lock +251 -235
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/.dockerignore +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/.github/dependabot.yml +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/.github/workflows/ci.yml +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/.github/workflows/docker-publish.yml +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/.github/workflows/python-publish.yml +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/.gitignore +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/.python-version +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/.readthedocs.yaml +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/ARCHITECTURE.md +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/Dockerfile +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/LICENSE +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/codecov.yml +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/data/test/tracks/era5_msl_2.5x2.5_v0.0.2_imilast.txt +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/data/test/tracks/era5_vo_2.5x2.5_1e-4_v0.0.2_imilast.txt +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/docs/IntercomparisonProtocol.pdf +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/docs/architecture.md +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/docs/benchmark.md +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/docs/conf.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/docs/index.md +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/docs/readme.md +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/docs/roadmap.md +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/cli.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/hodges/__init__.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/hodges/tracker.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/io/__init__.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/io/imilast.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/io/loader.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/models/__init__.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/models/center.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/models/tracker.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/models/tracks.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/simple/__init__.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/simple/concurrent.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/simple/detector.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/simple/kernels.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/simple/linker.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/simple/tracker.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/utils/__init__.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/utils/benchmark.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/src/pystormtracker/utils/data_utils.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/tests/__init__.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/tests/test_center.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/tests/test_cli.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/tests/test_integration.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/tests/test_simple_detector.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/tests/test_simple_linker.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/tests/test_simple_tracker.py +0 -0
- {pystormtracker-0.4.0 → pystormtracker-0.4.1}/tests/test_tracks.py +0 -0
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
cff-version: 1.2.0
|
|
2
|
-
title: mwyau/PyStormTracker
|
|
2
|
+
title: "mwyau/PyStormTracker: v0.4.1"
|
|
3
3
|
message: "If you use this software, please cite it as below."
|
|
4
4
|
type: software
|
|
5
5
|
authors:
|
|
@@ -19,7 +19,7 @@ keywords:
|
|
|
19
19
|
- dask
|
|
20
20
|
- mpi
|
|
21
21
|
license: BSD-3-Clause
|
|
22
|
-
version: 0.4.
|
|
22
|
+
version: 0.4.1
|
|
23
23
|
date-released: '2026-03-10'
|
|
24
24
|
preferred-citation:
|
|
25
25
|
type: article
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: PyStormTracker
|
|
3
|
-
Version: 0.4.
|
|
3
|
+
Version: 0.4.1
|
|
4
4
|
Summary: A High-Performance Cyclone Tracker in Python
|
|
5
5
|
Project-URL: Homepage, https://pypi.org/project/PyStormTracker/
|
|
6
6
|
Project-URL: Repository, https://github.com/mwyau/PyStormTracker.git
|
|
@@ -22,10 +22,8 @@ Requires-Dist: dask>=2024.1.0
|
|
|
22
22
|
Requires-Dist: distributed>=2024.1.0
|
|
23
23
|
Requires-Dist: h5netcdf>=1.0.0
|
|
24
24
|
Requires-Dist: h5py>=3.8.0
|
|
25
|
-
Requires-Dist: matplotlib>=3.10.8
|
|
26
25
|
Requires-Dist: numba>=0.60.0
|
|
27
26
|
Requires-Dist: numpy>=1.24.0
|
|
28
|
-
Requires-Dist: pandas>=3.0.1
|
|
29
27
|
Requires-Dist: xarray>=2024.9.0
|
|
30
28
|
Provides-Extra: all
|
|
31
29
|
Requires-Dist: cfgrib>=0.9.15.1; extra == 'all'
|
|
@@ -59,9 +57,9 @@ Description-Content-Type: text/markdown
|
|
|
59
57
|
[](https://github.com/orgs/xddd/packages/container/package/pystormtracker)
|
|
60
58
|
[](https://doi.org/10.5281/zenodo.18764813)
|
|
61
59
|
|
|
62
|
-
**PyStormTracker** is a high-performance Python package for cyclone trajectory analysis. It implements the "Simple Tracker" algorithm and provides a scalable framework for processing large-scale climate datasets like ERA5.
|
|
60
|
+
**PyStormTracker** is a high-performance Python package for cyclone trajectory analysis. It implements the "Simple Tracker" algorithm described in **Yau and Chang (2020)** and provides a scalable framework for processing large-scale climate datasets like ERA5.
|
|
63
61
|
|
|
64
|
-
The project is currently being expanded to include a Python port of the adaptive constraints tracking algorithm from **Hodges (1999)** and Accumulated Track Activity metrics.
|
|
62
|
+
The project is currently being expanded to include a Python port of the adaptive constraints tracking algorithm from **Hodges (1999)** (originally in C) and the Accumulated Track Activity metrics from **Yau and Chang (2020)** (originally in Matlab).
|
|
65
63
|
|
|
66
64
|
Initially developed at the **National Center for Atmospheric Research (NCAR)** as part of the **2015 SIParCS** program, PyStormTracker leverages task-parallel strategies and tree reduction algorithms to efficiently process large-scale climate datasets.
|
|
67
65
|
|
|
@@ -78,7 +76,7 @@ Initially developed at the **National Center for Atmospheric Research (NCAR)** a
|
|
|
78
76
|
- **Interoperable**: Full support for the standard **IMILAST** intercomparison format (`.txt`) with human-readable datetime strings.
|
|
79
77
|
|
|
80
78
|
<p align="center">
|
|
81
|
-
<img src="benchmark/benchmark_0_25x0_25_breakdown.png" width="600" alt="v0.4.0 Performance Improvements">
|
|
79
|
+
<img src="https://raw.githubusercontent.com/mwyau/PyStormTracker/main/benchmark/benchmark_0_25x0_25_breakdown.png" width="600" alt="v0.4.0 Performance Improvements">
|
|
82
80
|
<br>
|
|
83
81
|
<i>Significant performance gains in v0.4.0+ compared to the legacy v0.3.3 architecture on high-resolution ERA5 data.</i>
|
|
84
82
|
</p>
|
|
@@ -244,8 +242,8 @@ If you use this software in your research, please cite the following:
|
|
|
244
242
|
- **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*, [https://doi.org/10.5281/zenodo.18868625](https://doi.org/10.5281/zenodo.18868625).
|
|
245
243
|
|
|
246
244
|
- **Neu, U., et al.**, 2013: IMILAST: A Community Effort to Intercompare Extratropical Cyclone Detection and Tracking Algorithms. *Bull. Amer. Meteor. Soc.*, **94**, 529–547, [https://doi.org/10.1175/BAMS-D-11-00154.1](https://doi.org/10.1175/BAMS-D-11-00154.1).
|
|
247
|
-
-
|
|
248
|
-
-
|
|
245
|
+
- IMILAST Intercomparison Protocol: [https://proclim.scnat.ch/en/activities/project_imilast/intercomparison](https://proclim.scnat.ch/en/activities/project_imilast/intercomparison)
|
|
246
|
+
- IMILAST Data Download: [https://proclim.scnat.ch/en/activities/project_imilast/data_download](https://proclim.scnat.ch/en/activities/project_imilast/data_download)
|
|
249
247
|
|
|
250
248
|
- **Hodges, K. I.**, 1999: Adaptive Constraints for Feature Tracking. *Mon. Wea. Rev.*, **127**, 1362–1373, [https://doi.org/10.1175/1520-0493(1999)127<1362:ACFFT>2.0.CO;2](https://doi.org/10.1175/1520-0493(1999)127<1362:ACFFT>2.0.CO;2).
|
|
251
249
|
|
|
@@ -10,9 +10,9 @@
|
|
|
10
10
|
[](https://github.com/orgs/xddd/packages/container/package/pystormtracker)
|
|
11
11
|
[](https://doi.org/10.5281/zenodo.18764813)
|
|
12
12
|
|
|
13
|
-
**PyStormTracker** is a high-performance Python package for cyclone trajectory analysis. It implements the "Simple Tracker" algorithm and provides a scalable framework for processing large-scale climate datasets like ERA5.
|
|
13
|
+
**PyStormTracker** is a high-performance Python package for cyclone trajectory analysis. It implements the "Simple Tracker" algorithm described in **Yau and Chang (2020)** and provides a scalable framework for processing large-scale climate datasets like ERA5.
|
|
14
14
|
|
|
15
|
-
The project is currently being expanded to include a Python port of the adaptive constraints tracking algorithm from **Hodges (1999)** and Accumulated Track Activity metrics.
|
|
15
|
+
The project is currently being expanded to include a Python port of the adaptive constraints tracking algorithm from **Hodges (1999)** (originally in C) and the Accumulated Track Activity metrics from **Yau and Chang (2020)** (originally in Matlab).
|
|
16
16
|
|
|
17
17
|
Initially developed at the **National Center for Atmospheric Research (NCAR)** as part of the **2015 SIParCS** program, PyStormTracker leverages task-parallel strategies and tree reduction algorithms to efficiently process large-scale climate datasets.
|
|
18
18
|
|
|
@@ -29,7 +29,7 @@ Initially developed at the **National Center for Atmospheric Research (NCAR)** a
|
|
|
29
29
|
- **Interoperable**: Full support for the standard **IMILAST** intercomparison format (`.txt`) with human-readable datetime strings.
|
|
30
30
|
|
|
31
31
|
<p align="center">
|
|
32
|
-
<img src="benchmark/benchmark_0_25x0_25_breakdown.png" width="600" alt="v0.4.0 Performance Improvements">
|
|
32
|
+
<img src="https://raw.githubusercontent.com/mwyau/PyStormTracker/main/benchmark/benchmark_0_25x0_25_breakdown.png" width="600" alt="v0.4.0 Performance Improvements">
|
|
33
33
|
<br>
|
|
34
34
|
<i>Significant performance gains in v0.4.0+ compared to the legacy v0.3.3 architecture on high-resolution ERA5 data.</i>
|
|
35
35
|
</p>
|
|
@@ -195,8 +195,8 @@ If you use this software in your research, please cite the following:
|
|
|
195
195
|
- **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*, [https://doi.org/10.5281/zenodo.18868625](https://doi.org/10.5281/zenodo.18868625).
|
|
196
196
|
|
|
197
197
|
- **Neu, U., et al.**, 2013: IMILAST: A Community Effort to Intercompare Extratropical Cyclone Detection and Tracking Algorithms. *Bull. Amer. Meteor. Soc.*, **94**, 529–547, [https://doi.org/10.1175/BAMS-D-11-00154.1](https://doi.org/10.1175/BAMS-D-11-00154.1).
|
|
198
|
-
-
|
|
199
|
-
-
|
|
198
|
+
- IMILAST Intercomparison Protocol: [https://proclim.scnat.ch/en/activities/project_imilast/intercomparison](https://proclim.scnat.ch/en/activities/project_imilast/intercomparison)
|
|
199
|
+
- IMILAST Data Download: [https://proclim.scnat.ch/en/activities/project_imilast/data_download](https://proclim.scnat.ch/en/activities/project_imilast/data_download)
|
|
200
200
|
|
|
201
201
|
- **Hodges, K. I.**, 1999: Adaptive Constraints for Feature Tracking. *Mon. Wea. Rev.*, **127**, 1362–1373, [https://doi.org/10.1175/1520-0493(1999)127<1362:ACFFT>2.0.CO;2](https://doi.org/10.1175/1520-0493(1999)127<1362:ACFFT>2.0.CO;2).
|
|
202
202
|
|
|
@@ -39,3 +39,7 @@ This document outlines the strategic plan for improving PyStormTracker's perform
|
|
|
39
39
|
* **Complete `HodgesTracker`:**
|
|
40
40
|
* *Current State:* Scaffolding added.
|
|
41
41
|
* *Action:* Integrate spherical distance math (e.g., `haversine` or Numba-compiled Vincenty formula). For track optimization (cost function minimization), port the original C logic using `scipy.optimize.linear_sum_assignment` which perfectly maps to the tracking assignment problem.
|
|
42
|
+
* **Preprocessing (Spherical Harmonics Filtering):**
|
|
43
|
+
* *Action:* Add support for spectral filtering (e.g., T42/T63 truncation) using `pyshtools` to remove small-scale noise from high-resolution fields before tracking.
|
|
44
|
+
* **Postprocessing (Track Metrics):**
|
|
45
|
+
* *Action:* Implement Accumulated Track Activity (ATA) and other storm track metrics from **Yau and Chang (2020)** to provide physically meaningful analysis of detected trajectories.
|
|
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "PyStormTracker"
|
|
7
|
-
version = "0.4.
|
|
7
|
+
version = "0.4.1"
|
|
8
8
|
description = "A High-Performance Cyclone Tracker in Python"
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
license = {text = "BSD-3-Clause"}
|
|
@@ -31,8 +31,6 @@ dependencies = [
|
|
|
31
31
|
"numpy>=1.24.0",
|
|
32
32
|
"numba>=0.60.0",
|
|
33
33
|
"xarray>=2024.9.0",
|
|
34
|
-
"matplotlib>=3.10.8",
|
|
35
|
-
"pandas>=3.0.1",
|
|
36
34
|
]
|
|
37
35
|
|
|
38
36
|
[project.scripts]
|
|
@@ -84,6 +82,8 @@ dev = [
|
|
|
84
82
|
"pytest>=9.0.2",
|
|
85
83
|
"pytest-cov>=7.0.0",
|
|
86
84
|
"ruff>=0.15.5",
|
|
85
|
+
"matplotlib>=3.10.8",
|
|
86
|
+
"pandas>=3.0.1",
|
|
87
87
|
]
|
|
88
88
|
|
|
89
89
|
[tool.ruff]
|
|
@@ -122,9 +122,6 @@ addopts = "-ra -q --durations=0"
|
|
|
122
122
|
testpaths = [
|
|
123
123
|
"tests",
|
|
124
124
|
]
|
|
125
|
-
markers = [
|
|
126
|
-
"integration: marks tests as integration (skipped by default, run with --run-integration)",
|
|
127
|
-
]
|
|
128
125
|
filterwarnings = [
|
|
129
126
|
"ignore:numpy.ndarray size changed:RuntimeWarning",
|
|
130
127
|
]
|
|
@@ -15,6 +15,14 @@ def pytest_addoption(parser: pytest.Parser) -> None:
|
|
|
15
15
|
)
|
|
16
16
|
|
|
17
17
|
|
|
18
|
+
def pytest_configure(config: pytest.Config) -> None:
|
|
19
|
+
config.addinivalue_line(
|
|
20
|
+
"markers",
|
|
21
|
+
"integration: marks tests as integration "
|
|
22
|
+
"(skipped by default, run with --run-integration)",
|
|
23
|
+
)
|
|
24
|
+
|
|
25
|
+
|
|
18
26
|
def pytest_collection_modifyitems(
|
|
19
27
|
config: pytest.Config, items: list[pytest.Item]
|
|
20
28
|
) -> None:
|