Detailed Time-Series Results File ("TimeSeriesResults.tsv")

One of the output files from the cloud is the advanced output file "TimeSeriesResults.tsv". This file is only available when set to be exported via scripting. Below there is a description of the content of such file. The number of columns will depend on the type of simulation (2D or 3D), design considerations of the PV system (e.g., fixed-tilt or horizontal single-axis tracking; and monofacial or bifacial module technology) and diffuse irradiance model.

The table below identifies some of the variables as Case 0 or Case N. These refer to different shading cases. Each shading case represents shading results for a specific module along the height of a rack/tracker in either an unshaded or shaded row for the front and back sides of the modules.

Content of "TimeSeriesResults.tsv"

Variable name Description Design type Diffuse model
StartOfPeriod Timestamp for the start of the period. All All
PeriodInMinutes Duration of the period in minutes. All All
UTCDateTimeForSolarPos Timestamp in UTC used for the estimation of the solar position. All All
SolarAzimuth [deg] The sun's azimuth angle (in degrees) at UTCDateTimeForSolarPos. All All
SolarZenith [deg] The sun's zenith angle (in degrees) at UTCDateTimeForSolarPos. All All
TrackerCaseNRotation [deg] Rotation angle in degrees of the tracker case N. Horizontal single-axis trackers All
TrackerCaseNBacktrackingState Operational state of the backtracking algorithm for tracker case N. Horizontal single-axis trackers All
GHI [W/m2] Global horizontal irradiance in W/m2. All All
DHI [W/m2] Diffuse horizontal irradiance in W/m2. All All
DNI [W/m2] Direct normal irradiance in W/m2. All All
Albedo [1] Surface albedo in per unit. All All
solarAziAtStartOfPeriod [deg] The sun's azimuth angle (in degrees) at the start of the period. All All
solarZenithAtStartOfPeriod [deg] The sun's zenith angle (in degrees) at the start of the period. All All
solarAziAtEndOfPeriod [deg] The sun's azimuth angle (in degrees) at the end of the period. All All
solarZenithAtEndOfPeriod [deg] The sun's zenith angle (in degrees) at the end of the period. All All
POACase0FrontcosineAOI Cosine of the angle of incidence considered for the global plane-of-array irradiance reference case (case 0). Refers to the front side of the modules. All All
POACase0FrontAOI [deg] Angle of incidence considered for the global plane-of-array irradiance at the front of the module in reference case (case 0). All All
POACase0FrontExtraterrestrialIrradiance
[W/m2]		 Extraterrestrial irradiance (in W/m2) at time UTCDateTimeForSolarPos. All All
POACase0Fronta Coefficient a in Perez diffuse irradiance in the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0Frontb Coefficient b in Perez diffuse irradiance in the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0FrontairMass Air mass. Parameter used for the Perez diffuse irradiance model in the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0Frontbrightness Brightness value used for the Perez diffuse irradiance model in the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0FrontsunZenithCubed Value of the zenith cubes (power 3). Used within the Perez diffuse irradiance model. All Perez, PerezEmulatePVsyst
POACase0Frontclearness Sky's clearness. Parameter used within the Perez diffuse irradiance model. Refers to the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0FronthorizonCoefficientF2 Horizon coefficient F2 used for the Perez diffuse irradiance model. Refers to the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0FrontcircumsolarCoefficientF1 Circumsolar coefficient F1. Parameter used for the Perez diffuse irradiance model. Refers to the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0FrontisotropicDiffuse
[W/m2]		 Isotropic diffuse irradiance for the reference case. Refers to the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0FronthorizonDiffuse
[W/m2]		 Horizon diffuse irradiance for the reference case. Refers to the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0FrontnonCircumsolarIrradianceInInclinedPlane
[W/m2]		 Circumsolar irradiance in the tilted plane for the reference case. Refers to the front side of the modules. All Perez, PerezEmulatePVsyst
POACase0FrontcosTilt Cosine of the module (front side) tilt angle used in the Hay and Davies diffuse irradiance model. All Hay
POACase0FrontcosIncident Cosine of the sun's incident (front side) angle used in the Hay and Davies diffuse irradiance model. All Hay
POACase0FrontcosZenith Cosine of the solar zenith angle used in the Hay and Davies diffuse irradiance model. Refers to the front side of the modules. All Hay
POACase0FrontincidentZenithRatio Ratio of the sun's incident angle to the solar zenith angle used in the Hay and Davies diffuse irradiance model. Refers to the front side of the modules. All Hay
POACase0FrontanisotropyIndex Anisotropy index. Parameter in the Hay diffuse irradiance model. Refers to the front side of the modules. All Hay
POACase0FronttiltTerm Tilt term in the Hay and Davies diffuse irradiance model. Refers to the front side of the modules. All Hay
POACase0FrontPlaneOfArrayDiffuse
[W/m2]		 Diffuse plane-of-array irradiance for the reference case. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayDirect
[W/m2]		 Direct or beam plane-of-array irradiance for the reference case. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayReflected
[W/m2]		 Reflected irradiance in the plane of array for the reference case. Refers to the front side of the modules. All All
POACase0FrontTotalPOA
[W/m2]		 Total or global (effective) plane-of-array irradiance for the reference case. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayDirectAfterHorizon
[W/m2]		 Direct or beam plane-of-array irradiance for the reference case accounting for horizon losses. Refers to the front side of the modules. All All
POACase0FrontTotalPOAIncHorizon
[W/m2]		 Global plane-of-array irradiance for the reference case accounting for horizon losses. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayDirectIncSoiling
[W/m2]		 Direct or beam plane-of-array irradiance for the reference case accounting for soiling losses. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayDiffuseIncSoiling
[W/m2]		 Diffuse plane-of-array irradiance for the reference case accounting for soiling losses. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayReflectedIncSoiling
[W/m2]		 Reflected irradiance in plane of array for the reference case accounting for soiling losses. Refers to the front side of the modules. All All
POACase0FrontTotalPOAIncSoiling
[W/m2]		 Global plane-of-array irradiance for the reference case accounting for soiling losses. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayDirectIncIam
[W/m2]		 Direct or beam plane-of-array irradiance for the reference case accounting for incidence angle modifier (IAM) losses. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayDiffuseIncIam
[W/m2]		 Diffuse plane-of-array irradiance for the reference case accounting for incidence angle modifier (IAM) losses. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayReflectedIncIam
[W/m2]		 Reflected irradiance in plane of array for the reference case accounting for incidence angle modifier (IAM) losses. Refers to the front side of the modules. All All
POACase0FrontTotalPOAIncIam
[W/m2]		 Global plane-of-array irradiance for the reference case accounting for incidence angle modifier (IAM) losses. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayDirect
IncSpectral [W/m2]		 Direct or beam plane-of-array irradiance for the reference case accounting for spectral losses. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayDiffuse
IncSpectral [W/m2]		 Diffuse plane-of-array irradiance for the reference case accounting for spectral losses. Refers to the front side of the modules. All All
POACase0FrontPlaneOfArrayReflected
IncSpectral [W/m2]		 Reflected irradiance in plane of array for the reference case accounting for spectral losses. Refers to the front side of the modules. All All
POACase0FrontTotalPOAIncSpectral
[W/m2]		 Global plane-of-array irradiance for the reference case accounting for spectral losses. Refers to the front side of the modules. All All
POACase0BackcosineAOI Cosine of the angle of incidence considered for the global plane-of-array irradiance reference case (case 0). Refers to the back side of the modules. Bifacial modules All
POACase0BackAOI [deg] Angle of incidence considered for the global plane-of-array irradiance at the back of the module in reference case (case 0). Bifacial modules All
POACase0BackExtraterrestrialIrradiance
[W/m2]		 Extraterrestrial irradiance (in W/m2) at time UTCDateTimeForSolarPos. Bifacial modules All
POACase0Backa Coefficient a in Perez diffuse irradiance in the back side of the modules. Bifacial modules Perez, PerezEmulatePVsyst
POACase0Backb Coefficient b in Perez diffuse irradiance in the back side of the modules. Bifacial modules Perez, PerezEmulatePVsyst
POACase0BackairMass Air mass. Parameter used for the Perez diffuse irradiance model in the back side of the modules. Bifacial modules Perez, PerezEmulatePVsyst
POACase0Backbrightness Brightness value used for the Perez diffuse irradiance model in the back side of the modules. Bifacial modules Perez, PerezEmulatePVsyst
POACase0BacksunZenithCubed Cubed value of the solar zenith angle. Used as part of the Perez diffuse irradiance model. Bifacial modules Perez, PerezEmulatePVsyst
POACase0Backclearness Sky's clearness. Parameter used within the Perez diffuse irradiance model. Refers to the back side of the modules. Bifacial modules Perez, PerezEmulatePVsyst
POACase0BackhorizonCoefficientF2 Horizon coefficient F2 used for the Perez diffuse irradiance model. Refers to the back side of the modules. Bifacial modules Perez, PerezEmulatePVsyst
POACase0BackcircumsolarCoefficientF1 Circumsolar coefficient F1. Parameter used for the Perez diffuse irradiance model. Refers to the back side of the modules. Bifacial modules Perez, PerezEmulatePVsyst
POACase0FrontisotropicDiffuse
[W/m2]		 Isotropic diffuse irradiance for the reference case. Refers to the back side of the modules. All Perez, PerezEmulatePVsyst
POACase0FronthorizonDiffuse
[W/m2]		 Horizon diffuse irradiance for the reference case. Refers to the back side of the modules. All Perez, PerezEmulatePVsyst
POACase0FrontnonCircumsolarIrradianceInInclinedPlane
[W/m2]		 Circumsolar irradiance in the tilted plane for the reference case. Refers to the back side of the modules. All Perez, PerezEmulatePVsyst
POACase0FrontcosTilt Cosine of the module (back side) tilt angle used in the Hay and Davies diffuse irradiance model. Bifacial modules Hay
POACase0FrontcosIncident Cosine of the sun's incident (back side) angle used in the Hay and Davies diffuse irradiance model. Bifacial modules Hay
POACase0FrontcosZenith Cosine of the solar zenith angle used in the Hay and Davies diffuse irradiance model. Refers to the front side of the modules. Bifacial modules Hay
POACase0FrontincidentZenithRatio Ratio of the sun's incident angle to the solar zenith angle used in the Hay and Davies diffuse irradiance model. Refers to the front side of the modules. Bifacial modules Hay
POACase0FrontanisotropyIndex Anisotropy index. Parameter in the Hay diffuse irradiance model. Refers to the front side of the modules. Bifacial modules Hay
POACase0FronttiltTerm Tilt term in the Hay and Davies diffuse irradiance model. Refers to the front side of the modules. Bifacial modules Hay
POACase0BackPlaneOfArray
Diffuse [W/m2]		 Diffuse plane-of-array irradiance for the reference case. Refers to the back side of the modules. Bifacial modules All
POACase0BackPlaneOfArray
Direct [W/m2]		 Direct or beam plane-of-array irradiance for the reference case. Refers to the back side of the modules. Bifacial modules All
POACase0BackPlaneOfArray
Reflected [W/m2]		 Reflected irradiance in the plane of array for the reference case. Refers to the back side of the modules. Bifacial modules All
POACase0BackTotalPOA
[W/m2]		 Total or global (effective) rear-side irradiance before losses for the reference case. Refers to the back side of the modules. Bifacial modules All
POACase0BackPlaneOfArrayDirectAfterHorizon
[W/m2]		 Direct or beam plane-of-array irradiance for the reference case accounting for horizon losses. Refers to the back side of the modules. Bifacial modules All
POACase0BackTotalPOAIncHorizon
[W/m2]		 Global rear-side irradiance for the reference case accounting for horizon losses. Refers to the back side of the modules. Bifacial modules All
POACase0BackTotalPOAIncSoiling
[W/m2]		 Global rear-side irradiance for the reference case accounting for soiling losses. Refers to the back side of the modules. Bifacial modules All
POACase0BackPlaneOfArray
DirectIncIam [W/m2]		 Direct or beam plane-of-array irradiance for the reference case accounting for incidence angle modifier (IAM) losses. Refers to the back side of the modules. Bifacial modules All
POACase0BackPlaneOfArray
DiffuseIncIam [W/m2]		 Diffuse plane-of-array irradiance for the reference case accounting for incidence angle modifier (IAM) losses. Refers to the back side of the modules. Bifacial modules All
POACase0BackPlaneOfArray
ReflectedIncIam [W/m2]		 Reflected irradiance in plane of array for the reference case accounting for incidence angle modifier (IAM) losses. Refers to the back side of the modules. Bifacial modules All
POACase0BackTotalPOAIncIam
[W/m2]		 Global rear-side irradiance for the reference case accounting for incidence angle modifier (IAM) losses. Refers to the back side of the modules. Bifacial modules All
POACase0BackTotalPOAInc
BifacialShading [W/m2]		 Total or global rear-side irradiance for the reference case accounting for shading losses derived from the bifacial shade loss factor. Refers to the back side of the modules. Bifacial modules All
POACase0BackTotalPOAInc
TransmissionFactor [W/m2]		 Total or global rear-side irradiance for the reference case accounting for losses derived from the transmission factor. Refers to the back side of the modules. Bifacial modules All
ShadingCaseNDirectUnshaded
FractionOfSubModule		 The fraction of the sub-module that is un-shaded for case N. 2D calculations All
ShadingCaseNDirectUnshaded
FractionOfMostShadedCell		 The fraction of the bottom cell in the sub-module that is un-shaded for case N. 2D calculations All
ShadingCaseNSkyDiffuseMultiplier The proportion of the sky that is not obscured for case N. This is relative to the proportion of that that would be visable to the tilted plane, if the horizon was unobscured over the 180deg in-front of the array. 2D calculations All
ShadingCaseNGroundDiffuseShading
Multiplier		 Irradiance multiplier for case N to account for the ground being shaded and receiving less than the full DHI. 2D calculations All
ShadingCaseNGroundObscuration
Multiplier		 Irradiance multiplier for case N to account for adjacent rows blocking the view of the ground from the module. 2D calculations All
ShadingCaseNGroundBeamUnshaded
Fraction		 The fraction of the ground that is not shaded for case N, i.e., width of unshaded strip / pitch. 2D calculations All
ShadingCaseNGroundBeamShading
Multiplier		 Irradiance multiplier for case N to account for the beam shading of the ground and obscuration of the unshaded ground by other rows. 2D calculations All
ShadedPOAForCaseN
[W/m2]		 Shaded POA Irradiance for substring case N. Refers to the front side of the modules. 2D calculations All
MostShadedCellPOACaseN
[W/m2]		 POA irradiance at the most shaded cell in substring case N. Refers to the front side of the modules. 2D calculations All
shadedIrradianceForSubStringCaseN
[W/m2]		 Shaded irradiance for substring case N. 2D calculations All
irradianceAfterBifacialityFactor
ForSubStringCaseN [W/m2]		 Irradiance level after applying the bifaciality factor for substring case N 2D calculations with bifacial modules. All
irradianceAfterBifacialMismatch
ForSubStringCaseN [W/m2]		 Irradiance level after applying the bifacial mismatch losses factor for substring case N 2D calculations with bifacial modules. All
irradianceAfterTakingMostShadedCell
ForSubStringCaseN [W/m2]		 Irradiance considering the most shaded cell for substring case N. 2D All
TotalPowerFromStringMpps [W] The total array power based on the MPP of each string. All All