Forecast PV generation potential (Sugra derived)
Forecast photovoltaic yield at any coordinate in the Caucasus region, computed by Sugra from the Sugra Earth forecast spine's shortwave radiation (GHI) and 2 m temperature via a clean-room irradiance-to-PV chain: NOAA/Spencer solar position, Erbs GHI->DNI/DHI decomposition, Hay-Davies plane-of-array transposition, Faiman cell temperature and a PVWatts derated DC + inverter-clipped AC model. Returns a 3-hourly per-kWp AC series to 48 h (with absolute kW/kWh when capacity_kwp is given) plus optional cross-check against observed SARAH-3 radiation. Regional (Caucasus) in v1 - worldwide forecast PV is pending dedicated compute. Modelled potential, not metered generation.
Query parameters
Latitude, decimal degrees (Caucasus box in v1).
Latitude, decimal degrees (Caucasus box in v1).
Longitude, decimal degrees (Caucasus box in v1).
Longitude, decimal degrees (Caucasus box in v1).
Panel tilt from horizontal, degrees. Default = latitude tilt.
Panel tilt from horizontal, degrees. Default = latitude tilt.
Panel azimuth clockwise from north (180 = equator-facing/south).
Panel azimuth clockwise from north (180 = equator-facing/south).
Installed DC capacity, kWp. Absent -> per-kWp output only; present -> absolute kW/kWh too.
Installed DC capacity, kWp. Absent -> per-kWp output only; present -> absolute kW/kWh too.
Aggregate PVWatts system loss fraction (soiling/mismatch/wiring/availability).
Aggregate PVWatts system loss fraction (soiling/mismatch/wiring/availability).
Module technology, sets the temperature coefficient (c_si -0.0040, cdte -0.0025, cigs -0.0036 /K).
Explicit temperature coefficient of power (per K); overrides the tech default.
Explicit temperature coefficient of power (per K); overrides the tech default.
Ground albedo for the reflected plane-of-array term.
Ground albedo for the reflected plane-of-array term.
DC:AC ratio; AC is clipped at nameplate/dc_ac_ratio.
DC:AC ratio; AC is clipped at nameplate/dc_ac_ratio.
Constant inverter efficiency.
Constant inverter efficiency.
Forecast horizon in hours (3-hourly steps); capped at 48.
Forecast horizon in hours (3-hourly steps); capped at 48.
Plane-of-array model: hay_davies (anisotropic) or isotropic (Liu-Jordan).
Join observed SARAH-3 daily-mean GHI at the node as a directional sanity ratio (adds the SARAH-3 attribution).
Join observed SARAH-3 daily-mean GHI at the node as a directional sanity ratio (adds the SARAH-3 attribution).
Response
Successful Response
Example response
{
"data": {
"location": {
"tile": "40N_080W"
},
"cycle": "2026071106",
"series": [
{
"lead_hours": 24,
"valid_time": "2026-07-12T06:00:00Z",
"ghi_wm2": 420,
"dni_wm2": 560,
"dhi_wm2": 110,
"poa_wm2": 610,
"cell_temp_c": 38.5,
"ac_w_per_kwp": 520
}
],
"totals": {
"kwh_per_kwp": 6.2,
"kwh": 62,
"horizon_hours": 48
},
"config": {
"tilt_deg": 41,
"azimuth_deg": 180,
"albedo": 0.2,
"system_loss": 0.14,
"temp_coeff": -0.004,
"dc_ac_ratio": 1.15,
"inverter_eff": 0.96,
"decomposition": "erbs",
"transposition": "hay_davies",
"temp_model": "faiman"
},
"provenance": {
"institution": "noaa",
"model": "gfs",
"grid": "0p25",
"run": "2026-07-11T06:00:00Z",
"cycle": "2026071106"
},
"attribution": {
"attribution": [
{
"registry_key": "sugra/degree-days",
"source_name": "Sugra (computed)",
"licence": "CC-BY-4.0"
}
],
"effective_reexport": "allowed"
}
},
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}