act.qc.QCFilter.normalized_rradiance_test

QCFilter.normalized_rradiance_test(test, dni=None, dhi=None, ghi=None, test_assessment='Indeterminate', lat_name='lat', lon_name='lon', alt_name='alt', upper_total_transmittance_limit=1.6, upper_diffuse_transmittance_limit=1.0, use_dask=False)

Method to apply Normalized Irradiance Tests tests and add results to ancillary quality control variable. Need to provided variable name for each measurement for the test to be performed. All radiation data must be in W/m^2 units. All results from tests are set in ancillary quality control varibles for dni and dhi.

testlist or str

Type of tests to apply. Options include: ‘Clearness index’, ‘Upper total transmittance’, ‘Upper direct transmittance’, ‘Upper diffuse transmittance’

dnistr

Variable name in Dataset for direct normal irradiance

dhistr

Variable name in Dataset for diffuse hemipheric irradiance

ghistr

Variable name in Dataset for global hemispheric irradiance. Used in ‘Upper direct transmittance’ test only.

test_assessmentstr

Test assessment string value appended to flag_assessments attribute of QC variable.

lat_namestr

Variable name in the Dataset for latitude

lon_namestr

Variable name in the Dataset for longitude

alt_namestr

Variable name in the Dataset for altitude. Used in ‘Upper direct transmittance’ test.

upper_total_transmittance_limitfloat

Limit value used in ‘Upper total transmittance’ test. Values larger than this will be flagged.

upper_diffuse_transmittance_limitfloat

Limit value used in ‘Upper diffuse transmittance’ test. Values larger than this will be flagged.

use_daskboolean

Option to use Dask for processing if data is stored in a Dask array

References

Sengupta, Manajit, Habte, Aron, Wilbert, Stefan , Christian Gueymard, Jan Remund, Elke Lorenz,

Wilfried van Sark, and Adam R. Jensen “Best Practices Handbook for the Collection and Use of Solar Resource Data for Solar Energy Applications: Fourth Edition” (2024).

Examples

ds = act.io.arm.read_arm_netcdf(act.tests.EXAMPLE_BRS, cleanup_qc=True)
ds.qcfilter.normalized_rradiance_test(
    ['Clearness index', 'Upper total transmittance',
     'Upper direct transmittance', 'Upper diffuse transmittance'],
    dhi='down_short_diffuse_hemisp',
    ghi='down_short_hemisp',
    dni='short_direct_normal'
)