bsrn.visualization.daily.plot_bsrn_daily_day#

bsrn.visualization.daily.plot_bsrn_daily_day(file_path, day, show_qc_markers=True, output_file=None, title=None, df=None)[source]#

Plot one UTC day from a single-month BSRN archive (same layout as each booklet page).

The frame (from df or loaded from file_path) must already include zenith and apparent_zenith (e.g. after BSRNDataset.solpos()).

Parameters:

  • file_path (str, optional) – Path to a single-month archive when df is not passed; otherwise ignored.

  • day (str, datetime.date, datetime.datetime, or pd.Timestamp) – Calendar day to plot (UTC), e.g. "2024-01-15" or pd.Timestamp("2024-01-15").

  • show_qc_markers (bool, default True) – If True, overlay QC failure markers where matching flag* columns exist (no QC is run here; use qc_test() first).

  • output_file (str, optional) – If set, save the figure (e.g. ".pdf" or ".png") via plotnine.

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

Returns:

p – The figure; display in notebooks with the last expression or call .draw().

Return type:

plotnine.ggplot.ggplot