Skip to content

Solar Forecast

Jump to bottom
Matthias Strubel edited this page Mar 1, 2025 · 11 revisions

The following providers are currently available:

Multiple Installations can be entered, like this:

solar_forecast_provider: fcsolarapi
pvinstallations:
  - name: Haus #name
    lat: 48.4334480
    lon: 8.7654968
    declination: 32 #inclination toward horizon 0..90 0=flat 90=vertical (e.g. wallmounted)
    azimuth: -90 # -90:East, 0:South, 90:West -180..180
    kWp: 15.695 # power in kWp
  - name: Garage  #... further installations
    lat: 48.4334480
    lon: 8.7654968
    declination: 32
    azimuth: 87
    kWp: 6.030

The name must be a unique value.

If a solar forecast provider is not available, batcontrol is running on cached values. It stops working if less then 18 hours of forecast are available. That should be enough to overcome outages.

Forecast.Solar (Default)

Forecast Solar allows a limited amount of free requests with no subscription or account.

The minimum configuration block is are:

  - name: Haus #name
    lat: 48.4334480
    lon: 8.7654968
    declination: 32 #inclination toward horizon 0..90 0=flat 90=vertical (e.g. wallmounted)
    azimuth: -90 # -90:East, 0:South, 90:West -180..180
    kWp: 15.695 # power in kWp

In addtion you can register and use an api key with adding:

  - name: Haus #name
    lat: 48.4334480
    lon: 8.7654968
    declination: 32 #inclination toward horizon 0..90 0=flat 90=vertical (e.g. wallmounted)
    azimuth: -90 # -90:East, 0:South, 90:West -180..180
    kWp: 15.695 # power in kWp
    api: ffff-ffff-fff-ffff

If you have an obstructed horizon, you can add a horizon modifier:

  - name: Haus #name
    lat: 48.4334480
    lon: 8.7654968
    declination: 32 #inclination toward horizon 0..90 0=flat 90=vertical (e.g. wallmounted)
    azimuth: -90 # -90:East, 0:South, 90:West -180..180
    kWp: 15.695 # power in kWp
    horizon: 30,30,30,0,0,0  # leave empty for default PVGIS horizon, only modify if solar array is shaded by trees or houses

Solarprognose.de

Solarprognose offers a free tier for installations below 10KW. Currently, larger tiers are available for free, but this may change. The provider is asking for donations. You need to register on their website and enter you installation. With using the provided API key, you can run batcontrol with following configuration:

solar_forecast_provider: solarprognose
pvinstallations:
  - name: Haus #name
    apikey: 44k4j5j5j5j5j6j6j6j6j6j6j6j6j6j6j6j6

This configuration delivers the forecast for the first defined location. The API provider asks to add project: <your@email.com> as an additional parameter, that he can contact a person in case of issues.

In addition you can change the algorithm using:

pvinstallations:
  - name: Haus #name
    apikey: 44k4j5j5j5j5j6j6j6j6j6j6j6j6j6j6j6j6
    algorithm: own-v1 # (Default is 'mosmix')

If you run multiple installations with you account or want to split up forecasts for reasons, you can use the ITEM and ID syntax.

  • item: <location|inverter|module_field>
  • token:

For further details see: [API description|(https://www.solarprognose.de/web/de/solarprediction/page/api)

Clone this wiki locally