Mirrors/EOS

Fork 0

mirror of https://github.com/Akkudoktor-EOS/EOS.git synced 2025-06-27 16:36:53 +00:00

Bobby Noelte bd38b3c5ef

docker-build / platform-excludes (push) Has been cancelled

Details

pre-commit / pre-commit (push) Has been cancelled

Details

Run Pytest on Pull Request / test (push) Has been cancelled

Details

docker-build / build (push) Has been cancelled

Details

docker-build / merge (push) Has been cancelled

Details

Close stale pull requests/issues / Find Stale issues and PRs (push) Has been cancelled

Details

fix: logging, prediction update, multiple bugs (#584 )

* Fix logging configuration issues that made logging stop operation. Switch to Loguru
  logging (from Python logging). Enable console and file logging with different log levels.
  Add logging documentation.

* Fix logging configuration and EOS configuration out of sync. Added tracking support
  for nested value updates of Pydantic models. This used to update the logging configuration
  when the EOS configurationm for logging is changed. Should keep logging config and EOS
  config in sync as long as all changes to the EOS logging configuration are done by
  set_nested_value(), which is the case for the REST API.

* Fix energy management task looping endlessly after the second update when trying to update
  the last_update datetime.

* Fix get_nested_value() to correctly take values from the dicts in a Pydantic model instance.

* Fix usage of model classes instead of model instances in nested value access when evaluation
  the value type that is associated to each key.

* Fix illegal json format in prediction documentation for PVForecastAkkudoktor provider.

* Fix documentation qirks and add EOS Connect to integrations.

* Support deprecated fields in configuration in documentation generation and EOSdash.

* Enhance EOSdash demo to show BrightSky humidity data (that is often missing)

* Update documentation reference to German EOS installation videos.

Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com>

2025-06-10 22:00:28 +02:00

28 KiB

Raw Blame History

Akkudoktor-EOS

Version: 0.0.1

Description: This project provides a comprehensive solution for simulating and optimizing an energy system based on renewable energy sources. With a focus on photovoltaic (PV) systems, battery storage (batteries), load management (consumer requirements), heat pumps, electric vehicles, and consideration of electricity price data, this system enables forecasting and optimization of energy flow and costs over a specified period.

Base URL: No base URL provided.

Endpoints:

POST /gesamtlast

Links: local, eos

Fastapi Gesamtlast

Deprecated: Total Load Prediction with adjustment.

Endpoint to handle total load prediction adjusted by latest measured data.

Total load prediction starts at 00.00.00 today and is provided for 48 hours.
If no prediction values are available the missing ones at the start of the series are
filled with the first available prediction value.

Note:
    Use '/v1/prediction/list?key=load_mean_adjusted' instead.
    Load energy meter readings to be added to EOS measurement by:
    '/v1/measurement/load-mr/value/by-name' or
    '/v1/measurement/value'

Request Body:

application/json: { "$ref": "#/components/schemas/GesamtlastRequest" }

Responses:

200: Successful Response
422: Validation Error

GET /gesamtlast_simple

Links: local, eos

Fastapi Gesamtlast Simple

Deprecated: Total Load Prediction.

Endpoint to handle total load prediction.

Total load prediction starts at 00.00.00 today and is provided for 48 hours.
If no prediction values are available the missing ones at the start of the series are
filled with the first available prediction value.

Args:
    year_energy (float): Yearly energy consumption in Wh.

Note:
    Set LoadAkkudoktor as provider, then update data with
    '/v1/prediction/update'
    and then request data with
    '/v1/prediction/list?key=load_mean' instead.

Parameters:

year_energy (query, required): No description provided.

Responses:

200: Successful Response
422: Validation Error

POST /optimize

Links: local, eos

Fastapi Optimize

Parameters:

start_hour (query, optional): Defaults to current hour of the day.
ngen (query, optional): No description provided.

Request Body:

application/json: { "$ref": "#/components/schemas/OptimizationParameters" }

Responses:

200: Successful Response
422: Validation Error

GET /pvforecast

Links: local, eos

Fastapi Pvforecast

Deprecated: PV Forecast Prediction.

Endpoint to handle PV forecast prediction.

PVForecast starts at 00.00.00 today and is provided for 48 hours.
If no forecast values are available the missing ones at the start of the series are
filled with the first available forecast value.

Note:
    Set PVForecastAkkudoktor as provider, then update data with
    '/v1/prediction/update'
    and then request data with
    '/v1/prediction/list?key=pvforecast_ac_power' and
    '/v1/prediction/list?key=pvforecastakkudoktor_temp_air' instead.

Responses:

200: Successful Response

GET /strompreis

Links: local, eos

Fastapi Strompreis

Deprecated: Electricity Market Price Prediction per Wh (€/Wh).

Electricity prices start at 00.00.00 today and are provided for 48 hours.
If no prices are available the missing ones at the start of the series are
filled with the first available price.

Note:
    Electricity price charges are added.

Note:
    Set ElecPriceAkkudoktor as provider, then update data with
    '/v1/prediction/update'
    and then request data with
    '/v1/prediction/list?key=elecprice_marketprice_wh' or
    '/v1/prediction/list?key=elecprice_marketprice_kwh' instead.

Responses:

200: Successful Response

GET /v1/admin/cache

Links: local, eos

Fastapi Admin Cache Get

Current cache management data.

Returns:
    data (dict): The management data.

Responses:

200: Successful Response

POST /v1/admin/cache/clear

Links: local, eos

Fastapi Admin Cache Clear Post

Clear the cache from expired data.

Deletes expired cache files.

Args:
    clear_all (Optional[bool]): Delete all cached files. Default is False.

Returns:
    data (dict): The management data after cleanup.

Parameters:

clear_all (query, optional): No description provided.

Responses:

200: Successful Response
422: Validation Error

POST /v1/admin/cache/load

Links: local, eos

Fastapi Admin Cache Load Post

Load cache management data.

Returns:
    data (dict): The management data that was loaded.

Responses:

200: Successful Response

POST /v1/admin/cache/save

Links: local, eos

Fastapi Admin Cache Save Post

Save the current cache management data.

Returns:
    data (dict): The management data that was saved.

Responses:

200: Successful Response

POST /v1/admin/server/restart

Links: local, eos

Fastapi Admin Server Restart Post

Restart the server.

Restart EOS properly by starting a new instance before exiting the old one.

Responses:

200: Successful Response

POST /v1/admin/server/shutdown

Links: local, eos

Fastapi Admin Server Shutdown Post

Shutdown the server.

Responses:

200: Successful Response

GET /v1/config

Links: local, eos

Fastapi Config Get

Get the current configuration.

Returns:
    configuration (ConfigEOS): The current configuration.

Responses:

200: Successful Response

PUT /v1/config

Links: local, eos

Fastapi Config Put

Update the current config with the provided settings.

Note that for any setting value that is None or unset, the configuration will fall back to
values from other sources such as environment variables, the EOS configuration file, or default
values.

Args:
    settings (SettingsEOS): The settings to write into the current settings.

Returns:
    configuration (ConfigEOS): The current configuration after the write.

Request Body:

application/json: { "$ref": "#/components/schemas/SettingsEOS" }

Responses:

200: Successful Response
422: Validation Error

PUT /v1/config/file

Links: local, eos

Fastapi Config File Put

Save the current configuration to the EOS configuration file.

Returns:
    configuration (ConfigEOS): The current configuration that was saved.

Responses:

200: Successful Response

POST /v1/config/reset

Links: local, eos

Fastapi Config Reset Post

Reset the configuration to the EOS configuration file.

Returns:
    configuration (ConfigEOS): The current configuration after update.

Responses:

200: Successful Response

GET /v1/config/{path}

Links: local, eos

Fastapi Config Get Key

Get the value of a nested key or index in the config model.

Args:
    path (str): The nested path to the key (e.g., "general/latitude" or "optimize/nested_list/0").

Returns:
    value (Any): The value of the selected nested key.

Parameters:

path (path, required): The nested path to the configuration key (e.g., general/latitude).

Responses:

200: Successful Response
422: Validation Error

PUT /v1/config/{path}

Links: local, eos

Fastapi Config Put Key

Update a nested key or index in the config model.

Args:
    path (str): The nested path to the key (e.g., "general/latitude" or "optimize/nested_list/0").
    value (Any): The new value to assign to the key or index at path.

Returns:
    configuration (ConfigEOS): The current configuration after the update.

Parameters:

path (path, required): The nested path to the configuration key (e.g., general/latitude).

Request Body:

application/json: { "anyOf": [ {}, { "type": "null" } ], "description": "The value to assign to the specified configuration path (can be None).", "title": "Value" }

Responses:

200: Successful Response
422: Validation Error

GET /v1/health

Links: local, eos

Fastapi Health Get

Health check endpoint to verify that the EOS server is alive.

Responses:

200: Successful Response

GET /v1/logging/log

Links: local, eos

Fastapi Logging Get Log

Get structured log entries from the EOS log file.

Filters and returns log entries based on the specified query parameters. The log
file is expected to contain newline-delimited JSON entries.

Args:
    limit (int): Maximum number of entries to return.
    level (Optional[str]): Filter logs by severity level (e.g., DEBUG, INFO).
    contains (Optional[str]): Return only logs that include this string in the message.
    regex (Optional[str]): Return logs that match this regular expression in the message.
    from_time (Optional[str]): ISO 8601 timestamp to filter logs not older than this.
    to_time (Optional[str]): ISO 8601 timestamp to filter logs not newer than this.
    tail (bool): If True, fetch the most recent log entries (like `tail`).

Returns:
    JSONResponse: A JSON list of log entries.

Parameters:

limit (query, optional): Maximum number of log entries to return.
level (query, optional): Filter by log level (e.g., INFO, ERROR).
contains (query, optional): Filter logs containing this substring.
regex (query, optional): Filter logs by matching regex in message.
from_time (query, optional): Start time (ISO format) for filtering logs.
to_time (query, optional): End time (ISO format) for filtering logs.
tail (query, optional): If True, returns the most recent lines (tail mode).

Responses:

200: Successful Response
422: Validation Error

PUT /v1/measurement/data

Links: local, eos

Fastapi Measurement Data Put

Merge the measurement data given as datetime data into EOS measurements.

Request Body:

application/json: { "$ref": "#/components/schemas/PydanticDateTimeData" }

Responses:

200: Successful Response
422: Validation Error

PUT /v1/measurement/dataframe

Links: local, eos

Fastapi Measurement Dataframe Put

Merge the measurement data given as dataframe into EOS measurements.

Request Body:

application/json: { "$ref": "#/components/schemas/PydanticDateTimeDataFrame" }

Responses:

200: Successful Response
422: Validation Error

GET /v1/measurement/keys

Links: local, eos

Fastapi Measurement Keys Get

Get a list of available measurement keys.

Responses:

200: Successful Response

GET /v1/measurement/load-mr/series/by-name

Links: local, eos

Fastapi Measurement Load Mr Series By Name Get

Get the meter reading of given load name as series.

Parameters:

name (query, required): Load name.

Responses:

200: Successful Response
422: Validation Error

PUT /v1/measurement/load-mr/series/by-name

Links: local, eos

Fastapi Measurement Load Mr Series By Name Put

Merge the meter readings series of given load name into EOS measurements at given datetime.

Parameters:

name (query, required): Load name.

Request Body:

application/json: { "$ref": "#/components/schemas/PydanticDateTimeSeries" }

Responses:

200: Successful Response
422: Validation Error

PUT /v1/measurement/load-mr/value/by-name

Links: local, eos

Fastapi Measurement Load Mr Value By Name Put

Merge the meter reading of given load name and value into EOS measurements at given datetime.

Parameters:

datetime (query, required): Datetime.
name (query, required): Load name.
value (query, required): No description provided.

Responses:

200: Successful Response
422: Validation Error

GET /v1/measurement/series

Links: local, eos

Fastapi Measurement Series Get

Get the measurements of given key as series.

Parameters:

key (query, required): Prediction key.

Responses:

200: Successful Response
422: Validation Error

PUT /v1/measurement/series

Links: local, eos

Fastapi Measurement Series Put

Merge measurement given as series into given key.

Parameters:

key (query, required): Prediction key.

Request Body:

application/json: { "$ref": "#/components/schemas/PydanticDateTimeSeries" }

Responses:

200: Successful Response
422: Validation Error

PUT /v1/measurement/value

Links: local, eos

Fastapi Measurement Value Put

Merge the measurement of given key and value into EOS measurements at given datetime.

Parameters:

datetime (query, required): Datetime.
key (query, required): Prediction key.
value (query, required): No description provided.

Responses:

200: Successful Response
422: Validation Error

GET /v1/prediction/dataframe

Links: local, eos

Fastapi Prediction Dataframe Get

Get prediction for given key within given date range as series.

Args:
    key (str): Prediction key
    start_datetime (Optional[str]): Starting datetime (inclusive).
        Defaults to start datetime of latest prediction.
    end_datetime (Optional[str]: Ending datetime (exclusive).

Defaults to end datetime of latest prediction.

Parameters:

keys (query, required): Prediction keys.
start_datetime (query, optional): Starting datetime (inclusive).
end_datetime (query, optional): Ending datetime (exclusive).
interval (query, optional): Time duration for each interval. Defaults to 1 hour.

Responses:

200: Successful Response
422: Validation Error

PUT /v1/prediction/import/{provider_id}

Links: local, eos

Fastapi Prediction Import Provider

Import prediction for given provider ID.

Args:
    provider_id: ID of provider to update.
    data: Prediction data.
    force_enable: Update data even if provider is disabled.
        Defaults to False.

Parameters:

provider_id (path, required): Provider ID.
force_enable (query, optional): No description provided.

Request Body:

application/json: { "anyOf": [ { "$ref": "#/components/schemas/PydanticDateTimeDataFrame" }, { "$ref": "#/components/schemas/PydanticDateTimeData" }, { "type": "object", "additionalProperties": true }, { "type": "null" } ], "title": "Data" }

Responses:

200: Successful Response
422: Validation Error

GET /v1/prediction/keys

Links: local, eos

Fastapi Prediction Keys Get

Get a list of available prediction keys.

Responses:

200: Successful Response

GET /v1/prediction/list

Links: local, eos

Fastapi Prediction List Get

Get prediction for given key within given date range as value list.

Args:
    key (str): Prediction key
    start_datetime (Optional[str]): Starting datetime (inclusive).
        Defaults to start datetime of latest prediction.
    end_datetime (Optional[str]: Ending datetime (exclusive).
        Defaults to end datetime of latest prediction.
    interval (Optional[str]): Time duration for each interval.
        Defaults to 1 hour.

Parameters:

key (query, required): Prediction key.
start_datetime (query, optional): Starting datetime (inclusive).
end_datetime (query, optional): Ending datetime (exclusive).
interval (query, optional): Time duration for each interval. Defaults to 1 hour.

Responses:

200: Successful Response
422: Validation Error

GET /v1/prediction/providers

Links: local, eos

Fastapi Prediction Providers Get

Get a list of available prediction providers.

Args:
    enabled (bool): Return enabled/disabled providers. If unset, return all providers.

Parameters:

enabled (query, optional): No description provided.

Responses:

200: Successful Response
422: Validation Error

GET /v1/prediction/series

Links: local, eos

Fastapi Prediction Series Get

Get prediction for given key within given date range as series.

Args:
    key (str): Prediction key
    start_datetime (Optional[str]): Starting datetime (inclusive).
        Defaults to start datetime of latest prediction.
    end_datetime (Optional[str]: Ending datetime (exclusive).
        Defaults to end datetime of latest prediction.

Parameters:

key (query, required): Prediction key.
start_datetime (query, optional): Starting datetime (inclusive).
end_datetime (query, optional): Ending datetime (exclusive).

Responses:

200: Successful Response
422: Validation Error

POST /v1/prediction/update

Links: local, eos

Fastapi Prediction Update

Update predictions for all providers.

Args:
    force_update: Update data even if it is already cached.
        Defaults to False.
    force_enable: Update data even if provider is disabled.
        Defaults to False.

Parameters:

force_update (query, optional): No description provided.
force_enable (query, optional): No description provided.

Responses:

200: Successful Response
422: Validation Error

POST /v1/prediction/update/{provider_id}

Links: local, eos

Fastapi Prediction Update Provider

Update predictions for given provider ID.

Args:
    provider_id: ID of provider to update.
    force_update: Update data even if it is already cached.
        Defaults to False.
    force_enable: Update data even if provider is disabled.
        Defaults to False.

Parameters:

provider_id (path, required): No description provided.
force_update (query, optional): No description provided.
force_enable (query, optional): No description provided.

Responses:

200: Successful Response
422: Validation Error

GET /visualization_results.pdf

Links: local, eos

Get Pdf

Responses:

200: Successful Response

28 KiB Raw Blame History

Akkudoktor-EOS

POST /gesamtlast

GET /gesamtlast_simple

POST /optimize

GET /pvforecast

GET /strompreis

GET /v1/admin/cache

POST /v1/admin/cache/clear

POST /v1/admin/cache/load

POST /v1/admin/cache/save

POST /v1/admin/server/restart

POST /v1/admin/server/shutdown

GET /v1/config

PUT /v1/config

PUT /v1/config/file

POST /v1/config/reset

GET /v1/config/{path}

PUT /v1/config/{path}

GET /v1/health

GET /v1/logging/log

PUT /v1/measurement/data

PUT /v1/measurement/dataframe

GET /v1/measurement/keys

GET /v1/measurement/load-mr/series/by-name

PUT /v1/measurement/load-mr/series/by-name

PUT /v1/measurement/load-mr/value/by-name

GET /v1/measurement/series

PUT /v1/measurement/series

PUT /v1/measurement/value

GET /v1/prediction/dataframe

PUT /v1/prediction/import/{provider_id}

GET /v1/prediction/keys

GET /v1/prediction/list

GET /v1/prediction/providers

GET /v1/prediction/series

POST /v1/prediction/update

POST /v1/prediction/update/{provider_id}

GET /visualization_results.pdf

28 KiB

Raw Blame History