Energy

Forecast PV generation potential (Sugra derived)

Changed on

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.

get/api/v2/energy/pv

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v2/energy/pv
  • Auth: API key in header x-api-key

Query parameters

latnumber required

Latitude, decimal degrees (Caucasus box in v1).

Example:41.7
lonnumber required

Longitude, decimal degrees (Caucasus box in v1).

Example:44.8
tiltnumber nullable

Panel tilt from horizontal, degrees. Default = latitude tilt.

azimuthnumber

Panel azimuth clockwise from north (180 = equator-facing/south).

capacity_kwpnumber nullable

Installed DC capacity, kWp. Absent -> per-kWp output only; present -> absolute kW/kWh too.

system_lossnumber

Aggregate PVWatts system loss fraction (soiling/mismatch/wiring/availability).

tech'c_si' | 'cdte' | 'cigs'

Module technology, sets the temperature coefficient (c_si -0.0040, cdte -0.0025, cigs -0.0036 /K).

temp_coeffnumber nullable

Explicit temperature coefficient of power (per K); overrides the tech default.

albedonumber

Ground albedo for the reflected plane-of-array term.

dc_ac_rationumber

DC:AC ratio; AC is clipped at nameplate/dc_ac_ratio.

inverter_effnumber

Constant inverter efficiency.

lead_hoursinteger

Forecast horizon in hours (3-hourly steps); capped at 48.

transposition'hay_davies' | 'isotropic'

Plane-of-array model: hay_davies (anisotropic) or isotropic (Liu-Jordan).

cross_checkboolean

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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes