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)[source]#

Generate a monthly PDF booklet comparing measured irradiance with clear-sky models [1] [2] [3]. 生成月度 PDF 手册，对比实测辐照度与晴空模型结果。

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. 每天生成一页。每页三个面板：GHI、BNI、DHI。 实测为黑色实线；Ineichen、McClear、REST2 使用 Wong 配色并为虚线。

Parameters:

  • file_path (str) – Path to one BSRN station-to-archive monthly file (.dat.gz). 单个 BSRN 站点月文件路径（.dat.gz）。

  • output_file (str) – Output PDF path. 输出 PDF 路径。

  • station_code (str) – BSRN station abbreviation, used by clear-sky model calls. BSRN 站点缩写，用于晴空模型调用。

  • mcclear_email (str, optional) – Email required by McClear API. McClear API 所需邮箱。

  • df (pd.DataFrame, optional) – If provided, use this DataFrame instead of reading from file_path. 若提供，则使用该 DataFrame 而非读取 file_path。

  • title (str, optional) – Same title on every PDF page. If None (default), no plot title. 每页共用标题；默认 None 不显示。

Returns:

Save booklet to output_file. 将手册保存到 output_file。

Return type:

None

References