PyStormTracker 0.3.1__tar.gz → 0.3.3__tar.gz

pystormtracker-0.3.3/.github/workflows/ci.yml

@@ -0,0 +1,183 @@
+name: CI
+
+on:
+  pull_request:
+    paths:
+      - 'src/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - 'Dockerfile'
+  push:
+    branches:
+      - main
+      - release/**
+    tags:
+      - v*
+    paths:
+      - 'src/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - 'Dockerfile'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref_name }}
+  cancel-in-progress: ${{ github.ref_type != 'tag' }}
+
+permissions:
+  contents: read
+
+jobs:
+  ruff-lint:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.ref }}
+          fetch-depth: 0
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Lint with Ruff
+        run: uv run ruff check .
+
+  ruff-format:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.ref }}
+          fetch-depth: 0
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Check formatting with Ruff
+        run: uv run ruff format --check .
+
+  mypy-typecheck:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.ref }}
+          fetch-depth: 0
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Install system dependencies
+        run: sudo apt-get update && sudo apt-get install -y libopenmpi-dev
+      - name: Install dependencies
+        run: uv sync --frozen --group dev
+      - name: Type check with Mypy
+        run: uv run mypy src/ tests/
+
+  unit-tests:
+    name: unit-tests (Python ${{ matrix.python-version }}${{ matrix.min-deps && ', min-deps' || '' }})
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+        include:
+          - python-version: "3.11"
+            min-deps: true
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.ref }}
+          fetch-depth: 0
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+      - name: Install system dependencies
+        run: sudo apt-get update && sudo apt-get install -y libopenmpi-dev
+      - name: Install dependencies
+        if: ${{ !matrix.min-deps }}
+        run: uv sync --frozen --group dev
+      - name: Install dependencies (min-deps)
+        if: ${{ matrix.min-deps }}
+        run: uv sync --group dev --resolution lowest-direct
+      - name: Run Unit Tests
+        run: |
+          uv run pytest -vv
+
+  integration-tests:
+    name: integration-tests (Python ${{ matrix.python-version }}, ${{ matrix.arch }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - arch: amd64
+            os: ubuntu-24.04
+            python-version: "3.14"
+          - arch: arm64
+            os: ubuntu-24.04-arm
+            python-version: "3.14"
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.ref }}
+          fetch-depth: 0
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+      - name: Install system dependencies
+        run: sudo apt-get update && sudo apt-get install -y openmpi-bin libopenmpi-dev
+      - name: Install dependencies
+        run: uv sync --frozen --group dev
+      - name: Run Integration Tests
+        run: |
+          uv run pytest -vv tests/test_integration.py --run-integration
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  docker-build:
+    name: docker-build
+    needs: [integration-tests]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          ref: ${{ github.ref }}
+          fetch-depth: 0
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+
+      - name: Build and load Docker image
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          push: false
+          load: true
+          platforms: linux/amd64
+          tags: "${{ vars.DOCKER_IMAGE_NAME }}:${{ github.sha }}"
+          cache-from: type=gha,scope=docker-build
+          cache-to: type=gha,mode=max,scope=docker-build
+
+      - name: Smoke test Docker image
+        run: |
+          docker run --rm ${{ vars.DOCKER_IMAGE_NAME }}:${{ github.sha }} --help
+
+      - name: Run Trivy vulnerability scanner
+        uses: aquasecurity/trivy-action@0.35.0
+        with:
+          image-ref: "${{ vars.DOCKER_IMAGE_NAME }}:${{ github.sha }}"
+          format: "table"
+          exit-code: "0"
+          ignore-unfixed: true
+          vuln-type: "os,library"
+          severity: "CRITICAL,HIGH"

pystormtracker-0.3.3/.github/workflows/docker-publish.yml

@@ -0,0 +1,109 @@
+name: Docker Publish
+
+on:
+  push:
+    branches:
+      - main
+  release:
+    types: [published]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+env:
+  DOCKER_HUB_REPO: docker.io/${{ vars.DOCKER_IMAGE_NAME }}
+  GHCR_REPO: ghcr.io/${{ vars.DOCKER_IMAGE_NAME }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      packages: write
+      id-token: write
+      attestations: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          ref: ${{ github.ref }}
+          fetch-depth: 0
+
+      - 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: |
+            # Always tag with short SHA
+            type=sha,format=short,prefix=
+            # Tag with 'edge' only for main branch
+            type=edge,branch=main
+            # Branch tag for all branches except main
+            type=ref,event=branch,enable=${{ github.ref_name != 'main' }}
+            # Semver tags for releases (includes 'latest')
+            type=semver,pattern=latest
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}},enable=${{ !startsWith(github.ref_name, 'v0') }}
+
+      - name: Build and push Docker image
+        id: push
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          push: true
+          provenance: false
+          sbom: false
+          platforms: linux/amd64,linux/arm64
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha,scope=docker-build
+          cache-to: type=gha,mode=max,scope=docker-build
+
+      - name: Generate artifact attestation (Docker Hub)
+        uses: actions/attest-build-provenance@v4
+        with:
+          subject-name: ${{ env.DOCKER_HUB_REPO }}
+          subject-digest: ${{ steps.push.outputs.digest }}
+          push-to-registry: true
+
+      - name: Generate SBOM
+        uses: anchore/sbom-action@v0
+        with:
+          path: ./
+          artifact-name: sbom.cyclonedx.json
+          output-file: sbom.cyclonedx.json
+          format: cyclonedx-json
+
+      - name: Attest SBOM (Docker Hub)
+        uses: actions/attest-sbom@v4
+        with:
+          subject-name: ${{ env.DOCKER_HUB_REPO }}
+          subject-digest: ${{ steps.push.outputs.digest }}
+          sbom-path: 'sbom.cyclonedx.json'
+          push-to-registry: true

{pystormtracker-0.3.1 → pystormtracker-0.3.3}/.github/workflows/python-publish.yml

@@ -7,15 +7,25 @@ on:
   release:
     types: [published]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
 permissions:
   contents: read
 
 jobs:
   release-build:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+      attestations: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
 
       - name: Set up uv
         uses: astral-sh/setup-uv@v7
@@ -23,7 +33,12 @@ jobs:
           enable-cache: true
 
       - name: Build release distributions
-        run: uv build
+        run: uv build --wheel --sdist
+
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v4
+        with:
+          subject-path: "dist/*"
 
       - name: Upload distributions
         uses: actions/upload-artifact@v7

pystormtracker-0.3.3/.python-version

@@ -0,0 +1 @@
+3.14

{pystormtracker-0.3.1 → pystormtracker-0.3.3}/CITATION.cff

@@ -1,5 +1,5 @@
 cff-version: 1.2.0
-title: PyStormTracker
+title: mwyau/PyStormTracker
 message: "If you use this software, please cite it as below."
 type: software
 authors:
@@ -19,8 +19,8 @@ keywords:
   - dask
   - mpi
 license: BSD-3-Clause
-version: 0.3.1
-date-released: '2026-03-08'
+version: 0.3.3
+date-released: '2026-03-10'
 preferred-citation:
   type: article
   authors:

pystormtracker-0.3.3/Dockerfile

@@ -0,0 +1,55 @@
+# --- Build Stage ---
+FROM python:3.13-slim AS builder
+
+# Prevent uv from creating a virtualenv that might be hard to move
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    UV_PYTHON_DOWNLOADS=0
+
+WORKDIR /app
+
+# Install uv
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+
+# 1. Copy only dependency files for better layer caching.
+COPY pyproject.toml uv.lock ./
+
+# 2. Install third-party dependencies first (including grib extra).
+# Use cache mount for uv to persist downloads and build artifacts.
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-dev --no-install-workspace --extra grib --no-editable
+
+# 3. Copy only necessary source files for the final installation step.
+COPY src/ ./src/
+COPY README.md ./
+
+# 4. Final installation of the project package itself.
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-dev --extra grib --no-editable
+
+
+# --- Runtime Stage ---
+FROM python:3.13-slim
+
+WORKDIR /app
+
+# Create data directory for mounting
+RUN mkdir /data && chmod 777 /data
+
+# Copy the environment from the builder
+COPY --from=builder /app/.venv /app/.venv
+
+# Ensure the virtualenv is used by default
+ENV PATH="/app/.venv/bin:$PATH" \
+    PYTHONUNBUFFERED=1
+
+# Add a non-root user for security
+RUN useradd -m pst
+USER pst
+
+# Volume for data persistence
+VOLUME /data
+
+# Default command
+ENTRYPOINT ["stormtracker"]
+CMD ["--help"]

{pystormtracker-0.3.1 → pystormtracker-0.3.3}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: PyStormTracker
-Version: 0.3.1
+Version: 0.3.3
 Summary: A Parallel Object-Oriented Cyclone Tracker in Python
-Project-URL: Homepage, https://pystormtracker.readthedocs.io/
+Project-URL: Homepage, https://pypi.org/project/PyStormTracker/
 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>
@@ -18,21 +18,31 @@ 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: dask>=2024.1.0
+Requires-Dist: distributed>=2024.1.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: h5py>=3.8.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: scipy>=1.9.2
 Requires-Dist: xarray>=2024.9.0
+Provides-Extra: all
+Requires-Dist: cfgrib>=0.9.15.1; extra == 'all'
+Requires-Dist: eccodes>=2.43.0; extra == 'all'
+Requires-Dist: eccodeslib>=2.43.0; extra == 'all'
+Requires-Dist: mpi4py>=4.1.0; extra == 'all'
+Requires-Dist: netcdf4>=1.6.1; extra == 'all'
 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'
+Requires-Dist: myst-parser>=5.0.0; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=3.1.0; extra == 'docs'
+Requires-Dist: sphinx>=9.0.4; extra == 'docs'
 Provides-Extra: grib
-Requires-Dist: cfgrib>=0.9.15; extra == 'grib'
+Requires-Dist: cfgrib>=0.9.15.1; extra == 'grib'
+Requires-Dist: eccodes>=2.43.0; extra == 'grib'
+Requires-Dist: eccodeslib>=2.43.0; extra == 'grib'
 Provides-Extra: mpi
-Requires-Dist: mpi4py>=4.0.0; extra == 'mpi'
+Requires-Dist: mpi4py>=4.1.0; extra == 'mpi'
+Provides-Extra: netcdf4
+Requires-Dist: netcdf4>=1.6.1; extra == 'netcdf4'
 Description-Content-Type: text/markdown
 
 # PyStormTracker
@@ -47,30 +57,29 @@ 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 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.
+**PyStormTracker** is a Python package for cyclone trajectory analysis, implementing the "Simple Tracker" algorithm described in **Yau and Chang (2020)**. It 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).
 
-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.
+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 and accurately process large-scale climate datasets.
 
 ## Features
 
-- **Modern Python Support**: Strictly targets **Python 3.11+** with comprehensive type hints and 100% strict `mypy` compliance.
-- **Xarray Integrated**: Leverages `xarray` with optimized I/O, acceleration, and parallel extras for robust, high-performance coordinate-aware processing and lazy data loading.
-- **Parallel Backends**:
-  - **Dask (Default)**: Automatically scales to all available CPU cores on local machines.
-  - **MPI**: Supports distributed execution via `mpi4py`.
-  - **Serial**: Standard sequential execution for smaller datasets or debugging.
-- **Robust Detection**: Optimized $O(N)$ extrema filtering and robust handling of masked/missing data.
-- **CI/CD Integrated**: Automated linting, type-checking, and code coverage reporting via GitHub Actions.
-- **Standardized Output**: Results are exported to the IMILAST intercomparison format (.txt) with readable datetime strings and formatted numeric values.
+- **Modern & Typed**: Strictly targets **Python 3.11+** with complete type hints and strict `mypy` compliance.
+- **Xarray Native**: Leverages `xarray` for robust, high-performance coordinate-aware processing, lazy data loading, and optimized I/O.
+- **Scalable Execution**: Supports multiple backends:
+  - **Dask (Default)**: Automatically scales to utilize all available CPU cores.
+  - **MPI**: Enables distributed execution across cluster nodes via `mpi4py`.
+  - **Serial**: Standard sequential execution for debugging or small datasets.
+- **Robust Feature Detection**: Employs optimized $O(N)$ extrema filtering with robust handling of masked or missing data.
+- **Interoperable Output**: Exports tracking results to the standard IMILAST intercomparison format (`.txt`) with human-readable datetime strings.
 
 ## Technical Methodology
 
-PyStormTracker treats meteorological fields as 2D images and leverages `scipy.ndimage` for robust feature detection:
+PyStormTracker treats meteorological fields as 2D images, utilizing `scipy.ndimage` for robust feature detection and tracking:
 
-- **Local Extrema Detection**: Uses an optimized sliding window filter to identify local minima (cyclones) or maxima (anticyclones/vorticity).
-- **Intensity & Refinement**: Applies the **Laplacian operator** (`laplace`) to measure the "sharpness" of the field at each detected center point. This is used to resolve duplicates and ensure only the most physically intense point is kept when multiple adjacent pixels are flagged.
-- **Spherical Continuity**: Utilizes `mode='wrap'` for all filters to correctly handle periodic boundaries across the Prime Meridian, enabling seamless tracking across the entire globe.
-- **Heuristic Linking**: Implements a nearest-neighbor linking strategy to connect detected centers into trajectories across successive time steps.
+- **Local Extrema Detection**: Employs an optimized sliding window filter to efficiently identify local minima (e.g., cyclones) or maxima (e.g., anticyclones, vorticity).
+- **Intensity & Refinement**: Applies the discrete **Laplacian operator** to measure the "sharpness" of the field at each candidate center. This metric resolves duplicate detections, ensuring only the most physically intense point is retained when adjacent pixels are flagged.
+- **Spherical Continuity**: Uses `mode='wrap'` for all spatial filters to correctly handle periodic boundary conditions across the Prime Meridian, allowing for seamless global tracking.
+- **Trajectory Linking**: Connects detected centers across consecutive time steps into continuous trajectories using a nearest-neighbor heuristic linking strategy.
 
 ## Documentation
 
@@ -81,36 +90,39 @@ Full documentation, including API references and advanced usage examples, is ava
 ### Prerequisites
 - Python 3.11+
 - (Optional) OpenMPI for MPI support.
+- **Windows Users**: Note that the `grib` optional dependency (via `eccodeslib`) currently only supports Linux and macOS.
 
 ### From PyPI (Recommended)
 You can install the latest stable version of PyStormTracker directly from PyPI:
 
-For use as a CLI tool:
+Using `pip` (standard):
 ```bash
-uv tool install PyStormTracker
+pip install PyStormTracker
 ```
 
-For use as a library in your project:
+Using `uv` (recommended):
 ```bash
+# For use as a CLI tool
+uv tool install PyStormTracker
+
+# For use as a library in your project
 uv add PyStormTracker
 ```
 
 ### From Source
-2. Install with **uv** (Recommended):
-   ```bash
-   git clone https://github.com/mwyau/PyStormTracker.git
-   cd PyStormTracker
-   uv sync --group dev
-   uv run pre-commit install --hook-type pre-push
-   ```
-
+Install with `uv` (Recommended):
+```bash
+git clone https://github.com/mwyau/PyStormTracker.git
+cd PyStormTracker
+uv sync
+```
 
 ## Usage
 
 Once installed, you can use the `stormtracker` command directly:
 
 ```bash
-stormtracker -i era5_msl_2.5x2.5.nc -v msl -o my_tracks
+stormtracker -i era5_msl_2025-2026_djf_2.5x2.5.nc -v msl -o my_tracks
 ```
 
 ### Command Line Arguments
@@ -128,17 +140,14 @@ stormtracker -i era5_msl_2.5x2.5.nc -v msl -o my_tracks
 ## Development
 
 ### Setup
-Using **uv** is the recommended way to set up your environment:
+Using `uv` is the recommended way to set up your environment:
 ```bash
 # Install dependencies and sync virtual environment
-uv sync --group dev
-
-# Install pre-push hooks
-uv run pre-commit install --hook-type pre-push
+uv sync
 ```
 
 ### Quality Control
-Run automated checks using **uv run**:
+Run automated checks using `uv run`:
 
 **Linting & Formatting:**
 ```bash
@@ -155,7 +164,7 @@ uv run mypy src/
 To keep development cycles fast, testing is tiered:
 - **Fast Tests**: Default local runs (skips integration tests).
 - **Integration Tests**: ONLY long-running integration/regression tests.
-- **Full Suite**: Everything (used in CI).
+- **Full Suite**: Everything.
 
 **Run fast unit tests only (Default):**
 ```bash
@@ -167,7 +176,6 @@ uv run pytest
 uv run pytest --run-integration
 ```
 
-
 **Run everything:**
 ```bash
 uv run pytest --run-all
@@ -177,21 +185,20 @@ uv run pytest --run-all
 
 If you use this software in your research, please cite the following:
 
-- **Yau, A. M. W.**, 2026: mwyau/PyStormTracker. *Zenodo*, https://doi.org/10.5281/zenodo.18764813.
+- **Yau, A. M. W.**, 2026: mwyau/PyStormTracker. *Zenodo*, [https://doi.org/10.5281/zenodo.18764813](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.
+- **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](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.
+ - **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).
 
- - **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
+ - **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).
+   - **IMILAST Intercomparison Protocol**: [https://proclim.scnat.ch/en/activities/project_imilast/intercomparison](https://proclim.scnat.ch/en/activities/project_imilast/intercomparison)
+   - **IMILAST Data Download**: [https://proclim.scnat.ch/en/activities/project_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 BSD-3-Clause terms found in the `LICENSE` file.