bsrn.visualization.calendar.plot_calendar#

bsrn.visualization.calendar.plot_calendar(df, output_file, station_code, meas_col=None, clear_col=None, other_cols=None, labels=None, title=None)[source]#

Plot a one-page calendar-style comparison for multiple irradiance series (up to 7). 生成单页日历样式对比图，展示多条辐照度时段序列（最多 7 条）。

Parameters:

  • df (pd.DataFrame) – Processed DataFrame with UTC DatetimeIndex and ‘zenith’ column. 已处理的 DataFrame，含 UTC DatetimeIndex 与 zenith 列。

  • output_file (str) – Path to save the output PDF. 保存 PDF 的路径。

  • station_code (str) – BSRN station code for the title. 用于标题的原站 BSRN 代码。

  • meas_col (str, optional) – Column name for measured data (plotted as solid line). 实测数据的列名（用实线绘制）。

  • clear_col (str, optional) – Column name for clear-sky data (plotted with line and ribbon). 晴空数据的列名（绘制线条与色带）。

  • other_cols (list of str, optional) – Additional column names to plot as solid lines. 要作为实线绘制的其他额外列名。

  • labels (list of str, optional) – Labels for the legend corresponding to provided columns in order: [meas_col, clear_col] + other_cols. If None, column names are used. 与 [实测, 晴空] + 其他列 对应的图例标签列表；为 None 时使用列名。

  • title (str, optional) – Plot title. If None (default), no title is drawn. 图标题；默认 None 不显示。