Configuration on GbbOptimizer — Manual

Battery Forecast

Mon, 01 Jan 0001 00:00:00 +0000

Battery Forecast#

The central module of GbbOptimizer. It analyzes SOC of the battery for the next 24 hours (or more) based on PV charging, grid charging, discharging, and home consumption. It includes an optimizer that automatically selects charging and discharging parameters.

In this module you can:

Analyze the battery SOC forecast for the next 24 hours
See when SOC exceeds minimum or maximum values
Optimize charging and discharging plans
View purchase and sale prices and profits

Forecast Table Columns#

The table shows data for the next 24 hours. Abbreviations: DC = direct current, AC = alternating current.

Charging

Mon, 01 Jan 0001 00:00:00 +0000

Charging#

The charging module manages battery charging schedules from the grid. In Victron systems it controls the Schedules in the ESS module.

victron-only We assume that “Self-consumption above limit” is set to PV (not “PV & Battery”), because we want the schedule to stop battery discharging at night.

Fetch Schedule from Installation#

victron-only The program connects to the installation and retrieves 5 schedules (Schedulers).

Discharging

Mon, 01 Jan 0001 00:00:00 +0000

Discharging#

The discharging module controls when and how energy from the battery is sent to the grid or used to power the home. The key parameter is GridSetpoint.

GridSetpoint — how it works#

GridSetpoint determines how much energy should flow through the grid meter:

Positive value (e.g. +100 W) — the system draws energy from the grid. Surplus PV goes to the battery.
Negative value (e.g. -5000 W) — the system exports energy to the grid. First from PV, then from the battery.

Example 1: GridSetpoint = +100 W

Prices

Mon, 01 Jan 0001 00:00:00 +0000

Prices#

The energy purchase and sale price configuration module. Price data sources are set in installation parameters; the remaining parameters are configured here.

Purchase Price#

Formula:

1
2


Purchase Price = (Imported Price × Multiplier + Transmission Price + Transport Cost) × VAT/100
 + (Monthly Costs / number of hours in the month)

Component	Description
Imported Price	Fixed → 0. Dependent on imported prices and transport costs → price from the source specified in installation parameters. Dependent on sale prices → Sale Price
Multiplier	“Multiply imported Purchase Prices by”
Transmission Price	Price from the source specified in installation parameters (item “Transmission: Tariff for transmission prices”). 0 if none specified
Transport Cost	Price from the table under the “Change Transport Costs / fixed Purchase Prices” button
Monthly Costs	Sum of fixed purchase costs — spread evenly across all hours in the month

Sale Price#

Formula:

Consumption Profiles

Mon, 01 Jan 0001 00:00:00 +0000

Consumption Profiles#

The module for forecasting home energy consumption. Consumption is divided by hour and day of the week.

Manual Entry#

Enter kWh for each hour and day of the week directly in the table.

Importing Data from Installation#

Set the import period and press Import from Installation. The program calculates the average consumption for each hour and day of the week based on data from the inverter.

Automatic Import#

Check Automatically import data at night — the program imports data from the last 28 days every night.

Extra Consumption / EV

Mon, 01 Jan 0001 00:00:00 +0000

Extra Consumption / EV#

Extra Consumption is the portion of energy consumption that does not enter the home average — for example, charging an electric vehicle or a heat pump. The goal is to separate the unpredictable, variable part from standard consumption.

Data flow:

IoT meters → Extra Consumption → Gains → Battery Forecast
EV chargers → Extra Consumption → Gains → Battery Forecast

AutoConverter#

AutoConverter detects peaks in consumption and automatically converts them into vehicle charging (or another type of Extra Consumption).

Heat Pump / Air Conditioning

Mon, 01 Jan 0001 00:00:00 +0000

Heat Pump / Air Conditioning Forecast#

The module for forecasting heat pump (HP) or air conditioning consumption based on outdoor temperature.

Why a Separate Module?#

Heat pumps and air conditioning (like EV chargers) do not operate according to the rhythm of the day — they depend on temperature. It is therefore better to exclude them from the average in the Consumption Profiles module and place them in Extra Consumption.

Step-by-Step Configuration#

Enter latitude and longitude in installation parameters
Import the weather forecast
Press HP Parameters and enter the kWh consumption of the pump/AC for each hour (minimum 2 values for different temperatures)
Press Calculate HP forecast and check the results
Press Export HP forecast to Extra Consumption module (menu: Consumption Profiles → Extra Consumption → Filter: “Type” = “Heat Pump”)
Enable hourly tasks: Import weather forecast, Calculate HP forecast, Export HP forecast to Extra Consumption module

HP Parameters — Temperature vs. Consumption Table#

For each hour, enter how many kWh the HP/AC consumes at a given outdoor temperature.

Gains

Mon, 01 Jan 0001 00:00:00 +0000

Gains#

The module collects data from the installation and calculates photovoltaic gains. Import data manually at least once a day or check Automatically import data from Installation.

Data is displayed by hour, day, or month:

Hourly data — stored for 2 months
Daily data — stored for 2 years
Monthly data — stored permanently

Columns — Profit#

Column	Description
Day / Hour	Day and hour
Profit value	= Consumption Value - Inverter Value - (Purchase Value - Battery Value Change) + Sale Value
Profit / Consumption	KPI: Profit value / Consumption kWh
Profit / Solar	KPI: Profit value / PV kWh
Energy cost	Purchase Value - Sale Value
From grid (kWh)	How much drawn from the grid
From grid balanced (kWh)	Drawn after hourly balancing (for Poland)
Purchase Price	Energy purchase price
Purchase Value	From grid [balanced] × Purchase Price + Monthly Cost
Purchase / Production	KPI: Purchase Value / Consumption Value
(Purchase - Sale) / Production	KPI: what percentage of the energy bill you will pay
To grid (kWh)	How much sent to the grid
To grid balanced (kWh)	Sent after hourly balancing (for Poland)
Sale Price	Energy sale price
Sale Value	To grid [balanced] × Sale Price − Value of energy sent to grid
Consumption (kWh)	Home electricity consumption
Consumption Price	Price of energy consumed by the home (including inverter)
Consumption Value	Consumption kWh × Consumption Price
Inverter Consumption (kWh)	Electricity consumption by the inverter
Inverter Value	Inverter Consumption kWh × Consumption Price
Self-consumption	KPI: 1 - (To grid kWh / PV kWh) — how much PV energy does not go to the grid
Self-sufficiency	KPI: PV / Consumption — what % of energy from PV covers consumption
RTE	KPI: To grid kWh / (From grid kWh + PV kWh - Consumption kWh)
PV (kWh)	PV production
To battery (kWh)	Energy sent to the battery (before DC conversion)
min/max/avg SOC (%)	Minimum, maximum, and average battery SOC

Columns — Battery Energy Value#

Column	Description
Start SOC (%)	Starting SOC (calculated from MinSOC and MaxSOC if not provided by the installation)
End SOC (%)	Ending SOC
Battery Change (kWh)	>0 charging, <0 discharging — calculated from EndSOC - StartSOC
Grid charging (kWh)	Energy used to charge from the grid (AC side)
PV charging (kWh)	Energy used to charge from PV (AC side)
Charging losses (kWh)	Difference between DC and AC during charging
Charging efficiency (%)	1 - Losses / (Grid charging + PV charging)
Discharge to grid (kWh)	Battery energy to grid (AC)
Discharge to consumption (kWh)	Battery energy to home (AC)
Discharge losses (kWh)	DC/AC difference during discharging
Discharge efficiency (%)	1 - Losses / (Discharge to grid + to consumption)
Start / End kWh in battery	Energy in battery above MinSOC
Start / End Value	Value of energy in the battery
Battery Value Change	Discharging: kWh × Average price (previous hour). Charging: kWh × Purchase Price
Average end price	End Value / End kWh in battery
MinSOC (%)	Stored value of “Minimum battery SOC %” from installation parameters

Columns — Extra Consumption#

Column	Description
Extra Consumption Price	Average kWh price: average of 0 (PV), Average battery price and Purchase Price (in usage proportions)
Electric vehicle (kWh / value)	Energy and value of EV charging
Heat pump (kWh / value)	Energy and value of heat pump
Other1 (kWh / value)	Energy and value of “Other1”
Other2 (kWh / value)	Energy and value of “Other2”