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
`"Loss tree time-series.tsv"`	Breakdown of power output after adding individual effects, matching the order in the effects diagram
`"TimeSeriesResults.tsv"`	Detailed output from irradiance calculation (file size can get very large)

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.ReturnLossTreeTimeSeriesResults = true; Workbook.WorkbookSettings.ReturnDetailedTimeSeriesResults = 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 the EnergyCalculationInputs set one or more the following properties to true:
- ReturnPvSystFormatTimeSeriesResults
- ReturnLossTreeTimeSeriesResults
- ReturnDetailedTimeSeriesResults
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 contents
- LossTreeResults - the loss tree time-series file contents
- ResultsFile - the details time-series results 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.

Note

Customising the PVsyst format results time-series

When requesting the PVsyst format results time-series, by default all the columns below are provided in alphabetic order. However, users have the option to custom the time-series with two properties in the EnergyCalculationOptions object.

When interested in all the variables, use property ChoiceColumnsOrderPvSystFormatTimeSeries to define the order of the columns in the file. Choose "Calculation" for the columns to be in the calculation order (as listed below) or "Alphabetic" for the columns to be in alphabetic order.
When interested in specific variables, you can specify them in DesiredVariablesForPvSystFormatTimeSeries.
- Only the specified columns will be retrieved and their order kept. The variables definition is not case sensitive (e.g., one could write 'Albedo', 'albedo' or 'ALBEDO'; all three cases would return the Albedo column).

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	-
`Albedo`	Surface albedo	Yes
`AzSol`	The sun's azimuth	-
`HSol`	The sun's elevation	-
`BeamInc`	Direct irradiance in plane of array on the module front side	-
`DifSInc`	Diffuse irradiance in plane of array on the module front side	-
`Alb_Inc`	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 (angular) loss (`GlobHrz`-`GlobIAM`)	-
`IAMLossBak`	IAM (angular) loss in the rear side (for bifacial systems) for all solar components	Yes
`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	-
`DifSBack`	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
`BackNearShd`	Near shading loss on the rear side (for bifacial systems) for all solar components	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
`FShdBm`	Near shading factor on direct (beam) irradiance component	-
`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	-
`ModBin`	Power loss due to module power binning effects. Any power gain will be expressed as a negative value	Yes
`LIDLoss`	Power loss due to light induced degradation	-
`ModQual`	Power loss due to module quality. Any power gain will be expressed as a negative value	-
`MisLoss`	Power loss due to module mismatch	-
`ShdElec`	Power loss due to electrical mismatches caused by shading when interconnecting the PV modules as an array	-
`OP_Pmin`	Power loss due to minimum power threshold for all the optimizers in the array	-
`OP_Pmax`	Power loss due to power overload for all the optimizers in the array	-
`OP_Imax`	Power loss due to current overload for all the optimizers in the array	-
`OP_Oper`	Power loss due to efficiency for all the optimizers in the array	-
`I_Boost`	Optimizer current boost ratio. Average current scaling factor for the optimizers in the array	-
`U_Boost`	Optimizer voltage boost ratio. Average voltage scaling factor for the optimizers in the array	Yes
`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
`IArray`	The total current in the array	-
`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	-

"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. The table in Loss Tree Time-Series Results File provides information about the content of this file.

"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.