Struct Table 

pub struct Table { /* private fields */ }

Columnar data table (rows × named columns).

Analogous to VTK’s vtkTable. Each column is an AnyDataArray where the number of tuples is the number of rows.

Examples

use crate::data::{Table, AnyDataArray, DataArray};

let table = Table::new()
    .with_column(AnyDataArray::F64(DataArray::from_vec("x", vec![1.0, 2.0, 3.0], 1)))
    .with_column(AnyDataArray::F64(DataArray::from_vec("y", vec![4.0, 5.0, 6.0], 1)));
assert_eq!(table.num_rows(), 3);
assert_eq!(table.num_columns(), 2);
assert_eq!(table.value_f64(1, "x"), Some(2.0));

Implementations

impl Table

pub fn new() -> Self

pub fn add_column(&mut self, column: AnyDataArray)

Add a column. All columns must have the same number of tuples (rows).

pub fn num_rows(&self) -> usize

Number of rows.

pub fn num_columns(&self) -> usize

Number of columns.

pub fn column(&self, idx: usize) -> Option<&AnyDataArray>

Get column by index.

pub fn column_by_name(&self, name: &str) -> Option<&AnyDataArray>

Get column by name.

pub fn column_names(&self) -> Vec<&str>

Get column names.

pub fn columns(&self) -> &[AnyDataArray]

Iterate over columns.

pub fn value_f64(&self, row: usize, column_name: &str) -> Option<f64>

Get a single scalar value at (row, column_name).

pub fn filter_rows( &self, column_name: &str, predicate: impl Fn(f64) -> bool, ) -> Vec<usize>

Get row indices where a scalar column satisfies a predicate.

pub fn sort_by_column(&self, column_name: &str) -> Vec<usize>

Get row indices sorted by a column’s values (ascending).

pub fn select_rows(&self, indices: &[usize]) -> Table

Extract a subset of rows by indices, returning a new Table.

pub fn remove_column(&mut self, name: &str) -> Option<AnyDataArray>

Remove a column by name. Returns the removed column if found.

pub fn with_column(self, column: AnyDataArray) -> Self

Builder: add a column.

pub fn to_csv<W: Write>(&self, w: &mut W) -> Result<()>

Write the table as CSV to a writer.

use crate::data::{Table, AnyDataArray, DataArray};

let table = Table::new()
    .with_column(AnyDataArray::F64(DataArray::from_vec("x", vec![1.0, 2.0], 1)))
    .with_column(AnyDataArray::F64(DataArray::from_vec("y", vec![3.0, 4.0], 1)));
let mut buf = Vec::new();
table.to_csv(&mut buf).unwrap();
let csv = String::from_utf8(buf).unwrap();
assert!(csv.contains("x,y"));

pub fn from_csv<R: BufRead>(r: R) -> Result<Self, String>

Read a table from CSV. First line is header (column names). All values are parsed as f64.

pub fn write_csv_file(&self, path: &Path) -> Result<()>

Write CSV to a file path.

pub fn read_csv_file(path: &Path) -> Result<Self, String>

Read CSV from a file path.

Trait Implementations

impl Clone for Table

fn clone(&self) -> Table

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl DataObject for Table

fn field_data(&self) -> &FieldData

fn field_data_mut(&mut self) -> &mut FieldData

impl Debug for Table

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

Formats the value using the given formatter.

impl Default for Table

fn default() -> Table

Returns the “default value” for a type.

impl Display for Table

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

Formats the value using the given formatter.