Struct SeriesBuf 

pub struct SeriesBuf { /* private fields */ }

a time series for line_chart: (t, value) points in a ring that keeps the newest capacity (a full buffer drops its oldest point on push). Times never decrease (push refuses an earlier one, so every lookup is a binary search); a value that is not finite (NaN) is a gap where the line breaks. ver() changes with every change: a chart redraws only then.

Implementations

impl SeriesBuf

pub fn new(capacity: usize) -> SeriesBuf

an empty series that keeps the newest capacity points (at least one)

pub fn push(&mut self, t: f64, v: f64) -> bool

append a point (t: the time, or any x that never decreases; v NaN: a gap); false (nothing added) when t is not finite or earlier than the last point’s

pub fn clear(&mut self)

remove every point

pub fn len(&self) -> usize

the number of points

pub fn is_empty(&self) -> bool

no points

pub fn capacity(&self) -> usize

the most points it keeps

pub fn ver(&self) -> u32

changes with every push and clear (equal versions: equal points)

pub fn get(&self, i: usize) -> Option<(f64, f64)>

the i-th point, the oldest first

pub fn first(&self) -> Option<(f64, f64)>

the oldest point

pub fn last(&self) -> Option<(f64, f64)>

the newest point

pub fn iter( &self, ) -> impl DoubleEndedIterator<Item = (f64, f64)> + ExactSizeIterator + '_

the points, the oldest first

pub fn lower_bound(&self, t: f64) -> usize

the index of the first point at t or later (len() when there is none)

pub fn nearest(&self, t: f64) -> Option<usize>

the index of the point with a finite value nearest to t (of two as near the earlier)

pub fn min_max(&self) -> Option<(f64, f64)>

the smallest and the largest finite value (None without one); looks at every point

pub fn min_max_in(&self, t0: f64, t1: f64) -> Option<(f64, f64)>

the smallest and the largest finite value of the points with t0 <= t <= t1

pub fn columns(&self, t0: f64, t1: f64, n: usize) -> Vec<SeriesCol>

the points with t0 <= t <= t1 in n columns of equal width (t1 belongs to the last): per column the range of its values, its first and its last value. Columns without a point with a value are left out; the work is one pass over the points, the result at most n entries (plus one per gap)

Trait Implementations

impl Clone for SeriesBuf

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SeriesBuf

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.