Block PV Forecast As a presentation: PV forecast - functions and benefits at a glance, for customer meetings and training (arrow keys to browse, F for full screen).
This function block forecasts the yield of a photovoltaic system for today and the next three days, in quarter hours. It is based on the irradiance on the tilted module surface, retrieved for the project location from Open-Meteo – separately for every roof surface with its tilt and orientation. Cloud cover, sun position and season are already included.
If the measured yield is connected, the block compares forecast and measurement every hour and learns a correction factor from it – a global one and one for every hour of the day. Over time this compensates shading in the morning or evening, soiling and deviations in the system data. Yield and forecast are recorded per hour and per day.
The block is operated with the control Block PV Forecast: forecast, history, key figures and the learning settings. The block itself only holds the commissioning data.
The block replaces the former block PV Yield forecast.
| Retrieval hourly |
For every active roof surface the tilted irradiance in W/m² is retrieved from today 0:00 until the end of the third following day. The forecast of a quarter hour is the sum over all surfaces: power Wp × irradiance / 1000 × (1 − losses). If a retrieval fails, the previous forecast remains valid; the block retries after 5, 10, 20, 40 and then every 60 minutes. |
| Measurement every second |
The yield comes from the input Generation meter (difference) or, if it is not connected, from the input PV power (integrated). Meter jumps – for example after a device replacement – are discarded. |
| Learning every hour |
At the end of each hour the measured yield is compared with the forecast without learning factor. Learning only takes place if at least 80 % of the hour was measured, a noticeable yield was expected, the input Lock learning is not set and the system did not run at the inverter limit. Sunny hours count more than dull ones. An hourly factor applies after three learning steps, until then the global factor. Learning and learning rate are set in the control. |
| Recording | Per hour yield and forecast, per day the yield, the forecast at the start of the day and the learning factor. The data is kept for about three years. |
Latitude and longitude must be set in the project settings and the time zone of the controller must be correct. If the location is missing, the property page of the block shows a button to enter it.
Open-Meteo is free for non-commercial use. For customer installations an Open-Meteo subscription is intended; its key is entered in the parameter API key.
| PV | PV power | Measured power of the system, in the unit of the parameter Unit. Optional. |
| ZS | Generation meter | Generation meter reading in kWh or Wh. Optional; if connected, it takes precedence over the power. |
| LS | Lock learning | Greater than 0: this hour is not learned, for example during curtailment by the grid operator, snow or maintenance. |
| ER | Error | 1 = no valid forecast (no location, no roof surface or never retrieved successfully). |
| ZU | State | 0 = start, 1 = current, 2 = no location, 3 = no roof surface, 4 = last retrieval failed (forecast still valid), 5 = outdated (older than 6 hours), 6 = no data. |
| P0 | Forecast today | Yield of the whole day. For the input PV forecast today of the Block Storage Optimizer. |
| PR | Forecast today remaining | Yield from now until the end of the day. |
| P1 – P3 | Forecast tomorrow, day after tomorrow, in 3 days | Daily yield of the following days. P1 matches the input PV forecast tomorrow of the Block Storage Optimizer. |
| PA | Power now | Forecast of the current quarter hour. |
| PN | Next hour | Forecast of the next 60 minutes. |
| EI | Yield today | Yield measured so far today. |
| LF | Learning factor | Global learning factor, 1 = no correction. |
| AB | Deviation yesterday % | Measured yield of yesterday compared with the forecast at the start of the day, positive = more than forecast. |
The outputs are updated every minute and with every new forecast.
| Roof surfaces | Up to eight surfaces, each with name, power in Wp, tilt
(0° = flat, 90° = vertical), azimuth (0° = south, −90° = east,
90° = west, 180° = north), losses in % (cables, inverter, soiling,
heating; 10 to 15 % is typical) and active. An east-west system is
entered as two surfaces. The Direction column shows the compass direction of the azimuth set. A right-click on the direction opens a list of compass directions; the selection sets the azimuth. Each direction shows its azimuth in degrees: south (0°), southeast (−45°), east (−90°), northeast (−135°), north (180°), northwest (135°), west (90°), southwest (45°). For values in between, for example south-southeast, enter the azimuth directly (−22.5°). In the toolbar the arrows Up and Down move the selected surface within the list. The selection next to the arrows sets where the degree value has its 0°: 0° = South (default) or 0° = North. With north as 0°, north is 0°, east 90°, south 180° and west −90°. The orientation of the surfaces stays the same, only the numbers in the Azimuth column change; a tooltip gives the degrees of the four compass directions. The selection is remembered for the next time. |
| Unit | kW / kWh or W / Wh for the input PV power or meter and all power and energy outputs. Choose W / Wh for the Block Storage Optimizer. |
| Inverter max. | Maximum power of the inverters in kW (AC). The forecast is limited to it, and no learning takes place at the limit. 0 = no limit. |
| API key | Key of an Open-Meteo subscription. Empty = free access. |
| Diagnostics | Writes retrieval, learning steps and end of day to the controller log. |
A right click on the block leads directly to the control via Go to linked element.