Struct DataFrame 

pub struct DataFrame { /* private fields */ }

Column-major tabular data structure.

Stores named columns of typed data. All columns must have the same number of rows. Supports numeric, boolean, categorical, and text column types.

Example

use u_insight::dataframe::{DataFrame, Column, ValidityBitmap};

let mut df = DataFrame::new();
df.add_column(
    "x".to_string(),
    Column::numeric(vec![1.0, 2.0, 3.0], ValidityBitmap::all_valid(3)),
).unwrap();
df.add_column(
    "label".to_string(),
    Column::text(
        vec!["a".into(), "b".into(), "c".into()],
        ValidityBitmap::all_valid(3),
    ),
).unwrap();
assert_eq!(df.row_count(), 3);
assert_eq!(df.column_count(), 2);

Implementations

impl DataFrame

pub fn new() -> Self

Creates an empty DataFrame with no columns or rows.

pub fn add_column( &mut self, name: String, column: Column, ) -> Result<(), InsightError>

Adds a named column to the DataFrame.

Returns an error if the column length doesn’t match the existing row count (unless this is the first column).

pub fn row_count(&self) -> usize

Returns the number of rows.

pub fn column_count(&self) -> usize

Returns the number of columns.

pub fn is_empty(&self) -> bool

Returns true if the DataFrame has no columns.

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

Returns column names.

pub fn column(&self, index: usize) -> Option<&Column>

Returns a reference to the column at index.

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

Returns a reference to the column with the given name.

pub fn column_index(&self, name: &str) -> Option<usize>

Returns the index of the column with the given name.

pub fn iter(&self) -> impl Iterator<Item = (&str, &Column)>

Returns an iterator over (name, column) pairs.

pub fn schema(&self) -> Vec<(&str, DataType)>

Returns a summary of column data types.

pub fn total_null_count(&self) -> usize

Returns the total number of null values across all columns.

Trait Implementations

impl Clone for DataFrame

fn clone(&self) -> DataFrame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataFrame

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

Formats the value using the given formatter.

impl Default for DataFrame

fn default() -> Self

Returns the “default value” for a type.