mirror of
https://github.com/Akkudoktor-EOS/EOS.git
synced 2026-10-09 16:06:40 +00:00
Andreas
a2f4ef6f54
The optimizer treated the end of `optimization.horizon_hours` as the end of the world: energy left in the battery there was worth a single configured price per kWh, so it either dumped the battery into the last hours or hoarded it, depending on that one number. The horizon is now two spans. `horizon_hours` still receives every control command. The new `optimization.tail_horizon_hours` (default 48 h) is a pure lookahead that never produces a command. In AUTO terminal-value mode a deterministic dynamic program solves that tail backwards on a 101-point SoC grid using the production battery and inverter models - SoC bounds, power caps, conversion losses, configured charge and export rates, direct-marketing permission and LCOS on delivered DC energy - and the existing AUTO proxy supplies the continuation value at the tail end. Genetic fitness reads the resulting curve. `tail_horizon_hours: 0` restores the plain proxy at the control end, FIXED is unchanged. The forecast budget is reported, never enforced by refusal: a tail that does not fit is shortened to what the forecast covers and reported as `effective_tail_hours`, and a control horizon that does not fit is warned about at configuration time and rejected by the optimizer at run time, which knows which series ran out. `prediction.hours` defaults to 72 so the new defaults fit out of the box; existing shorter configurations keep starting. Control arrays and warm-start genomes now begin at the run timestamp rather than midnight, flagged by `controls_start_at_now` so the adapters still read older solutions. `forecast_interval_seconds` declares the resolution of shortened native quarter-hour inputs. Required forecasts are no longer silently replaced by demo providers. A missing PV, price, load, feed-in or weather forecast used to rewrite the configured provider and retry, so a run could quietly optimize against invented data. Missing values now stay missing, and provider values are held only within their own source interval instead of being extended indefinitely. Also fixes a config update that could leave EOS half-updated: the merged candidate is validated before the singleton is reinitialized. Four provider tests that hard-coded the old 48 h prediction default are rewritten to derive their expectations from the configured horizon.
77 lines
1.2 KiB
Markdown
77 lines
1.2 KiB
Markdown
% SPDX-License-Identifier: Apache-2.0
|
|
|
|
```{image} _static/logo.png
|
|
|
|
```
|
|
|
|
# Akkudoktor EOS documentation
|
|
|
|
```{toctree}
|
|
:maxdepth: 2
|
|
:caption: Overview
|
|
|
|
akkudoktoreos/introduction.md
|
|
|
|
```
|
|
|
|
```{toctree}
|
|
:maxdepth: 2
|
|
:caption: Tutorials
|
|
|
|
develop/getting_started.md
|
|
|
|
```
|
|
|
|
```{toctree}
|
|
:maxdepth: 2
|
|
:caption: How-To Guides
|
|
|
|
develop/CONTRIBUTING.md
|
|
develop/install.md
|
|
akkudoktoreos/configuration.md
|
|
develop/update.md
|
|
develop/revert.md
|
|
akkudoktoreos/adapter/adapterhomeassistant.md
|
|
akkudoktoreos/adapter/adapternodered.md
|
|
akkudoktoreos/grafana_tail_debugging.md
|
|
|
|
```
|
|
|
|
```{toctree}
|
|
:maxdepth: 2
|
|
:caption: Reference
|
|
|
|
akkudoktoreos/architecture.md
|
|
akkudoktoreos/configuration.md
|
|
akkudoktoreos/configtimewindow.md
|
|
akkudoktoreos/optimization_horizons.md
|
|
akkudoktoreos/optimpost.md
|
|
akkudoktoreos/optimauto.md
|
|
akkudoktoreos/resource.md
|
|
akkudoktoreos/prediction.md
|
|
akkudoktoreos/measurement.md
|
|
akkudoktoreos/integration.md
|
|
akkudoktoreos/logging.md
|
|
akkudoktoreos/database.md
|
|
akkudoktoreos/adapter.md
|
|
akkudoktoreos/serverapi.md
|
|
akkudoktoreos/api.rst
|
|
|
|
```
|
|
|
|
```{toctree}
|
|
:maxdepth: 2
|
|
:caption: Development
|
|
|
|
develop/develop.md
|
|
develop/release.md
|
|
develop/CHANGELOG.md
|
|
|
|
```
|
|
|
|
## Indices and tables
|
|
|
|
- {ref}`genindex`
|
|
- {ref}`modindex`
|
|
- {ref}`search`
|