Struct NumericTable 

pub struct NumericTable { /* private fields */ }

A table whose cells have all been validated as numeric (RFC-034 §4.4).

Produced by Table::try_numeric. Holds row-major f64 data ready to become a matten::Tensor via NumericTable::to_tensor.

Implementations

impl NumericTable

pub fn row_count(&self) -> usize

Number of rows.

pub fn column_count(&self) -> usize

Number of columns.

pub fn column_names(&self) -> &[String]

Column names, in column order.

pub fn to_tensor(&self) -> Result<Tensor, MattenDataError>

Build a numeric matten::Tensor with shape [rows, columns], row-major.

Errors with MattenDataError::EmptySelection if there are no columns, and wraps any core construction failure (for example a zero-length dimension when there are no rows) as MattenDataError::Matten.

Examples found in repository

examples/csv_to_tensor.rs (line 38)

fn main() -> Result<(), matten_data::MattenDataError> {
    // A small, messy table: a text column and one missing numeric cell.
    let csv = "\
region,sales,cost,quantity
north,100,40,5
south,150,,7
east,120,55,6";

    let table = Table::from_csv_str(csv)?;

    // Inspect what we have before converting anything.
    println!("{}", table.schema_summary());

    // Select only the numeric columns we want, fill the one missing cost with 0,
    // convert explicitly, and produce a [rows, columns] f64 tensor.
    let tensor = table
        .select_columns(["sales", "cost", "quantity"])?
        .fill_missing(0.0)?
        .try_numeric()?
        .to_tensor()?;

    println!("tensor shape: {:?}", tensor.shape());
    println!("tensor data : {:?}", tensor.as_slice());

    // 3 rows x 3 columns; the missing south/cost became 0.0.
    assert_eq!(tensor.shape(), &[3, 3]);
    assert_eq!(
        tensor.as_slice(),
        &[100.0, 40.0, 5.0, 150.0, 0.0, 7.0, 120.0, 55.0, 6.0]
    );
    println!("csv_to_tensor: OK");
    Ok(())
}

Trait Implementations

impl Clone for NumericTable

fn clone(&self) -> NumericTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NumericTable

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

Formats the value using the given formatter.