PyPI - PyStormTracker - Versions diffs - 0.3.0__tar.gz → 0.3.1__tar.gz - Mend

PyStormTracker 0.3.0tar.gz → 0.3.1tar.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 (42) hide show

{pystormtracker-0.3.0 → pystormtracker-0.3.1}/.github/workflows/ci.yml RENAMED Viewed

@@ -2,10 +2,12 @@ name: CI
 on:
   push:
-    branches: [main, dev]
+    branches:
+      - main
+      - dev
   pull_request:
-    branches: [main, dev]
-    types: [opened, synchronize, reopened]
+    branches:
+      - dev
   workflow_dispatch:
 permissions:
@@ -27,47 +29,42 @@ jobs:
     if: github.event_name == 'push' || github.event.pull_request.head.ref != 'dev'
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.11"
-          cache: "pip"
-      - name: Install dependencies
-        run: pip install ruff
+          enable-cache: true
       - name: Lint with Ruff
-        run: ruff check .
+        run: uv run ruff check .
   ruff-format:
     runs-on: ubuntu-latest
     if: github.event_name == 'push' || github.event.pull_request.head.ref != 'dev'
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.11"
-          cache: "pip"
-      - name: Install dependencies
-        run: pip install ruff
+          enable-cache: true
       - name: Check formatting with Ruff
-        run: ruff format --check .
+        run: uv run ruff format --check .
   mypy-typecheck:
     runs-on: ubuntu-latest
     if: github.event_name == 'push' || github.event.pull_request.head.ref != 'dev'
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.11"
-          cache: "pip"
-      - name: Install dependencies
+          enable-cache: true
+      - name: Install system dependencies
         run: |
-          python -m pip install --upgrade pip
-          pip install .[dev]
+          sudo apt-get update
+          sudo apt-get install -y libeccodes-dev
+      - name: Install dependencies
+        run: uv sync --group dev
       - name: Type check with Mypy
-        run: mypy src/ tests/
+        run: uv run mypy src/ tests/
   unit-tests:
     name: unit-tests (Python ${{ matrix.python-version }})
@@ -78,22 +75,20 @@ jobs:
         python-version: ${{ fromJSON(needs.prepare.outputs.python-versions) }}
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
         with:
+          enable-cache: true
           python-version: ${{ matrix.python-version }}
-          cache: "pip"
-      - name: Install dependencies
+      - name: Install system dependencies
         run: |
-          python -m pip install --upgrade pip
-          pip install .[dev]
+          sudo apt-get update
+          sudo apt-get install -y libeccodes-dev
+      - name: Install dependencies
+        run: uv sync --group dev
       - name: Run Unit Tests
         run: |
-          pytest -vv
-      - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v5
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
+          uv run pytest -vv
   integration-tests:
     name: integration-tests (Python ${{ matrix.python-version }})
@@ -104,22 +99,20 @@ jobs:
         python-version: ${{ fromJSON(needs.prepare.outputs.python-versions) }}
     steps:
       - uses: actions/checkout@v4
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
         with:
+          enable-cache: true
           python-version: ${{ matrix.python-version }}
-          cache: "pip"
-      - name: Install MPI
+      - name: Install system dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y openmpi-bin libopenmpi-dev
+          sudo apt-get install -y openmpi-bin libopenmpi-dev libeccodes-dev
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install .[dev]
+        run: uv sync --group dev
       - name: Run Integration Tests
         run: |
-          pytest -vv tests/test_integration.py --run-all
+          uv run pytest -vv tests/test_integration.py --run-integration
       - name: Upload coverage reports to Codecov
         uses: codecov/codecov-action@v5
         with:

pystormtracker-0.3.1/.github/workflows/docker-publish.yml ADDED Viewed

@@ -0,0 +1,88 @@
+name: Docker Publish
+on:
+  workflow_run:
+    workflows: ["CI"]
+    branches: [dev]
+    types: [completed]
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: 'The branch to build from'
+        required: true
+        type: choice
+        options:
+        - main
+        - dev
+        default: 'main'
+env:
+  DOCKER_HUB_REPO: xddd/pystormtracker
+  GHCR_REPO: ghcr.io/xddd/pystormtracker
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    if: |
+      (github.event_name == 'workflow_run' && github.event.workflow_run.conclusion == 'success') ||
+      github.event_name == 'release' ||
+      github.event_name == 'workflow_dispatch'
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          # Checkout the branch on manual trigger, the commit on workflow_run, or the tag on release
+          ref: ${{ github.event.inputs.branch || github.event.workflow_run.head_sha }}
+          fetch-depth: 0 # Fetches all history for all tags. Needed for semver.
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v4
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v4
+        with:
+          username: ${{ vars.DOCKER_HUB_USERNAME }}
+          password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
+      - name: Log in to GHCR
+        uses: docker/login-action@v4
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GHCR_PAT }}
+      - name: Extract Docker metadata
+        id: meta
+        uses: docker/metadata-action@v6
+        with:
+          images: |
+            ${{ env.DOCKER_HUB_REPO }}
+            ${{ env.GHCR_REPO }}
+          tags: |
+            # Tag all builds with the short commit hash
+            type=sha,format=short
+            # 'dev' tag for CI runs on dev branch or manual builds of dev
+            type=raw,value=dev,enable=${{ (github.event_name == 'workflow_run' && github.event.workflow_run.head_branch == 'dev') || (github.event_name == 'workflow_dispatch' && github.event.inputs.branch == 'dev') }}
+            # 'latest' and semantic version tags for releases
+            type=raw,value=latest,enable=${{ github.event_name == 'release' }}
+            type=match,pattern=v(.*),group=1,enable=${{ github.event_name == 'release' }}
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          push: true
+          provenance: false
+          platforms: linux/amd64,linux/arm64
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

{pystormtracker-0.3.0 → pystormtracker-0.3.1}/.github/workflows/python-publish.yml RENAMED Viewed

@@ -17,14 +17,13 @@ jobs:
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.x"
+          enable-cache: true
       - name: Build release distributions
-        run: |
-          python -m pip install build
-          python -m build
+        run: uv build
       - name: Upload distributions
         uses: actions/upload-artifact@v7

{pystormtracker-0.3.0 → pystormtracker-0.3.1}/.pre-commit-config.yaml RENAMED Viewed

@@ -1,3 +1,4 @@
+default_stages: [pre-commit, pre-push]
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v5.0.0
@@ -19,4 +20,4 @@ repos:
     rev: v1.15.0
     hooks:
       - id: mypy
-        additional_dependencies: [numpy, pooch, scipy, pytest, pandas, xarray, dask, distributed, h5netcdf]
+        additional_dependencies: [numpy, pooch, scipy, pytest, xarray, dask, distributed, h5netcdf]

{pystormtracker-0.3.0 → pystormtracker-0.3.1}/.readthedocs.yaml RENAMED Viewed

@@ -1,4 +1,4 @@
-# Read the Docs configuration file
+# Read the Docs configuration file for Sphinx projects
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 version: 2
@@ -6,14 +6,17 @@ version: 2
 build:
   os: ubuntu-24.04
   tools:
-    python: "3.14"
+    python: "3.11"
 python:
   install:
     - method: pip
       path: .
       extra_requirements:
-        - dev
+        - docs
 sphinx:
   configuration: docs/conf.py
+formats:
+  - pdf

{pystormtracker-0.3.0 → pystormtracker-0.3.1}/CITATION.cff RENAMED Viewed

@@ -11,7 +11,7 @@ identifiers:
   - type: doi
     value: 10.5281/zenodo.18764813
 repository-code: 'https://github.com/mwyau/PyStormTracker'
-url: 'https://github.com/mwyau/PyStormTracker'
+url: 'https://pystormtracker.readthedocs.io/'
 abstract: A Parallel Object-Oriented Cyclone Tracker in Python
 keywords:
   - cyclone tracking
@@ -19,7 +19,7 @@ keywords:
   - dask
   - mpi
 license: BSD-3-Clause
-version: 0.3.0
+version: 0.3.1
 date-released: '2026-03-08'
 preferred-citation:
   type: article

{pystormtracker-0.3.0 → pystormtracker-0.3.1}/Dockerfile RENAMED Viewed

@@ -14,11 +14,14 @@ WORKDIR /app
 # Create data directory for mounting
 RUN mkdir /data && chmod 777 /data
+# Install uv
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 # Copy the project files
 COPY . .
-# Install the package and its dependencies
-RUN pip install --no-cache-dir .
+# Install the package and its dependencies using uv
+RUN uv pip install --system --no-cache .
 # Add a non-root user for security
 RUN useradd -m pst

pystormtracker-0.3.1/LICENSE ADDED Viewed

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+Copyright (c) 2015, University Corporation for Atmospheric Research (UCAR)
+Copyright (c) 2026, Albert M. W. Yau
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

{pystormtracker-0.3.0 → pystormtracker-0.3.1}/PKG-INFO RENAMED Viewed

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: PyStormTracker
-Version: 0.3.0
+Version: 0.3.1
 Summary: A Parallel Object-Oriented Cyclone Tracker in Python
-Project-URL: Homepage, https://github.com/mwyau/PyStormTracker
+Project-URL: Homepage, https://pystormtracker.readthedocs.io/
 Project-URL: Repository, https://github.com/mwyau/PyStormTracker.git
 Project-URL: Issues, https://github.com/mwyau/PyStormTracker/issues
 Author-email: "Albert M. W. Yau" <albert@mwyau.com>
-Maintainer-email: "Albert M. W. Yau" <albert@mwyau.com>
 License: BSD-3-Clause
 License-File: LICENSE
 Classifier: Development Status :: 4 - Beta
@@ -19,20 +18,21 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
 Requires-Python: >=3.11
+Requires-Dist: dask>=2024.0.0
+Requires-Dist: distributed>=2024.0.0
+Requires-Dist: h5netcdf>=1.0.0
+Requires-Dist: h5py>=3.0.0
 Requires-Dist: numpy>=1.23.0
 Requires-Dist: scipy>=1.9.0
-Requires-Dist: xarray[accel,io,parallel]>=2024.9.0
-Provides-Extra: dev
-Requires-Dist: mpi4py>=4.0.0; extra == 'dev'
-Requires-Dist: mypy>=1.15.0; extra == 'dev'
-Requires-Dist: myst-parser>=2.0.0; extra == 'dev'
-Requires-Dist: pandas>=2.2.0; extra == 'dev'
-Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
-Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
-Requires-Dist: pytest>=8.1.1; extra == 'dev'
-Requires-Dist: ruff>=0.9.0; extra == 'dev'
-Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == 'dev'
-Requires-Dist: sphinx>=7.2.0; extra == 'dev'
+Requires-Dist: xarray>=2024.9.0
+Provides-Extra: docs
+Requires-Dist: myst-parser>=2.0.0; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == 'docs'
+Requires-Dist: sphinx>=7.2.0; extra == 'docs'
+Provides-Extra: grib
+Requires-Dist: cfgrib>=0.9.15; extra == 'grib'
+Provides-Extra: mpi
+Requires-Dist: mpi4py>=4.0.0; extra == 'mpi'
 Description-Content-Type: text/markdown
 # PyStormTracker
@@ -47,7 +47,9 @@ Description-Content-Type: text/markdown
 [![GHCR](https://img.shields.io/badge/ghcr.io-xddd%2Fpystormtracker-blue?logo=github)](https://github.com/orgs/xddd/packages/container/package/pystormtracker)
 [![DOI](https://zenodo.org/badge/36328800.svg)](https://doi.org/10.5281/zenodo.18764813)
-PyStormTracker provides the implementation of the "Simple Tracker" algorithm used for cyclone trajectory analysis in **Yau and Chang (2020)**. It was originally developed at the **National Center for Atmospheric Research (NCAR)** as part of the **2015 Summer Internships in Parallel Computational Science (SIParCS)** program, utilizing a task-parallel strategy with temporal decomposition and a tree reduction algorithm to process large climate datasets.
+PyStormTracker implements the "Simple Tracker" algorithm for cyclone trajectory analysis in **Yau and Chang (2020)**. Work is currently in progress to port the adaptive constraints tracking algorithm in **Hodges (1999)** from C to Python, and the Accumulated Track Activity metrics in **Yau and Chang (2020)** from Matlab to Python.
+Originally developed at the **National Center for Atmospheric Research (NCAR)** during the **2015 SIParCS** program, this package utilizes task-parallel strategies and tree reduction algorithms to efficiently process large climate datasets.
 ## Features
@@ -82,23 +84,27 @@ Full documentation, including API references and advanced usage examples, is ava
 ### From PyPI (Recommended)
 You can install the latest stable version of PyStormTracker directly from PyPI:
+For use as a CLI tool:
+```bash
+uv tool install PyStormTracker
+```
+For use as a library in your project:
 ```bash
-pip install PyStormTracker
+uv add PyStormTracker
 ```
 ### From Source
-1. Clone the repository:
+2. Install with **uv** (Recommended):
    ```bash
    git clone https://github.com/mwyau/PyStormTracker.git
    cd PyStormTracker
-   ```
-2. Install with **uv** (Recommended):
-   ```bash
-   uv sync --extra dev
+   uv sync --group dev
    uv run pre-commit install --hook-type pre-push
    ```
 ## Usage
 Once installed, you can use the `stormtracker` command directly:
@@ -125,7 +131,7 @@ stormtracker -i era5_msl_2.5x2.5.nc -v msl -o my_tracks
 Using **uv** is the recommended way to set up your environment:
 ```bash
 # Install dependencies and sync virtual environment
-uv sync --extra dev
+uv sync --group dev
 # Install pre-push hooks
 uv run pre-commit install --hook-type pre-push
@@ -147,8 +153,8 @@ uv run mypy src/
 ### Tiered Testing
 To keep development cycles fast, testing is tiered:
-- **Fast Tests**: Default local runs (skips slow tests).
-- **Slow Tests**: ONLY long-running integration/regression tests.
+- **Fast Tests**: Default local runs (skips integration tests).
+- **Integration Tests**: ONLY long-running integration/regression tests.
 - **Full Suite**: Everything (used in CI).
 **Run fast unit tests only (Default):**
@@ -156,11 +162,12 @@ To keep development cycles fast, testing is tiered:
 uv run pytest
 ```
-**Run ONLY slow/integration tests:**
+**Run ONLY integration tests:**
 ```bash
-uv run pytest --run-slow
+uv run pytest --run-integration
 ```
 **Run everything:**
 ```bash
 uv run pytest --run-all
@@ -170,17 +177,21 @@ uv run pytest --run-all
 If you use this software in your research, please cite the following:
-- **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, https://doi.org/10.1175/JCLI-D-20-0393.1.
 - **Yau, A. M. W.**, 2026: mwyau/PyStormTracker. *Zenodo*, https://doi.org/10.5281/zenodo.18764813.
+- **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, https://doi.org/10.1175/JCLI-D-20-0393.1.
 ## References
  - **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.
  - **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.
- - **IMILAST Intercomparison Protocol**: https://proclim.scnat.ch/en/activities/project_imilast/intercomparison
- - **IMILAST Data Download**: https://proclim.scnat.ch/en/activities/project_imilast/data_download
+   - **IMILAST Intercomparison Protocol**: https://proclim.scnat.ch/en/activities/project_imilast/intercomparison
+   - **IMILAST Data Download**: https://proclim.scnat.ch/en/activities/project_imilast/data_download
+- **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).
 ## License
-This project is licensed under the terms found in the `LICENSE` file.
+This project is licensed under the BSD-3-Clause terms found in the `LICENSE` file.

{pystormtracker-0.3.0 → pystormtracker-0.3.1}/README.md RENAMED Viewed

@@ -10,7 +10,9 @@
 [![GHCR](https://img.shields.io/badge/ghcr.io-xddd%2Fpystormtracker-blue?logo=github)](https://github.com/orgs/xddd/packages/container/package/pystormtracker)
 [![DOI](https://zenodo.org/badge/36328800.svg)](https://doi.org/10.5281/zenodo.18764813)
-PyStormTracker provides the implementation of the "Simple Tracker" algorithm used for cyclone trajectory analysis in **Yau and Chang (2020)**. It was originally developed at the **National Center for Atmospheric Research (NCAR)** as part of the **2015 Summer Internships in Parallel Computational Science (SIParCS)** program, utilizing a task-parallel strategy with temporal decomposition and a tree reduction algorithm to process large climate datasets.
+PyStormTracker implements the "Simple Tracker" algorithm for cyclone trajectory analysis in **Yau and Chang (2020)**. Work is currently in progress to port the adaptive constraints tracking algorithm in **Hodges (1999)** from C to Python, and the Accumulated Track Activity metrics in **Yau and Chang (2020)** from Matlab to Python.
+Originally developed at the **National Center for Atmospheric Research (NCAR)** during the **2015 SIParCS** program, this package utilizes task-parallel strategies and tree reduction algorithms to efficiently process large climate datasets.
 ## Features
@@ -45,23 +47,27 @@ Full documentation, including API references and advanced usage examples, is ava
 ### From PyPI (Recommended)
 You can install the latest stable version of PyStormTracker directly from PyPI:
+For use as a CLI tool:
+```bash
+uv tool install PyStormTracker
+```
+For use as a library in your project:
 ```bash
-pip install PyStormTracker
+uv add PyStormTracker
 ```
 ### From Source
-1. Clone the repository:
+2. Install with **uv** (Recommended):
    ```bash
    git clone https://github.com/mwyau/PyStormTracker.git
    cd PyStormTracker
-   ```
-2. Install with **uv** (Recommended):
-   ```bash
-   uv sync --extra dev
+   uv sync --group dev
    uv run pre-commit install --hook-type pre-push
    ```
 ## Usage
 Once installed, you can use the `stormtracker` command directly:
@@ -88,7 +94,7 @@ stormtracker -i era5_msl_2.5x2.5.nc -v msl -o my_tracks
 Using **uv** is the recommended way to set up your environment:
 ```bash
 # Install dependencies and sync virtual environment
-uv sync --extra dev
+uv sync --group dev
 # Install pre-push hooks
 uv run pre-commit install --hook-type pre-push
@@ -110,8 +116,8 @@ uv run mypy src/
 ### Tiered Testing
 To keep development cycles fast, testing is tiered:
-- **Fast Tests**: Default local runs (skips slow tests).
-- **Slow Tests**: ONLY long-running integration/regression tests.
+- **Fast Tests**: Default local runs (skips integration tests).
+- **Integration Tests**: ONLY long-running integration/regression tests.
 - **Full Suite**: Everything (used in CI).
 **Run fast unit tests only (Default):**
@@ -119,11 +125,12 @@ To keep development cycles fast, testing is tiered:
 uv run pytest
 ```
-**Run ONLY slow/integration tests:**
+**Run ONLY integration tests:**
 ```bash
-uv run pytest --run-slow
+uv run pytest --run-integration
 ```
 **Run everything:**
 ```bash
 uv run pytest --run-all
@@ -133,17 +140,21 @@ uv run pytest --run-all
 If you use this software in your research, please cite the following:
-- **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, https://doi.org/10.1175/JCLI-D-20-0393.1.
 - **Yau, A. M. W.**, 2026: mwyau/PyStormTracker. *Zenodo*, https://doi.org/10.5281/zenodo.18764813.
+- **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, https://doi.org/10.1175/JCLI-D-20-0393.1.
 ## References
  - **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.
  - **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.
- - **IMILAST Intercomparison Protocol**: https://proclim.scnat.ch/en/activities/project_imilast/intercomparison
- - **IMILAST Data Download**: https://proclim.scnat.ch/en/activities/project_imilast/data_download
+   - **IMILAST Intercomparison Protocol**: https://proclim.scnat.ch/en/activities/project_imilast/intercomparison
+   - **IMILAST Data Download**: https://proclim.scnat.ch/en/activities/project_imilast/data_download
+- **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).
 ## License
-This project is licensed under the terms found in the `LICENSE` file.
+This project is licensed under the BSD-3-Clause terms found in the `LICENSE` file.

PyStormTracker 0.3.0__tar.gz → 0.3.1__tar.gz

PyStormTracker 0.3.0tar.gz → 0.3.1tar.gz