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='physical')#
Test for physical limits on GHI, DHI or DNI using the QCRad criteria.
Criteria from 1 and 2 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 ({'physical', 'extreme'} or dict, default 'physical') –
If string, must be either ‘physical’ or ‘extreme’, corresponding to the QCRAD QC limits. If dict, must have keys:
’ghi_ub’, ‘dhi_ub’, ‘dni_ub’: dicts with keys {‘mult’, ‘exp’, ‘min’} and float values.
’ghi_lb’, ‘dhi_lb’, ‘dni_lb’: float values.
- 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, vol. 2, no. 1. Bentham Science Publishers Ltd., pp. 23–37, Apr. 18, 2008. DOI: 10.2174/1874282300802010023.
- 2
C. N. Long and E. G. Dutton, “BSRN Global Network recommended QC tests, V2.0,” Baseline Surface Radiation Network (BSRN), Accessed: Oct. 24, 2024. [Online.] Available: https://bsrn.awi.de/fileadmin/user_upload/bsrn.awi.de/Publications/BSRN_recommended_QC_tests_V2.pdf
