pvanalytics.quality.irradiance.check_irradiance_consistency_qcrad#

pvanalytics.quality.irradiance.check_irradiance_consistency_qcrad(solar_zenith, ghi, dhi, dni, param=None, outside_domain=False)#

Check consistency of GHI, DHI and DNI using QCRad criteria.

Uses criteria given in 1 to validate the ratio of irradiance components. These tests are equivalent to the BSRN comparison tests 2.

Warning

Not valid for night time or low irradiance. When the input data fall outside the test domain, the returned value is set by the outside_domain parameter.

Parameters

  • solar_zenith (Series) – Solar zenith angle in degrees

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

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

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

  • param (dict, optional) – keys are ‘ghi_ratio’ and ‘dhi_ratio’. For each key, value is a dict with keys ‘high_zenith’ and ‘low_zenith’; for each of these keys, value is a dict with keys ‘zenith_bounds’, ‘ghi_bounds’, and ‘ratio_bounds’ and value is an ordered pair [lower, upper] of float.

  • outside_domain (scalar, default False) – Value to return when the tests are not applicable, i.e., when the input data fall outside the test domain.

Returns

  • consistent_components (Series) – True where ghi, dhi and dni components are consistent.

  • diffuse_ratio_limit (Series) – True where diffuse to GHI ratio passes limit test.

Notes

The QCRad algorithm checks that the input GHI is consistent with the component sum \(DNI \times \cos ( zenith ) + DHI\) of input DNI and DHI, and that the ratio \(\frac{DHI}{GHI}\) is reasonable.

In these two parts, the ghi_bounds are applied differently. In the components test, the bounds are applied to the component sum of diffuse and direct irradiance, whereas in the diffuse ratio test the bounds are applied to the measured ghi.

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

Examples using pvanalytics.quality.irradiance.check_irradiance_consistency_qcrad#

QCrad Consistency for Irradiance Data

QCrad Consistency for Irradiance Data

previous

pvanalytics.quality.irradiance.check_irradiance_limits_qcrad

next

pvanalytics.quality.irradiance.clearsky_limits