Skip to content

PVGIS — available products#

The backend's product catalog (earthlens.pvgis.Catalog, loaded from the bundled pvgis_data_catalog.yaml) maps each product id to the PVGIS tool it drives, the REST endpoint, the default query params, and the canonical value columns. Select one with variables=["<id>"].

from earthlens.pvgis import Catalog

Catalog().available()        # -> ['seriescalc', 'tmy']
Catalog().get("seriescalc")  # -> Product(tool='seriescalc', endpoint='seriescalc', ...)

seriescalc — hourly radiation / PV power#

Hourly solar-radiation time series over the requested year window. Columns:

column description units
time timestamp (parsed to datetime64)
G(i) global irradiance on the inclined plane W/m²
H_sun sun height degree
T2m 2-m air temperature °C
WS10m 10-m wind speed m/s
Int 1 ⇒ radiation values reconstructed
P PV system power (only when pvcalculation=1) W

tmy — typical meteorological year#

An hourly multi-year synthesis (8760 hours). Columns:

column description units
time timestamp (normalised from PVGIS's time(UTC))
T2m 2-m air temperature °C
RH relative humidity %
G(h) global irradiance, horizontal plane W/m²
Gb(n) beam/direct irradiance, normal to sun W/m²
Gd(h) diffuse irradiance, horizontal W/m²
IR(h) surface infrared (thermal), horizontal W/m²
WS10m 10-m wind speed m/s
WD10m 10-m wind direction (0 = N, 90 = E) degree
SP surface (air) pressure Pa

Every returned frame also carries the lat, lon, and product tag columns the backend adds per sampled point.

Not in the MVP#

PVGIS exposes more tools (PVcalc grid-connected PV sizing, MRcalc monthly radiation, DRcalc daily radiation). The MVP ships the two tabular time-series tools above; the rest are catalog follow-ons.