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 energy calculation works month by month. Each month's in-plane irradiation goes through that month's performance ratio and becomes energy; the twelve months add up to one year-one figure. That figure is then degraded across the plant lifetime and reported at three exceedance probabilities. Every input is a field you can see on the Yield tab, a value fetched and shown on screen, or a setting you can open, and the Workings view shows how the result was reached. That is what makes the output defensible.
One run gives one year-one energy. The Energy view, the Summary, the chart window, the time-series file and the design report all carry the same figure.
This page is the whole chain in order, the controls that run it, and every place the result appears. The sub-pages hold the detail behind each link in the chain.
What the calculation needs before it can run
Two things, and it will not produce a yield without either.
A generated layout. Plant capacity in kWp is the placed module count multiplied by the module wattage, so it does not exist until placement has run. See Your first layout. Everything else in the chain is a per-kWp figure that only becomes energy when it is multiplied by that capacity.
A site position. Latitude and longitude decide the solar geometry, the irradiance the weather source returns, the automatic tilt and the automatic row pitch. A Google Earth boundary file carries the position inside it. A CAD drawing or a raster image gets one in the Site reference window when it is loaded, from the drawing's own UTM coordinates or from the latitude and longitude you type.
A CAD or image boundary loaded as Layout only still produces a layout: the geometry is complete and the summary fills in. The site's location is unknown, though, so energy calculation is off. Calculate Energy is disabled, and its tooltip, the Yield tab's status line and the Energy view read "Energy yield is off: the site's location is unknown (layout only)." To get a yield, pick the file again and locate it. See CAD boundary and Image boundary.
The result also has to belong to the layout on screen. Energy is calculated for the last generated layout, so once an input changes and the layout is out of date, Calculate Energy is refused with "Regenerate the layout first: inputs changed since the last run." That includes every loss on this tab: changing a loss makes the whole layout out of date. Regenerate, then calculate again.
The Yield tab
Everything the calculation reads on screen sits on the Yield tab of the inputs, in two cards. The first runs the calculation; the second holds its inputs.

Run Energy Calculation
The card is greyed out until a layout exists.
| Control | What it does |
|---|---|
| Calculate Energy | Runs the whole chain below. With PVGIS API (auto-fetch) selected, every click also fetches the irradiance again. |
| 📊 Show Energy Chart | Opens the hourly and monthly chart window. It turns on after an energy run. See Charts and time series. |
| Interval: | The time step of the export beside it: 1 min, 10 min, 15 min, 30 min or 1 hour. Ships at 15 min. |
| Export TMY data CSV | Writes a full-year time series of irradiance and energy at the chosen interval. It turns on when hourly data exists. |
Under the buttons a status line reports what the run is doing and, when it has finished, what it found.

TMY is a typical meteorological year: a single representative year rather than a specific calendar year.
Energy Yield
The second card holds the inputs, top to bottom: the weather source and the irradiance figures, the site conditions the thermal model needs, the ground albedo, and then an ADVANCED block of three expanders. The expanders are collapsed when the tab opens, and each header carries a live one-line summary of what is inside it, so the defaults are visible without opening anything.
| Expander | Header summary on the defaults | Detail |
|---|---|---|
| Performance-ratio losses | ≈ 19.0 % combined | The loss breakdown |
| Degradation & lifetime | 0.40 %/yr · 30 yr | Lifetime, degradation and P-values |
| Uncertainty & exceedance | P50 / P75 / P90 | Lifetime, degradation and P-values |
The weather source and the irradiance fields are on Weather data; the ambient temperature, mounting type and wind speed on Temperature loss; the albedo on Bifacial modules.
One input to the run is not on the tab: Weather data correction, under File ▸ Advanced settings… ▸ Yield. See Weather data.
Running it
Generate the layout
Capacity comes from the placed modules, so Generate Layout comes first. The computed shading loss is also produced in that pass. See Row-to-row shading.
Click Calculate Energy
On the Yield tab, or on the Energy view, whose gold Calculate energy button is the same action. With the automatic source selected the status line reads "Fetching irradiance from PVGIS…" and then reports what came back, such as "Irradiance fetched from PVGIS (EU JRC): GHI n | GTI n kWh/m²/yr | 12 monthly values". If no service answers, the source line turns red: check your internet connection and calculate again, or load an hourly file.
Read the status line
When the run finishes the line under the buttons reports the performance ratio, the year-one energy, both capacity factors and the lifetime total, and notes that the monthly table has been updated:
"PR: 83.1% | Yr1: 96,080 MWh | CUF on DC: 20.2% | CUF on AC: — | 25yr: 2,721.3 GWh | Monthly table updated"
The full result is on the Energy view.

The chain, in order
1. In-plane irradiance
The calculation starts from GTI, global tilted irradiance: the irradiation arriving on the plane of the modules, in kWh/m². It is not the same quantity as GHI, global horizontal irradiance, which is what most weather records contain. GTI is the one that drives the yield.
The run takes twelve monthly GTI values. PVGIS, its NASA POWER fallback and an hourly file all give twelve. See Weather data.
2. Performance ratio
PR, the performance ratio, is the fraction of the energy a plant would produce if every module ran at its nameplate efficiency that it actually delivers to the grid. It is a dimensionless number below 1, and it carries every loss between the light hitting the glass and the energy leaving the plant: inverter conversion, cable resistance, soiling, module temperature, mismatch, shading, availability, transformer and the rest.
You do not enter PR. You enter the components, and PR follows from them. The
components are combined multiplicatively, as a product of the factors and of
one minus each loss, not as one minus their sum. Each month gets its own figure,
PR_m, because module temperature changes through the year. The relation,
component by component, is on The loss breakdown.
3. Each month's energy
E_m (MWh) = capacity_kWp × GTI_m (kWh/m²) × PR_m × gain / 1000
gain = LID × (1 + bifacial gain) × weather data correctioncapacity_kWp is the plant's installed DC capacity: the DC capacity (MWp)
row of the Summary view and the DC capacity chip, in kWp.
| Term in the gain | What it is |
|---|---|
LID | 1 − 1st year degradation ÷ 100. 1st year degradation ships at 1.0 % and accepts 0–10 %. It stands for the loss a module takes in its first year of exposure and never recovers, principally light-induced degradation. It is a one-off step, not a rate |
bifacial gain | The rear-side gain on a bifacial plant, zero otherwise. See Bifacial modules |
weather data correction | 1.05 by default for PVGIS and NASA POWER weather, 1.0 for an hourly file. See Weather data |
4. The year
Year 1 energy = Σ E_m
Year's GTI = Σ GTI_m
Year's PR = Σ(GTI_m × PR_m) / Σ GTI_mYear-one energy is the sum of the months, so it already carries first-year degradation, the bifacial gain and the correction. The year's performance ratio is the months' ratios weighted by their sunlight.
A run that has only a yearly irradiance figure, with no months, uses one
performance ratio for the year, with the entered temperature loss, in place of
the sum: Year 1 energy = capacity_kWp × GTI × PR × gain / 1000.
5. Specific yield
Specific yield = Year 1 energy / DC capacitySpecific yield is the year's energy per unit of installed DC capacity, in kWh/kWp: the IEC final yield. It is the figure to compare two designs on the same site with, because it is independent of how big the plant is. It includes first-year degradation, the bifacial gain and the correction, so it is not the same number as GTI multiplied by PR.
6. Every year after the first
Year n (n ≥ 2) = Year 1 energy × (1 − annual degradation %)^(n−1)Annual degradation ships at 0.4 %/yr and accepts 0–5 %/yr. It
compounds: the exponent is n − 1, so year 2 has taken one year of
degradation and the final year of a 30-year plant has taken 29.
Plant lifetime ships at 30 years and accepts 1–50. It sets how far the series runs.
7. Capacity factor, on DC and on AC
CUF on DC = Year 1 energy / (capacity_kWp × 8760) × 100 %
CUF on AC = Year 1 energy / (plant AC_kW × 8760) × 100 %CUF, the capacity utilisation factor, is year-one energy as a percentage of what the plant would generate running flat out at its rated capacity for every hour of the year. Both are worked out on the same year-one energy, against different capacities, and both are shown wherever a CUF appears.
Plant AC is the AC capacity you typed in
Simulation with AC Capacity while its cap is
on, and otherwise the installed inverter AC. Without an inverter file there is
no AC rating, so CUF on AC reads — with the note needs an OND file. On
a plant of several plots the total is all the energy over all the AC, and it
reads — if any plot lacks an AC. Tenders and PPAs state the CUF on the
contracted AC, so check which one a request means.
A worked run
The same plant of 50 MWp, GTI 2050 kWh/m²/yr, every other input at its default and no module file, from the two kinds of weather source:
| Weather | Year 1 (MWh) | PR (%) | Specific yield (kWh/kWp) | CUF on DC (%) | Correction |
|---|---|---|---|---|---|
| Twelve months from PVGIS | 87,111 | 81.76 | 1742.2 | 19.89 | 1.05 |
| Twelve months from an hourly file | 82,963 | 81.76 | 1659.3 | 18.94 | 1.0 |
The performance ratio is the same in both; the 5 % between the energies is the correction.
Degradation, worked from the shipped defaults
The table below is the output multiplier relative to the plant before any degradation, at 1.0 % first-year degradation and 0.4 %/yr annual degradation. The reported year-one energy is the second row.
| Year | Relation | Multiplier |
|---|---|---|
| Before degradation | — | 1.000 |
| 1 | 1 − 0.010 | 0.990 |
| 2 | 0.990 × 0.996 | 0.986 |
| 10 | 0.990 × 0.996⁹ | 0.955 |
| 30 | 0.990 × 0.996²⁹ | 0.881 |
On the shipped defaults, the final year of a 30-year plant generates about 88.1 % of what it would have generated before any degradation at all.
See Lifetime, degradation and P-values for how the same series is turned into the exceedance probabilities.
Monthly figures
The month-by-month table follows IEC 61724-1, the standard for PV system performance monitoring. Three quantities per month:
Y_r = H_i / G_STC reference yield, in hours
Y_f = E_AC / P_0 final yield, in kWh/kWp
PR_m = Y_f / Y_r monthly performance ratioH_iis the month's in-plane irradiation andG_STCthe standard test condition irradiance, soY_ris the number of equivalent full-sun hours in the month.E_ACis the month's AC energy andP_0the installed DC capacity, soY_fis the month's specific yield.
Monthly PR moves with module temperature, and module temperature moves with the month's ambient temperature and its own operating irradiance. Monthly ambient temperature comes from an hourly temperature series when the run has one, which a PVGIS hourly fetch or your file's temperature column can provide, and otherwise from a seasonal model scaled by latitude. A hot low-latitude site therefore shows its lowest monthly PR in the hottest months. The relations are on Temperature loss.
The Energy view
The result lives on the Energy view, one of the seven view tabs on the right of the window. See Views for the tabs and the tools beside them. If the result lands while another view is showing, the tab reads Energy • until you open it.
Before a run
The view opens with the title No energy result yet and a note that says what is missing. Before a layout it reads "Generate a layout first. Energy is calculated for the generated layout."; once a layout exists it reads "Uses the weather source and losses set on the Yield tab. With PVGIS selected, irradiance is fetched for the site (needs internet).", over a gold Calculate energy button that does what the Yield tab's button does. On a site loaded as layout only the note reads "Energy yield is off: the site's location is unknown (layout only)."

Two other states replace the result:
| State | What the view shows |
|---|---|
| The layout is out of date and no energy has been calculated | No energy result yet, with "Energy calculation is not available right now." and the button disabled |
| A Generate Layout has replaced the layout the energy belonged to | Layout regenerated, with "The energy result belonged to the previous layout, so it was cleared. Calculate energy again on the Yield tab for this layout." |
Every Generate that replaces a layout clears its energy result, even when no input changed; the Yield tab's status line then reads "Layout regenerated: calculate energy again for this layout."
After a run
Five tiles across the top carry the annual answer:
| Tile | Unit | What it is |
|---|---|---|
| Year-1 energy | MWh | The year-one energy from the chain above |
| Specific yield | kWh/kWp | Year-one energy over DC capacity |
| Performance ratio | % | The year's performance ratio |
| CUF on DC | % | Year-one energy against the DC capacity running all 8760 hours |
| CUF on AC | % | The same against the plant AC, or — with needs an OND file |
The tiles and the TOTAL / Annual row of the table below read the run's own figures, so they match the Summary, the chips and the design report exactly.
Under them is the monthly table, titled "Monthly Energy Breakdown — IEC
61724-1 — Year 1 (all plants combined)": twelve rows, Jan to Dec, and a
TOTAL / Annual row, in these columns:
| Column | What it holds |
|---|---|
| Month | Jan to Dec |
| GHI (kWh/m²) | Horizontal irradiation for the month |
| H_i (kWh/m²) | In-plane irradiation for the month |
| T_amb (°C) | The month's ambient temperature. — on the total row |
| T_cell (°C) | The month's module temperature from the Sandia relation. — on the total row |
| Y_r (h) | Reference yield: equivalent full-sun hours |
| Y_f (kWh/kWp) | Final yield: the month's specific yield |
| PR (%) | The monthly performance ratio |
| Energy (MWh) | The month's generation |
| CUF DC (%) | The month's capacity factor on DC |
| CUF AC (%) | The month's capacity factor on AC |
Two charts complete the view: In-plane irradiation (kWh/m², bars) and performance ratio (%, line) under the table, and Monthly energy, Year 1 (MWh) on the right. On a short window the irradiation chart steps aside to keep the table readable.
If an input changes after the run, the result stays on screen but greyed, under the banner Out of date. This energy was calculated for the last run, and 2 inputs have changed since. Regenerate the layout, then calculate energy again. Copy is disabled until then.

The view's tools, right of the view tabs, are Copy, which puts the monthly table on the clipboard for pasting into Excel, and Open in window. The second opens SolarLayout — Summary, a separate window whose Monthly energy (Year 1) tab holds the same table and follows the layout as it changes, so it can sit beside the plot on a second screen.

Where else the result appears
The Summary view. The Plant sheet carries the headline rows in its Capacity group and the rest in an Energy group that appears once energy is calculated. Before a run the Capacity group has none of these rows.
| Row | Group | What it holds |
|---|---|---|
| P50 energy, year 1 (MWh) | Capacity | Year-one energy at the first exceedance probability |
| CUF on DC (%) | Capacity | The capacity factor on DC |
| CUF on AC (%) | Capacity | The capacity factor on AC, or the reason needs an OND file |
| P75 energy, year 1 (MWh) | Energy | Year-one energy at the second exceedance probability |
| P90 energy, year 1 (MWh) | Energy | Year-one energy at the third |
| P50 energy, 25 years (MWh) | Energy | The lifetime total: every year from 1 to Plant lifetime, summed, at the first probability |
The three probability rows are named from your own settings. They read P50 / P75 / P90 because Exceedance prob. 1, 2 and 3 ship at 50.0, 75.0 and 90.0 %. Change any of them and the row name changes with it. Two results are therefore only comparable row for row if both were run with the same three probabilities: check the names, not the position.
The two lower probabilities are derived from the first through the combined uncertainty:
P75 = P50 × (1 − 0.674 × σ)
P90 = P50 × (1 − 1.282 × σ)σ is Combined uncertainty (1σ), which ships at 5.0 % and accepts
0.1–30.0 %. The multipliers are the standard normal deviates at those
exceedance levels.
The last row's name is fixed text, and the figure is not a 25-year one. The row reads P50 energy, 25 years (MWh) whatever the lifetime is set to, while the value beside it is the sum of every year from 1 to Plant lifetime, scaled to the first exceedance probability. On the shipped default lifetime of 30 years, the row named "25 years" therefore reports a 30-year total. Quote the figure as the lifetime total and state the lifetime you used alongside it.
The Workings view. The Energy group of Workings sets out Year-1 energy, CUF on DC and CUF on AC with their arithmetic and inputs, including the weather data correction. How? beside a Summary row opens it at that figure.
The plant chips. The row under every view carries a Year-1 P50 energy
chip, — before a run, which opens the Energy view when clicked. The status
bar never carries it.
The Yield tab's status line. After a run it reports the performance ratio, the year-one energy, both capacity factors and the lifetime total in one line. The lifetime figure there is the same as the Summary row, under the same fixed "25yr" label.
The design report. Section 9, Energy, of the design report in the deliverables package holds the basis, the monthly table and the losses. The full Summary row set is on the Summary view reference.
What this model is and is not
State these plainly to anyone reviewing the output, because they are the questions a careful reviewer asks.
It is a yield estimate from a monthly loss model, not an hourly plant simulation. Each month's result is that month's irradiation multiplied by a performance ratio and a capacity. Hourly data is used for the transposition from horizontal to in-plane irradiance, for the shading loss, for monthly temperatures when it carries them, and to spread the months over the chart and the export. The energy figure is not an hour-by-hour simulation of module, inverter and transformer behaviour, and it does not replace one.
Row-to-row shading is modelled; terrain and horizon shading are not. The near-shading loss is computed from your own row geometry, and tables falling inside the year-round shadow of a structure you place are cleared from the layout. Distant horizon profiles and shading from the site's own relief are not part of the model. See Row-to-row shading.
The result is only as good as the weather data behind it. Every number on this page is downstream of the irradiance. A monthly climatology average and a purchased site-specific typical meteorological year will not give the same answer. Check which source produced your irradiance before quoting the yield: the source line on the Yield tab names it.
The energy pages
Weather data
The automatic service, your own hourly file, the weather data correction, and how horizontal irradiance becomes in-plane
The loss breakdown
Every component of the performance ratio, with defaults and ranges
Temperature loss
The thermal model, the four mounting types, and the monthly loss
Row-to-row shading
Near-shading from your own geometry, and the Shadow View
Bifacial modules
Ground albedo and how rear-side irradiance is estimated
Lifetime, degradation and P-values
Degradation, plant lifetime, uncertainty and the exceedance probabilities
Charts and time series
The chart window, and the time-series export
Where to go next
Pile layout
Define the pile pattern of a full table, and of a half table, derived or your own, in the Pile layout window. Every pile is then counted, drawn and exported.
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.