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). 从单月 BSRN 存档绘制一个 UTC 日（版式与手册单页相同）。

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. 未传 df 时的单月 .dat.gz 路径；传入 df 时可省略。

  • 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"). 要绘制的日历日（UTC）。

  • 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). 为 True 时在已有 flag* 列的分面上叠加失败点（此处不运行 QC；请先 qc_test()）。

  • output_file (str, optional) – If set, save the figure (e.g. ".pdf" or ".png") via plotnine. 若设置则保存图形（如 .pdf / .png）。

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

Returns:

p – The figure; display in notebooks with the last expression or call .draw(). 图形对象；笔记本中作为最后一行显示或调用 .draw()。

Return type:

plotnine.ggplot.ggplot