bsrn.visualization.calendar.plot_calendar#

bsrn.visualization.calendar.plot_calendar(df, output_file, 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).

Parameters:

  • df (pd.DataFrame) – Processed DataFrame with UTC DatetimeIndex and ‘zenith’ column.

  • output_file (str or None) – Path to save the output PDF. If falsy, the figure is not written to disk.

  • 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.

  • title (str, optional) – Plot title. If None (default), no title is drawn.