Struct Column 

pub struct Column { /* private fields */ }

A named value column: numbers, text or true/false values. Handed to TimeSeries::new, and read back with TimeSeries::column.

let s = TimeSeries::new("hosts", vec![0, 1000], vec![
    Column::required("cpu", vec![0.5, 0.7]),
    Column::optional("host", vec![Some("a"), None]),
    Column::required("up", vec![true, false]),
])?;
assert_eq!(s.column("host")?.kind(), ColumnKind::String);
assert_eq!(s.column("host")?.strings()?.get(0), Some("a"));
assert!(s.column("host")?.numbers().is_err()); // not a number column

Implementations

impl Column

pub fn required(name: impl Into<String>, values: impl Into<ColumnData>) -> Self

A column with no gaps: Vec<f64>, Vec<&str>, Vec<String>, Vec<bool> (or an array of them, or a built column). A gap (a non-finite number, or a None) is rejected when the series is built.

pub fn optional(name: impl Into<String>, values: impl Into<ColumnData>) -> Self

A column that may have gaps: as Column::required, or with Option values (vec![Some(1.0), None], [Some("a"), None]) where None is a gap. A non-finite number is a gap too.

pub fn optional_raw(name: impl Into<String>, values: Vec<f64>) -> Self

A number column that may have gaps, given as raw f64 where any non-finite value (NaN, ±inf) is a gap. The same as Column::optional with a Vec<f64>.

pub fn name(&self) -> &str

The column name.

pub fn is_required(&self) -> bool

true when the column may not have gaps.

pub fn kind(&self) -> ColumnKind

What the column holds: ColumnKind::Number, Decimal, String, Boolean or Array.

pub fn data(&self) -> &ColumnData

The values, whichever kind they are.

pub fn numbers(&self) -> Result<&Float64Column>

The values of a number column; an error for any other kind.

pub fn strings(&self) -> Result<&StringColumn>

The values of a text column; an error for any other kind.

pub fn decimals(&self) -> Result<&DecimalColumn>

The values of a decimal column; an error for any other kind.

pub fn booleans(&self) -> Result<&BooleanColumn>

The values of a true/false column; an error for any other kind.

pub fn arrays(&self) -> Result<&ArrayColumn>

The values of an array column; an error for any other kind.

Trait Implementations

impl Clone for Column

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 Column

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

Formats the value using the given formatter.

impl PartialEq for Column

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Column