pvanalytics.quality.irradiance.check_irradiance_limits_qcrad#

pvanalytics.quality.irradiance.check_irradiance_limits_qcrad(solar_zenith, dni_extra, ghi=None, dhi=None, dni=None, limits=None)#

Test for physical limits on GHI, DHI or DNI using the QCRad criteria.

Criteria from 1 are used to determine physically plausible lower and upper bounds. Each value is tested and a value passes if value > lower bound and value < upper bound. Lower bounds are constant for all tests. Upper bounds are calculated as

\[ub = min + mult * dni\_extra * cos( solar\_zenith)^{exp}\]

Note

If any of ghi, dhi, or dni are None, the corresponding element of the returned tuple will also be None.

Parameters
  • solar_zenith (Series) – Solar zenith angle in degrees

  • dni_extra (Series) – Extraterrestrial normal irradiance in \(W/m^2\)

  • ghi (Series or None, default None) – Global horizontal irradiance in \(W/m^2\)

  • dhi (Series or None, default None) – Diffuse horizontal irradiance in \(W/m^2\)

  • dni (Series or None, default None) – Direct normal irradiance in \(W/m^2\)

  • limits (dict, default QCRAD_LIMITS) – for keys ‘ghi_ub’, ‘dhi_ub’, ‘dni_ub’, value is a dict with keys {‘mult’, ‘exp’, ‘min’} and float values. For keys ‘ghi_lb’, ‘dhi_lb’, ‘dni_lb’, value is a float.

Returns

  • ghi_limit_flag (Series) – True for each value that is physically possible. None if ghi is None.

  • dhi_limit_flag (Series) – True for each value that is physically possible. None if dni is None.

  • dni_limit_flag (Series) – True for each value that is physically possible. None if dni is None.

Notes

Copyright (c) 2019 SolarArbiter. See the file LICENSES/SOLARFORECASTARBITER_LICENSE at the top level directory of this distribution and at https://github.com/pvlib/pvanalytics/blob/master/LICENSES/SOLARFORECASTARBITER_LICENSE for more information.

References

1

C. N. Long and Y. Shi, An Automated Quality Assessment and Control Algorithm for Surface Radiation Measurements, The Open Atmospheric Science Journal 2, pp. 23-37, 2008.

Examples using pvanalytics.quality.irradiance.check_irradiance_limits_qcrad#

QCrad Limits for Irradiance Data

QCrad Limits for Irradiance Data