rdtools.soiling.annual_soiling_ratios

rdtools.soiling.annual_soiling_ratios(stochastic_soiling_profiles, insolation_daily, confidence_level=68.2)

Return annualized soiling ratios and associated confidence intervals based on stochastic soiling profiles from SRR. Note that each year may be affected by previous years' profiles for all SRR cleaning assumptions (i.e. method) except perfect_clean.

Parameters
  • stochastic_soiling_profiles (list) -- List of pd.Series representing profile realizations from the SRR monte carlo. Typically soiling_interval_summary['stochastic_soiling_profiles'] obtained with rdtools.soiling.soiling_srr() or rdtools.soiling.SRRAnalysis.run()

  • insolation_daily (pandas.Series) -- Daily plane-of-array insolation with DatetimeIndex. Arbitrary units.

  • confidence_level (float, default 68.2) -- The size of the confidence interval to use in determining the upper and lower quantiles reported in the returned DataFrame. (The median is always included in the result.)

Returns

DataFrame describing annual soiling rates.

Column Name

Description

'year'

Calendar year

'soiling_ratio_median'

The median insolation-weighted soiling ratio for the year

'soiling_ratio_low'

The lower edge of the confidence interval for insolation-weighted soiling ratio for the year

'soiling_ratio_high'

The upper edge of the confidence interval for insolation-weighted soiling ratio for the year

Return type

pandas.DataFrame