Files
EOS/docs/_generated/configfeedintariff.md
Bobby Noelte ed61918fe0
Some checks failed
Bump Version / Bump Version Workflow (push) Has been cancelled
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
docker-build / platform-excludes (push) Has been cancelled
docker-build / build (push) Has been cancelled
docker-build / merge (push) Has been cancelled
pre-commit / pre-commit (push) Has been cancelled
Run Pytest on Pull Request / test (push) Has been cancelled
feat: add EnergyCharts feed-in tariff provider (#1165)
The `FeedInTariffEnergyCharts` provider uses the raw Energy-Charts day-ahead market price as the
feed-in tariff. It stores prices in `feed_in_tariff_wh` without adding electricity import charges
or VAT. The data is loaded from the Energy-Charts `/price` endpoint for the configured bidding
zone. The native Energy-Charts resolution, including quarter-hour data, is retained.

Energy-Charts usually supplies prices only for the published day-ahead period. If that data does
not cover the complete configured prediction horizon, the provider extends it as follows:

- With more than 800 hours of history, an ETS (Holt-Winters exponential smoothing) forecast with
  weekly seasonality is used.
- With more than 168 hours of history, an ETS forecast with daily seasonality is used.
- With less history, the median of the available values is used as a constant fallback.

The seasonal periods are adjusted to the source resolution. For example, quarter-hour data uses
four values per hour. Values already supplied by Energy-Charts are kept unchanged; only missing
future slots after the last published price are forecast. Consequently, a 15-minute optimization
uses four forecast values per hour without converting them to hourly averages.

Signed-off-by: Andreas Schmitz <akkudoktor.net>
Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com>
2026-07-23 15:48:29 +02:00

4.8 KiB

Feed In Tariff Prediction Configuration

:::{table} feedintariff :widths: 10 20 10 5 5 30 :align: left

Name Environment Variable Type Read-Only Default Description
energycharts EOS_FEEDINTARIFF__ENERGYCHARTS FeedInTariffEnergyChartsCommonSettings rw required EnergyCharts feed in tariff provider settings.
feedintarifffixed EOS_FEEDINTARIFF__FEEDINTARIFFFIXED FeedInTariffFixedCommonSettings rw required Fixed feed in tariff provider settings.
feedintariffimport EOS_FEEDINTARIFF__FEEDINTARIFFIMPORT FeedInTariffImportCommonSettings rw required Feed in tarif import provider settings.
provider EOS_FEEDINTARIFF__PROVIDER Optional[str] rw None Feed in tariff provider id of provider to be used.
providers list[str] ro N/A Available feed in tariff provider ids.
:::

Example Input

   {
       "feedintariff": {
           "provider": "FeedInTariffFixed",
           "feedintarifffixed": {
               "feed_in_tariff_kwh": null
           },
           "feedintariffimport": {
               "import_file_path": null,
               "import_json": null
           },
           "energycharts": {
               "bidding_zone": "DE-LU"
           }
       }
   }

Example Output

   {
       "feedintariff": {
           "provider": "FeedInTariffFixed",
           "feedintarifffixed": {
               "feed_in_tariff_kwh": null
           },
           "feedintariffimport": {
               "import_file_path": null,
               "import_json": null
           },
           "energycharts": {
               "bidding_zone": "DE-LU"
           },
           "providers": [
               "FeedInTariffEnergyCharts",
               "FeedInTariffFixed",
               "FeedInTariffImport"
           ]
       }
   }

Common settings for feed in tariff data import from file or JSON string

:::{table} feedintariff::feedintariffimport :widths: 10 10 5 5 30 :align: left

Name Type Read-Only Default Description
import_file_path Union[str, pathlib.Path, NoneType] rw None Path to the file to import feed in tariff data from.
import_json Optional[str] rw None JSON string, dictionary of feed in tariff forecast value lists.
:::

Example Input/Output

   {
       "feedintariff": {
           "feedintariffimport": {
               "import_file_path": null,
               "import_json": "{\"fead_in_tariff_wh\": [0.000078, 0.000078, 0.000023]}"
           }
       }
   }

Common settings for elecprice fixed price

:::{table} feedintariff::feedintarifffixed :widths: 10 10 5 5 30 :align: left

Name Type Read-Only Default Description
feed_in_tariff_kwh Optional[float] rw None Electricity price feed in tariff [amount/kWh].
:::

Example Input/Output

   {
       "feedintariff": {
           "feedintarifffixed": {
               "feed_in_tariff_kwh": 0.078
           }
       }
   }

Common settings for Energy-Charts feed-in tariff provider

:::{table} feedintariff::energycharts :widths: 10 10 5 5 30 :align: left

Name Type Read-Only Default Description
bidding_zone <enum 'EnergyChartsBiddingZones'> rw DE-LU Bidding Zone: 'AT', 'BE', 'CH', 'CZ', 'DE-LU', 'DE-AT-LU', 'DK1', 'DK2', 'FR', 'HU', 'IT-NORTH', 'NL', 'NO2', 'PL', 'SE4' or 'SI'
:::

Example Input/Output

   {
       "feedintariff": {
           "energycharts": {
               "bidding_zone": "DE-LU"
           }
       }
   }