Struct VariableCollection 

pub struct VariableCollection {
    pub variables: HashMap<String, SimpleVariable>,
    pub level: String,
    pub entities: StringEntities,
}

A collection of simple BIDS variables at a single level of the hierarchy.

Groups SimpleVariables by name, automatically merging variables with the same name and inferring the hierarchy level from the variable source (events→run, participants→dataset, etc.).

Supports variable lookup by name, wildcard pattern matching, entity-based filtering, and subset selection.

Corresponds to PyBIDS’ BIDSVariableCollection class.

Fields

variables: HashMap<String, SimpleVariable>

level: String

entities: StringEntities

Implementations

impl VariableCollection

pub fn new(vars: Vec<SimpleVariable>) -> Self

pub fn get(&self, name: &str) -> Option<&SimpleVariable>

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

pub fn match_variables(&self, pattern: &str, use_regex: bool) -> Vec<&str>

Match variable names against a pattern (regex or glob).

pub fn to_rows(&self) -> Vec<StringEntities>

Convert all variables to tabular rows (long format).

pub fn to_wide(&self) -> (Vec<String>, Vec<Vec<String>>)

Convert to wide format: each variable becomes a column. Returns (column_names, rows) where each row is a Vec<String>.

pub fn from_rows(rows: &[StringEntities], source: &str) -> Self

Create collection from tabular rows.

Trait Implementations

impl Clone for VariableCollection

fn clone(&self) -> VariableCollection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VariableCollection

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

Formats the value using the given formatter.

impl Default for VariableCollection

fn default() -> VariableCollection

Returns the “default value” for a type.