Weather data
The automatic irradiance service and its fallback, your own hourly file and what it must contain, and how horizontal irradiance becomes in-plane.
Every energy figure the application reports is downstream of the in-plane irradiance at your site. There are two ways to supply it: an automatic fetch over the internet, or a full-year hourly file of your own. Both give the run twelve monthly values.
The choice is made at the top of the Energy Yield card on the Yield tab, under Weather Data Source. The two options are mutually exclusive tick boxes, and both feed the same pair of irradiance fields directly below them.

The two sources
| Option | What it gives you | What it needs |
|---|---|---|
| PVGIS API (auto-fetch) | In-plane irradiance for your position, tilt and orientation, fetched when you calculate | An internet connection. No key, no account. |
| Hourly GHI file (CSV) | A full year of your own hourly data, and optionally its own in-plane column and its own temperatures. The weather data correction does not apply to it | A file you supply |
PVGIS API (auto-fetch) is the shipped default.
Two abbreviations appear throughout, on the option labels and on the fields. GHI is global horizontal irradiance — what a sensor lying flat on the ground measures. GTI is global tilted irradiance, also called in-plane or plane-of-array irradiance — what a sensor lying in the plane of the modules measures. The second is the one that produces energy; the first is what most weather records contain.
The automatic service
Selecting the automatic option means nothing is fetched until you click Calculate Energy on the Yield tab, or Calculate energy on the Energy view. At that moment the application asks the service for the irradiance at your site latitude and longitude, at the array's tilt and orientation, and fills the irradiance fields with what comes back. Every click fetches again and overwrites what the fields held. The status line under the run buttons reads "Fetching irradiance from PVGIS…" while it waits, then "Irradiance fetched from PVGIS (EU JRC): GHI n | GTI n kWh/m²/yr | 12 monthly values".
The service is the EU Joint Research Centre's PVGIS. It needs an internet connection and nothing else — there is no API key to obtain and no account to register.
What makes it the better of the two automatic paths is that, on fixed tilt, it returns in-plane irradiance directly. The tilted-plane transposition has already been done, for your latitude, your tilt and your orientation, inside the service. On a tracker plant the application takes PVGIS's monthly horizontal irradiance and does its own single-axis tracker transposition. The hourly series is fetched at the same time, on a best-effort basis; it is what the time-series export and the monthly temperatures draw on.
The fallback
Coverage is not universal. When the service has no data for your site, the application falls back to NASA POWER, and the two are not equivalent:
| PVGIS | NASA POWER | |
|---|---|---|
| What it returns | In-plane irradiance, directly (fixed tilt) | Monthly horizontal irradiance climatology |
| How in-plane is obtained | Already in-plane (fixed tilt) | A simple isotropic tilt correction is applied to estimate it |
The fallback is therefore the less precise of the two. A monthly climatology is an average of many years rather than a representative year, and an isotropic tilt correction is the crudest of the tilt models — it treats diffuse light as arriving equally from every part of the sky, so it does not capture the circumsolar brightening a better model does.
The source line
Neither service is silent about which one you got. A source line sits under the two irradiance fields and names where the current values came from:
| Source line | Meaning |
|---|---|
| Source: — | Nothing fetched or loaded yet |
| Source: PVGIS (EU JRC) — auto fetched | The primary service answered |
| Source: NASA POWER — auto fetched | The primary service had no data and the fallback answered |
| Source: Auto-fetch failed — switch to GHI file (in red) | Neither service returned data |
Read it before quoting any energy number. The service named on the line is whichever one answered for your site.

If neither service returns data, the irradiance fields stay at zero and the source line turns red. That is a visible failure, not a silent fallback to a default irradiance. Check your internet connection and calculate again, or tick Hourly GHI file (CSV) and load a file.
Your own hourly file
Ticking Hourly GHI file (CSV) does two things at once: it reveals the row GHI file (CSV):, reading "No file loaded" beside a Browse… button, and it shows a format reminder titled Hourly GHI File — Required Format.


The reminder asks for exactly three columns, in this order:
| Position | Column | Unit |
|---|---|---|
| 1 | An hourly timestamp, such as 2023-01-01 00:30 | — |
| 2 | Global horizontal irradiance | W/m² |
| 3 | Ambient temperature | °C |
A full year is 8,760 rows — 365 days at hourly resolution. A header row is optional and detected automatically.
Note the unit on the irradiance column. The file carries irradiance in watts per square metre, one value per hour — not an hourly energy in Wh/m², and not a daily or monthly total. The two are numerically equal for hourly data, but they are not the same quantity, and the row interval this input expects is one hour.
After the file is read
The file row stops saying "No file loaded" and summarises what it found — the file name, the number of hours, the annual GHI, where the in-plane figure will come from, the average temperature, and a tick confirming that temperature data was loaded. The source line under the irradiance fields reads along the lines of "Source: Hourly file (8760 h) | GTI calculated after layout | Monthly T from file".
Two phrases on that line matter. GTI calculated after layout means the in-plane figure is derived from your horizontal column once the layout has fixed the tilt, so the GTI (in-plane) field fills in when you calculate, not when you browse. Monthly T from file confirms the temperature column has replaced the seasonal model, which the next section explains.
The file's path is saved with the project. If the file has moved or gone when you reopen the project, the row reads "Not found: …" ("Could not load: …" if it cannot be read). While Hourly GHI file (CSV) is selected the file is an input to the run, so a missing file, or one edited since the last run, marks the layout out of date until you generate again.
What the application actually accepts
The reminder describes the strictest form of the file. The application is more tolerant than that, in two ways worth knowing before you reformat anything.
Column names are matched flexibly. The order in the reminder is a safe default, but a named header is recognised whatever position it sits in:
| Quantity | Accepted column names |
|---|---|
| Time | time, datetime, date, timestamp, time(utc), time(local), date/time |
| Horizontal irradiance | ghi, g(h), gh, global_horizontal, global horizontal irradiance, irradiance, solar irradiance, allsky_sfc_sw_dwn |
| In-plane irradiance | gti, g(i), gi, in-plane irradiance |
An in-plane column is used directly. The third group above is not in the reminder at all, and it is the most valuable of the three. If your file already carries in-plane irradiance — because you bought a dataset generated for your specific tilt and orientation, or because you have measured it on a plane-of-array pyranometer — that column is used as it stands. No transposition is performed, and none of the modelling assumptions in the next section apply to your numbers.
Why the temperature column earns its place
The third column is easy to dismiss as optional detail. It is not.
When a temperature column is present, the monthly average temperatures used by the model come from your data. A PVGIS hourly fetch brings its own hourly temperature in the same way. With neither, they come from a sinusoidal seasonal model whose amplitude is scaled from the site's absolute latitude: a reasonable generic shape, but a generic one.
That matters because monthly performance ratio moves with module temperature, and module temperature is driven by ambient temperature. A monthly PR series built on measured ambient temperatures is defensible in a way that one built on a latitude-derived sine wave is not, and the monthly table on the Energy view is exactly the part of the output a technical reviewer reads line by line. See Temperature loss for the thermal model the temperatures feed.
How horizontal irradiance becomes in-plane
When the file carries only a horizontal column, the in-plane figure is derived in three steps.
Solar position
For each timestamp, the solar declination, the hour angle and the solar zenith angle are computed from the site latitude and the day of year. This fixes where the sun is in the sky for that hour.
Split the horizontal irradiance into beam and diffuse
A horizontal measurement is one number containing two physically different components: direct beam radiation from the sun's disc, and diffuse radiation from the rest of the sky. They transpose onto a tilted plane completely differently, so they must be separated first.
The split uses the Erbs (1982) correlation, which estimates the diffuse fraction from the clearness index — the ratio of the measured horizontal irradiance to the extraterrestrial irradiance on a horizontal plane at that moment. A low clearness index means an overcast hour, which is mostly diffuse; a high one means a clear hour, which is mostly beam.
Transpose onto the module plane
The two components are then projected onto the tilted plane with the Hay-Davies model:
GTI = Gb·Rb + Gd·(1+cos β)/2 + ρ·GHI·(1−cos β)/2| Term | What it is |
|---|---|
GTI | In-plane irradiance — the result |
Gb | The beam component on the horizontal plane |
Rb | The geometric ratio of beam irradiance on the tilted plane to beam irradiance on the horizontal plane |
Gd | The diffuse component on the horizontal plane |
β | The module tilt angle from horizontal |
ρ | The ground reflectance used inside the transposition — a fixed value of 0.20, not the Ground albedo (ρ) field on the card |
GHI | The measured horizontal irradiance |
The three terms are, in order: beam projected geometrically onto the plane, sky diffuse seen by the fraction of the sky the tilted plane faces, and light reflected from the ground into the plane.
Note which ρ this is. The transposition holds its own fixed ground reflectance
of 0.20 and is never handed the card's Ground albedo (ρ) field, so editing
that field does not move the in-plane figure. It changes the rear-side gain on a
bifacial plant and nothing else — see Bifacial modules.
Two assumptions the transposition makes
Both are recorded here because both are things a reviewer will ask about.
- Panels are assumed to face the equator — due south in the northern hemisphere, due north in the southern. There is no azimuth input to the transposition, so a deliberately off-axis array is not modelled.
- Timestamps are treated as local solar time. No time-zone offset or equation-of-time correction is applied to your file's timestamps. A file stamped in UTC for a site several time zones away will place the day's irradiance at the wrong solar hours.
Neither assumption applies when your file carries its own in-plane column, or when the automatic service returns in-plane irradiance directly.
Weather data correction
Weather data correction multiplies the year-one energy of modelled weather. It is the one input to the run that is not on the Yield tab: it sits under File ▸ Advanced settings… ▸ Yield ▸ Weather data. See Advanced settings.
| Field | Default | Range | What it does |
|---|---|---|---|
| Weather data correction | 1.05 | 0.8–1.3 | "Multiplies the year-1 energy of modelled weather." |

| Weather source | Correction used |
|---|---|
| PVGIS API (auto-fetch), whichever service answered | The setting: 1.05 by default |
| Hourly GHI file (CSV) | None: 1.0, because a measured file needs no correction |
It acts on the energy, not on the irradiance: the GHI and GTI fields show the source's figures, unmultiplied.
The setting is not shown on the Yield tab or the Energy view. The Workings view states it in the arithmetic of Year-1 energy, as "× 1.05 weather data correction", or "A measured hourly file: no weather data correction." with a file. Section 9.3 of the design report prints it as "× 1.05 on the year's energy" or "none".
After changing the setting, click Calculate Energy again: the next run reads it, as the setting's own label says, Yield · run the energy calculation again.
The irradiance fields
Two fields under Irradiance hold the annual figures. Both are filled automatically, by the fetch or from the file, and show the source's figures as published. Behind them the run works from the twelve monthly values that came with them.
| Field | Default | Range | What it does |
|---|---|---|---|
| GHI | 0.0, auto-filled | 0–3000 kWh/m²/yr | Annual global horizontal irradiance. Feeds the rear-side irradiance estimate on a bifacial plant. |
| GTI (in-plane) | 0.0, auto-filled | 0–3500 kWh/m²/yr | Annual in-plane irradiance: the sum of the twelve monthly values the run multiplies by each month's performance ratio. |
GTI (in-plane) is the one that sets the yield. To carry a purchased study's irradiance through the run, load it as an hourly file. Neither field marks the layout out of date.
The source line described above accompanies the pair. The Ground albedo (ρ) field further down the card belongs to the rear-side model rather than to these two figures; the ambient temperature, mounting type and wind speed between them belong to the thermal model on Temperature loss.
Which source to use
For an estimate that has to stand up to review, use your own data: a purchased typical meteorological year for the site coordinates, or measured data from a ground station near the site. If that dataset carries an in-plane column, it removes the transposition from the discussion entirely; if it carries a temperature column, it removes the seasonal temperature model too.
For a first pass, use the automatic service. It is a single click and needs nothing from you. Two layouts compared on the same site share the same irradiance.
The time-series export needs an hourly series. Twelve monthly values alone are not enough to build one, and the chart window then draws a smooth reconstruction rather than real weather. Load an hourly file, or fetch hourly data from the automatic service. See Charts and time series.
Where to go next
How yield is calculated
The energy model month by month, the performance ratio, specific yield, degradation and both capacity factors, the Yield tab that runs it, and the Energy view.
The loss breakdown
Every component of the performance ratio — inverter, cables, soiling, temperature, mismatch, shading, availability, transformer and other — with defaults and ranges.