anemoi-utils 0.4.10__tar.gz → 0.4.12__tar.gz

anemoi_utils-0.4.12/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md

@@ -0,0 +1,46 @@
+## Description
+
+<!-- Provide a brief summary of the changes introduced in this pull request. -->
+
+## Type of Change
+
+-   [ ] Bug fix (non-breaking change which fixes an issue)
+-   [ ] New feature (non-breaking change which adds functionality)
+-   [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+-   [ ] Documentation update
+
+## Issue Number
+
+<!-- Link the Issue number this change addresses, ideally in one of the "magic format" such as Closes #XYZ -->
+
+<!-- Alternatively, explain the motivation behind the changes and the context in which they are being made. -->
+
+## Code Compatibility
+
+-   [ ] I have performed a self-review of my code
+
+### Code Performance and Testing
+
+-   [ ] I have added tests that prove my fix is effective or that my feature works
+-   [ ] I ran the [complete Pytest test](https://anemoi.readthedocs.io/projects/training/en/latest/dev/testing.html) suite locally, and they pass
+
+<!-- In case this affects the model sharding or other specific components please describe these here. -->
+
+### Dependencies
+
+-   [ ] I have ensured that the code is still pip-installable after the changes and runs
+-   [ ] I have tested that new dependencies themselves are pip-installable.
+
+<!-- List any new dependencies that are required for this change and the justification to add them. -->
+
+### Documentation
+
+-   [ ] My code follows the style guidelines of this project
+-   [ ] I have updated the documentation and docstrings to reflect the changes
+-   [ ] I have added comments to my code, particularly in hard-to-understand areas
+
+<!-- Describe any major updates to the documentation -->
+
+## Additional Notes
+
+<!-- Include any additional information, caveats, or considerations that the reviewer should be aware of. -->

anemoi_utils-0.4.12/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+- package-ecosystem: "pip"
+  directory: "/"
+  schedule:
+    interval: "weekly"
+- package-ecosystem: "github-actions"
+  directory: "/"
+  schedule:
+    interval: "monthly"

anemoi_utils-0.4.12/.github/labeler.yml

@@ -0,0 +1,42 @@
+# This is the configuration file for the labeler action.
+# It assigns labels to pull requests based on the files changed in the PR.
+# See more here: https://github.com/actions/labeler
+dependencies:
+- changed-files:
+  - any-glob-to-any-file:
+    - "**/requirements.txt"
+    - "**/setup.py"
+    - "**/pyproject.toml"
+    - "**/Pipfile"
+    - "**/Pipfile.lock"
+    - "**/requirements/*.txt"
+    - "**/requirements/*.in"
+
+documentation:
+- changed-files:
+  - any-glob-to-any-file:
+    - "**/docs/**/*"
+    - "*.md"
+    - "*.rst"
+
+config:
+- changed-files:
+  - any-glob-to-any-file:
+    - "**/src/**/config/**/*"
+
+CI/CD:
+- changed-files:
+  - any-glob-to-any-file:
+    - "**/.pre-commit-config.yaml"
+    - ".github/**/*"
+    - "tox.ini"
+    - ".coveragerc"
+
+tests:
+- changed-files:
+  - any-glob-to-any-file:
+    - "**/tests/**/*"
+    - "**/test/**/*"
+    - "**/test_*.py"
+    - "**/test.py"
+    - "**/conftest.py"

anemoi_utils-0.4.12/.github/release.yml

@@ -0,0 +1,23 @@
+# .github/release.yml
+# https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes
+
+changelog:
+  exclude:
+    labels:
+      - ignore-for-release
+      - no-changelog
+    authors:
+      - pre-commit-ci
+  categories:
+    - title: Breaking Changes 🛠
+      labels:
+        - "breaking change"
+    - title: Exciting New Features 🎉
+      labels:
+        - enhancement
+    - title: Config Changes 📑
+      labels:
+        - config
+    - title: Other Changes 🔗
+      labels:
+        - "*"

anemoi_utils-0.4.12/.github/workflows/downstream-ci-hpc.yml

@@ -0,0 +1,54 @@
+# This workflow triggers tests on dependent packages.
+# The dependency tree itself is defined in ecmwf-actions/downstream-ci/
+name: Test downstream dependent packages on HPC
+
+on:
+  # Trigger the workflow on push to main or develop, except tag creation
+  push:
+    branches:
+      - 'main'
+      - 'develop'
+    tags-ignore:
+      - '**'
+    paths-ignore:
+      - "docs/**"
+      - "CHANGELOG.md"
+      - "README.md"
+
+  # Trigger the workflow on pull request
+  pull_request:
+    paths-ignore:
+      - "docs/**"
+      - "CHANGELOG.md"
+      - "README.md"
+
+  # Trigger the workflow manually
+  workflow_dispatch: ~
+
+  # Trigger after public PR approved for CI
+  pull_request_target:
+    types: [labeled]
+    paths-ignore:
+      - "docs/**"
+      - "CHANGELOG.md"
+      - "README.md"
+
+jobs:
+  # Run CI including downstream packages on self-hosted runners
+  downstream-ci:
+    name: downstream-ci
+    if: ${{ !github.event.pull_request.head.repo.fork && github.event.action != 'labeled' || github.event.label.name == 'approved-for-ci' }}
+    uses: ecmwf-actions/downstream-ci/.github/workflows/downstream-ci.yml@main
+    with:
+      anemoi-utils: ecmwf/anemoi-utils@${{ github.event.pull_request.head.sha || github.sha }}
+      codecov_upload: true
+    secrets: inherit
+
+   # Build downstream packages on HPC
+  downstream-ci-hpc:
+    name: downstream-ci-hpc
+    if: ${{ !github.event.pull_request.head.repo.fork && github.event.action != 'labeled' || github.event.label.name == 'approved-for-ci' }}
+    uses: ecmwf-actions/downstream-ci/.github/workflows/downstream-ci-hpc.yml@main
+    with:
+      anemoi-utils: ecmwf/anemoi-utils@${{ github.event.pull_request.head.sha || github.sha }}
+    secrets: inherit

anemoi_utils-0.4.12/.github/workflows/pr-conventional-commit.yml

@@ -0,0 +1,22 @@
+# This workflow ensures that the PR title follows the Conventional Commit format.
+name: "[Pull Request] Ensure Conventional Commit in PR title"
+
+on:
+  pull_request_target:
+    types:
+      - opened
+      - edited
+      - synchronize
+      - reopened
+
+permissions:
+  pull-requests: read
+
+jobs:
+  main:
+    name: Validate PR title
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

anemoi_utils-0.4.12/.github/workflows/pr-label-conventional-commits.yml

@@ -0,0 +1,45 @@
+# This workflow assigns labels to a pull request based on the Conventional Commits format.
+# This is necessary for release-please to work properly.
+name: "[Pull Request] Label Conventional Commits"
+
+on:
+  pull_request:
+    branches: [main]
+    types:
+      [opened, reopened, labeled, unlabeled]
+
+jobs:
+  assign-labels:
+    runs-on: ubuntu-latest
+    name: Assign labels in pull request
+    if: github.event.pull_request.merged == false
+    steps:
+      - uses: actions/checkout@v3
+      - name: Assign labels from Conventional Commits
+        id: action-assign-labels
+        uses: mauroalderete/action-assign-labels@v1
+        with:
+          pull-request-number: ${{ github.event.pull_request.number }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          conventional-commits: |
+            conventional-commits:
+              - type: 'fix'
+                nouns: ['FIX', 'Fix', 'fix', 'FIXED', 'Fixed', 'fixed']
+                labels: ['bug']
+              - type: 'feature'
+                nouns: ['FEATURE', 'Feature', 'feature', 'FEAT', 'Feat', 'feat']
+                labels: ['enhancement']
+              - type: 'breaking_change'
+                nouns: ['BREAKING CHANGE', 'BREAKING', 'MAJOR']
+                labels: ['breaking change']
+              - type: 'documentation'
+                nouns: ['doc','docs','docu','document','documentation']
+                labels: ['documentation']
+              - type: 'build'
+                nouns: ['build','rebuild','ci']
+                labels: ['CI/CD']
+              - type: 'config'
+                nouns: ['config', 'conf', 'configuration']
+                labels: ['config']
+          maintain-labels-not-matched: false
+          apply-changes: true

anemoi_utils-0.4.12/.github/workflows/pr-label-file-based.yml

@@ -0,0 +1,17 @@
+# This workflow assigns labels to a pull request based on the files changed in the PR.
+# The labels are defined in the `.github/labels.yml` file.
+name: "[Pull Request] Label File-based"
+on:
+  pull_request_target:
+    types: [opened, synchronize]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  labeler:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Assign labels from file changes
+      uses: actions/labeler@v5

anemoi_utils-0.4.10/.github/workflows/label-public-pr.yml → anemoi_utils-0.4.12/.github/workflows/pr-label-public.yml

@@ -1,5 +1,5 @@
 # Manage labels of pull requests that originate from forks
-name: label-public-pr
+name: "[Pull Request] Label PRs from public forks"
 
 on:
   pull_request_target:

anemoi_utils-0.4.12/.github/workflows/python-publish.yml

@@ -0,0 +1,13 @@
+# This workflow will upload a Python Package using Twine when a release is created
+# For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries
+
+name: Upload Python Package to PyPI
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    uses: ecmwf-actions/reusable-workflows/.github/workflows/cd-pypi.yml@v2
+    secrets: inherit

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/.github/workflows/python-pull-request.yml

@@ -1,18 +1,15 @@
-# This workflow will upload a Python Package using Twine when a release is created
-# For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries
-
-name: Test PR
+# This workflow runs pre-commit checks and pytest tests against multiple platforms and Python versions.
+name: Code Quality checks and Testing
 
 on:
   pull_request:
     types: [opened, synchronize, reopened]
   push:
     branches:
-      - develop
+      - main
   schedule:
     - cron: "9 2 * * 0" # at 9:02 on sunday
 
-
 jobs:
   quality:
     uses: ecmwf-actions/reusable-workflows/.github/workflows/qa-precommit-run.yml@v2
@@ -22,7 +19,7 @@ jobs:
   checks:
     strategy:
       matrix:
-        python-version: ["3.11"]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
     uses: ecmwf-actions/reusable-workflows/.github/workflows/qa-pytest-pyproject.yml@v2
     with:
       python-version: ${{ matrix.python-version }}

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/.github/workflows/readthedocs-pr-update.yml

@@ -1,3 +1,5 @@
+# This workflow adds a link to the experimental documentation build to the PR.
+# This does NOT trigger a build of the documentation, this is handled through webhooks.
 name: Read the Docs PR Preview
 on:
   pull_request_target:

anemoi_utils-0.4.12/.github/workflows/release-please.yml

@@ -0,0 +1,28 @@
+# This workflow uses an action to run Release Please to create a release PR.
+# It is governed by the config and manifest in the root of the repo.
+# For more information see: https://github.com/googleapis/release-please
+name: Run Release Please
+on:
+  push:
+    branches:
+      - main
+      - hotfix/*
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: googleapis/release-please-action@v4
+        with:
+          # this assumes that you have created a personal access token
+          # (PAT) and configured it as a GitHub action secret named
+          # `MY_RELEASE_PLEASE_TOKEN` (this secret name is not important).
+          token: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+          # optional. customize path to .release-please-config.json
+          config-file: .release-please-config.json
+          # Currently releases are done from main
+          target-branch: ${{ github.ref_name }}

anemoi_utils-0.4.12/.gitignore

@@ -0,0 +1,135 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+__pypackages__/
+
+# Distribution / packaging
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Testing and coverage
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Documentation
+docs/_build/
+/site
+*.mo
+*.pot
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.spyderproject
+.spyproject
+.ropeproject
+.vscode/
+*.code-workspace
+*.sublime-project
+*.sublime-workspace
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+
+# Data files
+*.grib
+*.onnx
+*.ckpt
+*.npy
+*.npz
+*.zarr/
+*.nc
+*.h5
+*.hdf5
+*.pkl
+*.parquet
+*.csv
+*.xlsx
+*.xls
+
+# ML artifacts
+wandb/
+mlruns/
+lightning_logs/
+*.ckpt
+*.pt
+*.pth
+runs/
+checkpoints/
+
+# Temporary and system files
+*.swp
+*.download
+*.out
+*.sync
+*.dot
+*.tmp
+*.log
+*.log.*
+.DS_Store
+~*
+tmp/
+temp/
+logs/
+_dev/
+outputs/
+*tmp_data/
+
+# Project specific
+?
+?.*
+foo
+bar
+~$images.pptx
+test.py
+test.ipynb
+cutout.png
+_version.py
+*.to_upload
+tempCodeRunnerFile.python
+Untitled-*.py

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/.pre-commit-config.yaml

@@ -40,7 +40,7 @@ repos:
     - --force-single-line-imports
     - --profile black
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.8.1
+  rev: v0.8.6
   hooks:
   - id: ruff
     args:
@@ -64,7 +64,7 @@ repos:
   hooks:
   - id: pyproject-fmt
 -   repo: https://github.com/jshwi/docsig # Check docstrings against function sig
-    rev: v0.65.0
+    rev: v0.66.1
     hooks:
     -   id: docsig
         args:
@@ -76,5 +76,3 @@ repos:
         - --disable=E113     # Disable empty docstrings
 ci:
   autoupdate_schedule: monthly
-ci:
-  autoupdate_schedule: monthly

anemoi_utils-0.4.12/.release-please-config.json

@@ -0,0 +1,19 @@
+{
+  "release-type": "python",
+  "bump-minor-pre-major": true,
+  "bump-patch-for-minor-pre-major": true,
+  "separate-pull-requests": true,
+  "always-update": true,
+  "changelog-type": "github",
+  "include-component-in-tag": false,
+  "include-v-in-tag": false,
+  "pull-request-title-pattern": "chore${scope}: Preparing Next Release for ${component} ${version}",
+  "pull-request-header": ":robot: Automated Release PR\n\nThis PR was created by `release-please` to prepare the next release. Once merged:\n\n1. A new version tag will be created\n2. A GitHub release will be published\n3. The changelog will be updated\n\nChanges to be included in the next release:",
+  "pull-request-footer": "> [!IMPORTANT]\n> :warning: Merging this PR will:\n> - Create a new release\n> - Trigger deployment pipelines\n> - Update package versions\n\n **Before merging:**\n - Ensure all tests pass\n - Review the changelog carefully\n - Get required approvals\n\n [Release-please documentation](https://github.com/googleapis/release-please)",
+  "packages": {
+    ".": {
+        "package-name": "anemoi-utils"
+    }
+  },
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json"
+}

anemoi_utils-0.4.12/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+    ".": "0.4.12"
+}

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/CHANGELOG.md

@@ -8,6 +8,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 Please add your functional changes to the appropriate section in the PR.
 Keep it human-readable, your future self will thank you!
 
+## 0.4.12 (2025-01-30)
+
+<!-- Release notes generated using configuration in .github/release.yml at main -->
+
+## What's Changed
+### Other Changes 🔗
+* feat: better support for timedelta larger than 24h by @floriankrb in https://github.com/ecmwf/anemoi-utils/pull/81
+* feat(requests): read input from stdin by @gmertes in https://github.com/ecmwf/anemoi-utils/pull/82
+* chore: synced file(s) with ecmwf-actions/reusable-workflows by @DeployDuck in https://github.com/ecmwf/anemoi-utils/pull/80
+
+## New Contributors
+* @DeployDuck made their first contribution in https://github.com/ecmwf/anemoi-utils/pull/80
+
+**Full Changelog**: https://github.com/ecmwf/anemoi-utils/compare/0.4.11...0.4.12
+
+## 0.4.11 (2025-01-17)
+
+<!-- Release notes generated using configuration in .github/release.yml at develop -->
+
+## What's Changed
+### Other Changes
+* Feature request: Add option to read configuration from stdin by @mpartio in https://github.com/ecmwf/anemoi-utils/pull/59
+* feat(plots): Add quick map plot for debugging by @b8raoult in https://github.com/ecmwf/anemoi-utils/pull/69
+* feat: added-anemoi-utils-grids-and-tests by @floriankrb in https://github.com/ecmwf/anemoi-utils/pull/74
+* feat(plot): added plotting options by @NRaoult in https://github.com/ecmwf/anemoi-utils/pull/72
+* ci(release): Simplify Release Workflow to Minimum by @JesperDramsch in https://github.com/ecmwf/anemoi-utils/pull/78
+* feat: adding-tools-for-grids by @floriankrb in https://github.com/ecmwf/anemoi-utils/pull/76
+
+## New Contributors
+* @mpartio made their first contribution in https://github.com/ecmwf/anemoi-utils/pull/59
+* @NRaoult made their first contribution in https://github.com/ecmwf/anemoi-utils/pull/72
+
+**Full Changelog**: https://github.com/ecmwf/anemoi-utils/compare/0.4.10...0.4.11
+
 ## [0.4.5](https://github.com/ecmwf/anemoi-utils/compare/0.4.4...0.4.5) - 2024-11-06
 
 ### What's Changed

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/CONTRIBUTORS.md

@@ -1,6 +1,6 @@
 ## How to Contribute
 
-Please see the [read the docs](https://anemoi-training.readthedocs.io/en/latest/dev/contributing.html).
+Please see the [read the docs](https://anemoi.readthedocs.io/en/latest/dev/contributing.html).
 
 
 ## Contributors
@@ -10,4 +10,4 @@ Thank you to all the wonderful people who have contributed to Anemoi. Contributi
 
 ## Contributing Organisations
 
-Significant contributions have been made by the following organisations: [DWD](https://www.dwd.de/), [MET Norway](https://www.met.no/), [MeteoSwiss](https://www.meteoswiss.admin.ch/), [RMI](https://www.meteo.be/) & [ECMWF](https://www.ecmwf.int/)
+Significant contributions have been made by the following organisations: [DWD](https://www.dwd.de/), [FMI](https://www.ilmatieteenlaitos.fi/), [KNMI](https://www.knmi.nl), [MET Norway](https://www.met.no/), [MeteoSwiss](https://www.meteoswiss.admin.ch/), [RMI](https://www.meteo.be/) & [ECMWF](https://www.ecmwf.int/)

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2024-2025 Anemoi Contributors
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: anemoi-utils
-Version: 0.4.10
+Version: 0.4.12
 Summary: A package to hold various functions to support training of ML models on ECMWF data.
 Author-email: "European Centre for Medium-Range Weather Forecasts (ECMWF)" <software.support@ecmwf.int>
 License:                                  Apache License
@@ -191,7 +191,7 @@ License:                                  Apache License
               same "printed page" as the copyright notice for easier
               identification within third-party archives.
         
-           Copyright [yyyy] [name of copyright owner]
+           Copyright 2024-2025 Anemoi Contributors
         
            Licensed under the Apache License, Version 2.0 (the "License");
            you may not use this file except in compliance with the License.
@@ -226,6 +226,7 @@ Requires-Python: >=3.9
 License-File: LICENSE
 Requires-Dist: aniso8601
 Requires-Dist: importlib-metadata; python_version < "3.10"
+Requires-Dist: numpy
 Requires-Dist: python-dateutil
 Requires-Dist: pyyaml
 Requires-Dist: tomli; python_version < "3.11"

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/README.md

@@ -5,7 +5,7 @@ This project is **BETA** and will be **Experimental** for the foreseeable future
 Interfaces and functionality are likely to change, and the project itself may be scrapped.
 **DO NOT** use this software in any project/software that is operational.
 
-Miscellanous tools for training data-driven weather forecasts.
+
 
 ## Documentation
 
@@ -22,7 +22,7 @@ $ pip install anemoi-utils
 ## License
 
 ```
-Copyright 2024, Anemoi contributors.
+Copyright 2024-2025, Anemoi Contributors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/pyproject.toml

@@ -42,6 +42,7 @@ dynamic = [ "version" ]
 dependencies = [
   "aniso8601",
   "importlib-metadata; python_version<'3.10'",
+  "numpy",
   "python-dateutil",
   "pyyaml",
   "tomli; python_version<'3.11'",

{anemoi_utils-0.4.10 → anemoi_utils-0.4.12}/src/anemoi/utils/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.4.10'
-__version_tuple__ = version_tuple = (0, 4, 10)
+__version__ = version = '0.4.12'
+__version_tuple__ = version_tuple = (0, 4, 12)