openstef 4.4.2__tar.gz → 4.4.4__tar.gz

{openstef-4.4.2 → openstef-4.4.4}/.github/workflows/_job_quality_check.yaml

@@ -20,12 +20,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout # Must be done before using composite actions
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0 # full history gives Sonar accurate new-code / blame info
           show-progress: false # very verbose for not much
       - name: Install uv
-        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         # uv is needed for qa and deploy, so is kinda always needed. No need to skip it.
         with:
           activate-environment: true
@@ -70,7 +70,7 @@ jobs:
       # Skipped on fork PRs, which cannot access the SONAR_TOKEN secret.
       - name: SonarCloud scan
         if: ${{ ! inputs._SKIP_QUALITY && !cancelled() && (github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository) }}
-        uses: SonarSource/sonarqube-scan-action@713881670b6b3676cda39549040e2d88c70d582e # v8.2.0
+        uses: SonarSource/sonarqube-scan-action@ba9859eae8dd6bd29e412f25ddbbef3d032000f4 # v8.2.2
         env:
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
           SONAR_HOST_URL: https://sonarcloud.io

{openstef-4.4.2 → openstef-4.4.4}/.github/workflows/citations.yaml

@@ -33,9 +33,9 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
     - name: checkout
-      uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
     - name: Install R
       run: |
         sudo apt-get update && sudo apt-get install -y r-base
     - name: Validate CITATION.cff
-      uses: dieghernan/cff-validator@54c8e737314b948f25c0e5524a9d8ae3f39b207b # v5.0.1
+      uses: dieghernan/cff-validator@d8f85828214016ce6976e740b6e0504c0fdc4dbb # v5.1.1

{openstef-4.4.2 → openstef-4.4.4}/.github/workflows/codeql.yaml

@@ -28,10 +28,10 @@ jobs:
       contents: read
     steps:
       - name: Checkout
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4.37.9
+        uses: github/codeql-action/init@1c5b675653bb5c22dbe9b12b556ec555138e09fd # v4.38.1
         with:
           languages: python
           build-mode: none # Python is interpreted; no build step required
@@ -41,6 +41,6 @@ jobs:
           queries: security-extended
 
       - name: Perform CodeQL analysis
-        uses: github/codeql-action/analyze@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4.37.9
+        uses: github/codeql-action/analyze@1c5b675653bb5c22dbe9b12b556ec555138e09fd # v4.38.1
         with:
           category: '/language:python'

{openstef-4.4.2 → openstef-4.4.4}/.github/workflows/docs-check.yaml

@@ -36,12 +36,12 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           show-progress: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           activate-environment: true
           enable-cache: true

{openstef-4.4.2 → openstef-4.4.4}/.github/workflows/docs.yaml

@@ -21,12 +21,12 @@ jobs:
 
     steps:
       - name: Checkout main
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           show-progress: false
       
       - name: Install uv
-        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           activate-environment: true
           enable-cache: true
@@ -38,7 +38,7 @@ jobs:
         run: poe docs
       
       - name: Checkout gh-pages branch for deployment
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           ref: gh-pages
           path: gh-pages-repo

{openstef-4.4.2 → openstef-4.4.4}/.github/workflows/pr-labeler.yaml

@@ -14,6 +14,6 @@ jobs:
       pull-requests: write # To add labels
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/labeler@f27b608878404679385c85cfa523b85ccb86e213 # v6.1.0
+      - uses: actions/labeler@bf12e9b00b37c5c0ca2b87b79b2daf7891dbda13 # v7.0.0
         with:
           configuration-path: .github/pr-labeler.yml

{openstef-4.4.2 → openstef-4.4.4}/.github/workflows/release-v4.yaml

@@ -38,12 +38,12 @@ jobs:
       contents: write
     steps:
       - name: Checkout
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
           show-progress: false
       - name: Install uv
-        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           activate-environment: true
           enable-cache: true

{openstef-4.4.2 → openstef-4.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: openstef
-Version: 4.4.2
+Version: 4.4.4
 Summary: Open Short Term Energy forecasting library
 Project-URL: Documentation, https://openstef.github.io/openstef/index.html
 Project-URL: Homepage, https://lfenergy.org/projects/openstef/
@@ -16,26 +16,26 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: <4.0,>=3.12
-Requires-Dist: openstef-core==4.4.2
-Requires-Dist: openstef-models[xgb-cpu]==4.4.2
+Requires-Dist: openstef-core==4.4.4
+Requires-Dist: openstef-models[xgb-cpu]==4.4.4
 Provides-Extra: all
-Requires-Dist: openstef-beam[all]==4.4.2; extra == 'all'
-Requires-Dist: openstef-core==4.4.2; extra == 'all'
-Requires-Dist: openstef-foundation-models[cpu]==4.4.2; extra == 'all'
-Requires-Dist: openstef-meta==4.4.2; extra == 'all'
-Requires-Dist: openstef-models[xgb-cpu]==4.4.2; extra == 'all'
+Requires-Dist: openstef-beam[all]==4.4.4; extra == 'all'
+Requires-Dist: openstef-core==4.4.4; extra == 'all'
+Requires-Dist: openstef-foundation-models[cpu]==4.4.4; extra == 'all'
+Requires-Dist: openstef-meta==4.4.4; extra == 'all'
+Requires-Dist: openstef-models[xgb-cpu]==4.4.4; extra == 'all'
 Provides-Extra: beam
 Requires-Dist: huggingface-hub>=0.35.3; extra == 'beam'
-Requires-Dist: openstef-beam==4.4.2; extra == 'beam'
+Requires-Dist: openstef-beam==4.4.4; extra == 'beam'
 Provides-Extra: core
-Requires-Dist: openstef-core==4.4.2; extra == 'core'
+Requires-Dist: openstef-core==4.4.4; extra == 'core'
 Provides-Extra: foundation-models
-Requires-Dist: openstef-foundation-models[cpu]==4.4.2; extra == 'foundation-models'
+Requires-Dist: openstef-foundation-models[cpu]==4.4.4; extra == 'foundation-models'
 Provides-Extra: meta
-Requires-Dist: openstef-meta==4.4.2; extra == 'meta'
+Requires-Dist: openstef-meta==4.4.4; extra == 'meta'
 Provides-Extra: models
-Requires-Dist: openstef-meta==4.4.2; extra == 'models'
-Requires-Dist: openstef-models[xgb-cpu]==4.4.2; extra == 'models'
+Requires-Dist: openstef-meta==4.4.4; extra == 'models'
+Requires-Dist: openstef-models[xgb-cpu]==4.4.4; extra == 'models'
 Description-Content-Type: text/markdown
 
 <!--

{openstef-4.4.2 → openstef-4.4.4}/docs/pyproject.toml

@@ -23,13 +23,7 @@ dependencies = [
   "ipython>=9.4",
   "jupyter-cache>=1",
   "jupytext>=1.16",
-  # Constrained to v0.2.x because kaleido >=1.0 fails to JSON-serialize
-  # pandas Timestamp values in figure specs (orjson default raises TypeError),
-  # 0.4.x is incompatible with the current plotly scope API, and 0.2.1.post1
-  # only ships a linux/armv7 wheel. v0 is deprecated upstream but functional.
-  # See OpenSTEF/openstef#938; lift the constraint once kaleido v1 handles
-  # pandas Timestamp natively.
-  "kaleido>=0.2.1,<0.3,!=0.2.1.post1",
+  "kaleido>=1.4",
   "matplotlib>=3.10.5",
   "myst-nb>=1.2",
   "openstef",

{openstef-4.4.2 → openstef-4.4.4}/examples/pyproject.toml

@@ -21,10 +21,7 @@ dependencies = [
 ]
 optional-dependencies.tutorials = [
   "jupyter>=1.1.1",
-  # Constrained to v0.2.x; kaleido >=1.0 cannot serialize pandas Timestamp
-  # via orjson, 0.4.x breaks the plotly scope API, and 0.2.1.post1 ships only
-  # a linux/armv7 wheel. See OpenSTEF/openstef#938.
-  "kaleido>=0.2.1,<0.3,!=0.2.1.post1",
+  "kaleido>=1.4",
   "openstef-core[benchmark]",
 ]
 

{openstef-4.4.2 → openstef-4.4.4}/packages/openstef-beam/pyproject.toml

@@ -7,7 +7,7 @@ requires = [ "hatchling" ]
 
 [project]
 name = "openstef-beam"
-version = "4.4.2"
+version = "4.4.4"
 description = "Backtesting, Evaluation, Analysis and Metrics (BEAM) library for OpenSTEF"
 readme = "README.md"
 keywords = [ "energy", "forecasting", "machinelearning" ]

{openstef-4.4.2 → openstef-4.4.4}/packages/openstef-beam/src/openstef_beam/analysis/plots/summary_table_plotter.py

@@ -75,6 +75,7 @@ class SummaryTablePlotter:
                 ]
             )
             .hide(axis="index")
+            .format(escape="html")
             .to_html()
         )
 

{openstef-4.4.2 → openstef-4.4.4}/packages/openstef-core/pyproject.toml

@@ -7,7 +7,7 @@ requires = [ "hatchling" ]
 
 [project]
 name = "openstef-core"
-version = "4.4.2"
+version = "4.4.4"
 description = "Core functionality for OpenSTEF, a framework for short-term energy forecasting."
 readme = "README.md"
 keywords = [ "energy", "forecasting", "machinelearning" ]

{openstef-4.4.2 → openstef-4.4.4}/packages/openstef-foundation-models/pyproject.toml

@@ -7,7 +7,7 @@ requires = [ "hatchling" ]
 
 [project]
 name = "openstef-foundation-models"
-version = "4.4.2"
+version = "4.4.4"
 description = "Foundation model support for OpenSTEF"
 readme = "README.md"
 keywords = [ "energy", "forecasting", "foundationmodels", "machinelearning", "onnx" ]

{openstef-4.4.2 → openstef-4.4.4}/packages/openstef-meta/pyproject.toml

@@ -7,7 +7,7 @@ requires = [ "hatchling" ]
 
 [project]
 name = "openstef-meta"
-version = "4.4.2"
+version = "4.4.4"
 description = "Meta models for OpenSTEF"
 readme = "README.md"
 keywords = [ "energy", "forecasting", "machinelearning" ]

{openstef-4.4.2 → openstef-4.4.4}/packages/openstef-models/pyproject.toml

@@ -7,7 +7,7 @@ requires = [ "hatchling" ]
 
 [project]
 name = "openstef-models"
-version = "4.4.2"
+version = "4.4.4"
 description = "Core models for OpenSTEF"
 readme = "README.md"
 keywords = [ "energy", "forecasting", "machinelearning" ]

{openstef-4.4.2 → openstef-4.4.4}/packages/openstef-models/src/openstef_models/models/forecasting/flatliner_forecaster.py

@@ -8,7 +8,8 @@ Provides basic forecasting model that predict constant flatliner zero values. It
 when a flatline (non-)zero measurement is observed in the past and expected in the future.
 """
 
-from typing import override
+from datetime import timedelta
+from typing import cast, override
 
 import pandas as pd
 from pydantic import Field, PrivateAttr
@@ -24,8 +25,9 @@ MODEL_CODE_VERSION = 1
 class FlatlinerForecaster(Forecaster, ExplainableForecaster, ContributionsMixin):
     """Flatliner forecaster that predicts a flatline of zeros or median.
 
-    A simple forecasting model that always predicts zero (or the median of historical
-    load measurements if configured) for all horizons and quantiles.
+    A simple forecasting model that always predicts zero (or a median load value if
+    configured) for all horizons and quantiles. The median can be calculated over
+    a trailing window when the fallback is responding to a recent flatline.
 
     Invariants:
         - Configuration quantiles determine the number of prediction outputs
@@ -49,6 +51,10 @@ class FlatlinerForecaster(Forecaster, ExplainableForecaster, ContributionsMixin)
         default=False,
         description="If True, predict the median of load measurements instead of zero.",
     )
+    median_window: timedelta | None = Field(
+        default=None,
+        description="Optional trailing window for the median load estimate; None uses all available measurements.",
+    )
 
     hyperparams: HyperParams = Field(
         default_factory=HyperParams,
@@ -76,7 +82,13 @@ class FlatlinerForecaster(Forecaster, ExplainableForecaster, ContributionsMixin)
         data_val: ForecastInputDataset | None = None,
     ) -> None:
         if self.predict_median:
-            self._median_value = float(data.target_series.median())
+            target_series = data.target_series
+            if self.median_window is not None:
+                last_valid_index = cast(pd.Timestamp | None, target_series.last_valid_index())
+                if last_valid_index is not None:
+                    window_start = last_valid_index - self.median_window
+                    target_series = target_series.loc[window_start:last_valid_index]
+            self._median_value = float(target_series.median())
 
     @override
     def predict(self, data: ForecastInputDataset) -> ForecastDataset:

{openstef-4.4.2 → openstef-4.4.4}/packages/openstef-models/src/openstef_models/presets/forecasting_workflow.py

@@ -566,6 +566,7 @@ def create_forecasting_workflow(
             quantiles=config.quantiles,
             horizons=config.horizons,
             predict_median=config.predict_nonzero_flatliner,
+            median_window=config.flatliner_threshold,
         )
         postprocessing = [
             QuantileSorter(),

{openstef-4.4.2 → openstef-4.4.4}/packages/openstef-models/tests/unit/models/forecasting/test_flatliner_forecaster.py

@@ -10,6 +10,8 @@ import pytest
 from openstef_core.datasets.validated_datasets import ForecastInputDataset
 from openstef_core.types import LeadTime, Quantile
 from openstef_models.models.forecasting.flatliner_forecaster import FlatlinerForecaster
+from openstef_models.models.forecasting_model import ForecastingModel
+from openstef_models.presets import ForecastingWorkflowConfig, create_forecasting_workflow
 
 
 @pytest.fixture
@@ -64,3 +66,55 @@ def test_predict_returns_median_when_predict_median_is_true(sample_forecast_inpu
     assert isinstance(result.data, pd.DataFrame)
     assert (result.data == expected_median).all().all()
     assert set(result.data.columns) == {q.format() for q in forecaster.quantiles}
+
+
+@pytest.mark.parametrize(
+    ("load_values", "median_window", "expected_median"),
+    [
+        pytest.param([100.0, 110.0, 120.0, 7.0, 7.0, 7.0], timedelta(hours=2), 7.0, id="repeated-value"),
+        pytest.param([100.0, 110.0, 120.0, 6.0, 8.0], timedelta(hours=1), 7.0, id="two-different-values"),
+    ],
+)
+def test_predict_returns_recent_median_when_median_window_is_set(
+    load_values: list[float],
+    median_window: timedelta,
+    expected_median: float,
+) -> None:
+    # Arrange
+    index = pd.date_range("2025-01-01", periods=len(load_values), freq="h")
+    data = ForecastInputDataset(
+        data=pd.DataFrame({"load": load_values}, index=index),
+        sample_interval=timedelta(hours=1),
+    )
+    forecaster = FlatlinerForecaster(
+        quantiles=[Quantile(0.5)],
+        horizons=[LeadTime(timedelta(hours=1))],
+        predict_median=True,
+        median_window=median_window,
+    )
+
+    # Act
+    forecaster.fit(data)
+    result = forecaster.predict(data)
+
+    # Assert
+    assert (result.data == expected_median).all().all()
+
+
+def test_flatliner_workflow_uses_threshold_for_median_window() -> None:
+    # Arrange
+    config = ForecastingWorkflowConfig(
+        model_id="flatliner-test",
+        model="flatliner",
+        flatliner_threshold=timedelta(hours=6),
+        predict_nonzero_flatliner=True,
+        mlflow_storage=None,
+    )
+
+    # Act
+    workflow = create_forecasting_workflow(config)
+
+    # Assert
+    assert isinstance(workflow.model, ForecastingModel)
+    assert isinstance(workflow.model.forecaster, FlatlinerForecaster)
+    assert workflow.model.forecaster.median_window == timedelta(hours=6)

{openstef-4.4.2 → openstef-4.4.4}/pyproject.toml

@@ -7,7 +7,7 @@ requires = [ "hatchling" ]
 
 [project]
 name = "openstef"
-version = "4.4.2"
+version = "4.4.4"
 description = "Open Short Term Energy forecasting library"
 readme = "README.md"
 keywords = [ "energy", "forecasting", "machinelearning" ]
@@ -24,32 +24,32 @@ classifiers = [
   "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-  "openstef-core==4.4.2",
-  "openstef-models[xgb-cpu]==4.4.2",
+  "openstef-core==4.4.4",
+  "openstef-models[xgb-cpu]==4.4.4",
 ]
 optional-dependencies.all = [
-  "openstef-beam[all]==4.4.2",
-  "openstef-core==4.4.2",
-  "openstef-foundation-models[cpu]==4.4.2",
-  "openstef-meta==4.4.2",
-  "openstef-models[xgb-cpu]==4.4.2",
+  "openstef-beam[all]==4.4.4",
+  "openstef-core==4.4.4",
+  "openstef-foundation-models[cpu]==4.4.4",
+  "openstef-meta==4.4.4",
+  "openstef-models[xgb-cpu]==4.4.4",
 ]
 optional-dependencies.beam = [
   "huggingface-hub>=0.35.3",
-  "openstef-beam==4.4.2",
+  "openstef-beam==4.4.4",
 ]
 optional-dependencies.foundation-models = [
-  "openstef-foundation-models[cpu]==4.4.2",
+  "openstef-foundation-models[cpu]==4.4.4",
 ]
 optional-dependencies.meta = [
-  "openstef-meta==4.4.2",
+  "openstef-meta==4.4.4",
 ]
 optional-dependencies.models = [
-  "openstef-meta==4.4.2",
-  "openstef-models[xgb-cpu]==4.4.2",
+  "openstef-meta==4.4.4",
+  "openstef-models[xgb-cpu]==4.4.4",
 ]
 optional-dependencies.core = [
-    "openstef-core==4.4.2",
+    "openstef-core==4.4.4",
 ]
 urls.Documentation = "https://openstef.github.io/openstef/index.html"
 urls.Homepage = "https://lfenergy.org/projects/openstef/"