bsrn.visualization.clearsky_models.plot_clearsky_models_booklet

bsrn.visualization.clearsky_models.plot_clearsky_models_booklet(file_path, output_file, station_code, mcclear_email=None, df=None, title=None)

Generate a monthly PDF booklet comparing measured irradiance with clear-sky models [1] [2] [3].

One page is created per day. Each page has three panels for GHI, BNI, and DHI. Measured series is black solid; Ineichen, McClear, and REST2 are Wong colors and dashed.

Parameters:

• file_path (str) – Path to one BSRN station-to-archive monthly file (.dat.gz).

• output_file (str) – Output PDF path.

• station_code (str) – BSRN station abbreviation, used by clear-sky model calls.

• mcclear_email (str, optional) – Email required by McClear API.

• df (pd.DataFrame, optional) – If provided, use this DataFrame instead of reading from file_path.

• title (str, optional) – Same title on every PDF page. If None (default), no plot title.

Returns:

Save booklet to output_file.

Return type:

None

References

[1]

Ineichen, P., & Perez, R. (2002). A new airmass independent formulation for the Linke turbidity coefficient. Solar Energy, 73(3), 151-157.

[2]

Lefèvre, M., Oumbe, A., Blanc, P., Espinar, B., Gschwind, B., Qu, Z., et al. (2013). McClear: A new model estimating downwelling solar radiation at ground level in clear-sky conditions. Atmospheric Measurement Techniques, 6(9), 2403-2418.

[3]

Gueymard, C. A. (2008). REST2: High-performance solar radiation model for cloudless-sky irradiance, illuminance, and photosynthetically active radiation: Validation with a benchmark dataset. Solar Energy, 82(3), 272-285.