Cloud Time-Series Results Files
When an energy calculation is run in the cloud detailed time-series result files can be written to a folder specified by the user if chosen. They are not generated by default.
Files written
The files written (when run from the desktop application) are:
File | Description |
---|---|
"PVsystFormatResults.txt" |
Output file in PVsyst format |
"TimeSeriesResults.tsv" |
Detailed output from irradiance calculation (file size can get very large) |
"Loss tree time-series.tsv" |
Breakdown of power output after adding individual effects, matching the order in the effects diagram |
To choose to save these detailed time-series files:
If running from the SolarFarmer desktop application:
- Check the 'Save detailed time-series files' checkbox in the 'Run calculation' group and set the folder name
- In the Script Editor, set one or more of the following settings to true:
Workbook.WorkbookSettings.ReturnPvSystFormatTimeSeriesResults = true;
Workbook.WorkbookSettings.ReturnDetailedTimeSeriesResults = true;
Workbook.WorkbookSettings.ReturnLossTreeTimeSeriesResults = true;
- Run the calculation in the cloud
- The time-series files should appear in the folder you specified once the calculation has completed
If running directly from the API in a script
- In the
EnergyCalculationOptions
property in theEnergyCalculationInputs
set one or more the following properties to true:- ReturnPvSystFormatTimeSeriesResults
- ReturnDetailedTimeSeriesResults
- ReturnLossTreeTimeSeriesResults
- Run the calculation using the API
- Depending on what you have chosen to be generated, one or more of the following properties in the
ModelChainResponse
object returned will be populated with the file's contents:PvSystFormatResultsFile
- the PVsyst format results file contentsResultsFile
- the details time-series results file contentsLossTreeResults
- the loss tree time-series file contents
Time stamps
The time stamps in all the files from cloud calculations indicate the beginning of the time interval in the input solar resource data.
"PVsystFormatResults.txt"
This file contains inputs and calculation outputs in a file that is formatted like the time series output file from PVsyst. The content is not necessarily equivalent; there are many PVsyst variables that we don't save, and there are several new ones that are only written out by SolarFarmer.
If the variable names are the same as PVsyst names their meaning is the same.
If you can't find a PVsyst variable name, one of the SolarFarmer-only variables may be similar enough for your needs.
Variable name | Description | SolarFarmer-only |
---|---|---|
date |
The time stamp indicating the beginning of the time interval | - |
GlobHor |
Global horizontal irradiance defined via the solar resource input | - |
DiffHor |
Diffuse horizontal irradiance defined via the solar resource input or calculated with the decomposition model | - |
BeamHor |
Direct horizontal irradiance (GlobHor -DiffHor ) |
- |
T_Amb |
Ambient temperature | - |
WindVel |
Wind speed | - |
AzSol |
The sun's azimuth | - |
HSol |
The sun's elevation | - |
BeamInc |
Direct irradiance in plane of array on the module front side | - |
DiffSInc |
Diffuse irradiance in plane of array on the module front side | - |
AlbInc |
Reflected irradiance in plane of array on the module front side | - |
GlobInc |
Global irradiance in plane of array on the module front side | - |
GlobHrz |
Global irradiance in plane of array after horizon losses. Horizon losses only include losses for direct irradiance component | - |
HrzLoss |
Horizon loss (GlobInc -GlobHrz ) |
- |
GlobHrzIAM |
Global irradiance in plane of array after horizon and IAM losses on the module front side | Yes |
IAMLoss |
IAM loss (GlobHrz -GlobIAM ) |
- |
GlobHrzSlg |
Global irradiance in plane of array after horizon and soiling losses on the module front side | Yes |
SlgLoss |
Soiling loss (GlobHrz -GlobSlg ) |
- |
BmIncBk |
Direct irradiance in plane of array on the module back side, not including shading and IAM losses | - |
DiffSBack |
Diffuse irradiance in plane of array on the module back side, not including shading and IAM losses | - |
BackShd |
Structure shading loss at back side | - |
GlobBak |
Global irradiance on the back side after all effects are applied | - |
ShdLossTotal |
Global near shading loss for front and back side | Yes |
ShdDLssTotal |
Shading loss for the sky diffuse irradiance on the front and back side | Yes |
ShdALssTotal |
Shading loss for the reflected irradiance on the front and back side | Yes |
ShdBLssTotal |
Shading loss for the direct irradiance on the front and back side | Yes |
GlobShdTotal |
Global irradiance after horizon, near shadings, soiling, IAM and spectral effects, front and back side (==GlobEffTotal ) |
Yes |
GlobEffTotal |
Global irradiance after horizon, near shadings, soiling, IAM and spectral effects, front and back side (==GlobShdTotal ) |
Yes |
GlobGndShd |
Total irradiance arriving on the ground, taking account of shadings | Yes |
TArray |
Array temperature | - |
PhiAng |
Tracker rotation angle | - |
EArrNom |
Array nominal power at STC | - |
GIncLss |
Power loss due to irradiance level | - |
TempLss |
Power loss due to temperature level | - |
SpctCor |
Power loss due to spectral effects | - |
ShdElec |
Power loss due to electrical mismatches caused by shading when interconnecting the PV modules as an array | - |
ModQual |
Power loss due to module quality | - |
LIDLoss |
Power loss due to light induced degradation | - |
MisLoss |
Power loss due to module mismatch | - |
OhmLoss |
Power loss due to DC ohmic wiring | - |
EArrMPP |
Array virtual DC power at MPP after wiring and electrical mismatch losses | - |
IL_Oper |
DC/AC Power loss due to inverter efficiency | - |
IL_Pmin |
DC Power loss due to inverter minimum power | - |
IL_Vmin |
DC Power loss due to inverter minimum voltage | - |
IL_Vmax |
DC Power loss due to inverter maximum voltage | - |
IL_Pmax |
DC Power loss due to inverter maximum power | - |
IL_Night |
AC Power loss due to inverter night-time consumption | - |
InvLoss |
Total power loss due to inverter | - |
EOutInv |
Inverter AC output power after all losses | - |
EArray |
Inverter DC output power after considering all impacts of inverter limitations | Yes |
UArray |
Array voltage | - |
E_Avail |
AC output power after grid availability losses | - |
UnavLss |
Power loss due to grid unavailability | - |
EacOhmL |
Power loss due to AC ohmic wiring | - |
ETrfLss |
Power loss due to transformer | - |
E_Grid |
Power injected to the grid | - |
"TimeSeriesResults.tsv"
This advanced output file is only available when set to be exported via scripting. It contains detailed results of the irradiance calculation, including all the considered shading cases. The table in Detailed Time-Series Results File provides information about the content of this file, whose columns depend on the PV project design and diffuse irradiance model selected.
"Loss tree time-series.tsv"
This advanced output file is only available when set to be exported via scripting. It contains energy in kWh from each step in the calculation, adding the individual effects in the power output calculation as also shown in the effects diagram.