pyrad.graph.plot_timeseries#

pyrad.graph.plot_timeseries(tvec, data_list, fname_list, labelx='Time [UTC]', labely='Value', labels=None, title='Time Series', period=0, timeformat=None, colors=None, linestyles=None, markers=None, ymin=None, ymax=None, dpi=72)[source]#

Plot one or multiple time series.

Behavior#

  • Legacy single-time-vector mode:

    tvec = common_time_vector data_list = [series1, series2]

    All series are plotted against the same time vector.

  • Multi-time-vector mode:

    tvec = [time1, time2, time3] data_list = [series1, series2, series3]

    Each series is plotted against its corresponding time vector. This allows plotting time series with different temporal supports.

  • Grouped multi-timeseries mode:

    data_list = [[r1, r2, r3]]

    If tvec is also grouped in the same way:

    tvec = [[t1, t2, t3]]

    then each radar uses its own time vector.

    If tvec is a single vector, it is reused for all plotted series.

Parameters:

  • tvec (array-like of datetime, or list of array-like of datetime) – Either one common time vector or one time vector per plotted data series. Each time vector must have the same length as its corresponding value series.

  • data_list (list) – List of series, or list of lists of series.

  • fname_list (list of str) – Output filenames.

  • labels (list of str or None) – Legend labels, one per plotted line. If None and grouped mode is detected, defaults to RADAR001, RADAR002, …

  • period (float) – Measurement period in seconds used to compute accumulation. If 0, no accumulation is computed.

  • timeformat (str, optional) – Datetime formatter string for x-axis.

  • colors, linestyles, markers (list, optional) – Styling per plotted line.

  • ymin, ymax (float, optional) – Y-axis limits.

  • dpi (int) – Figure DPI.

returns:

fname_list (list of str) – Output filenames.