Struct RootSource 

pub struct RootSource { /* private fields */ }

Event source backed by one or more ROOT TTrees.

Implementations

impl RootSource

pub fn open(pattern: impl AsRef<str>) -> LadduDataResult<Self>

Opens files matching a glob with default options.

Errors

Returns LadduDataError when the glob is invalid or empty, a ROOT file or tree cannot be read, or schemas are incompatible.

pub fn builder(pattern: impl AsRef<str>) -> RootSourceBuilder

Creates a configurable source builder for a file glob.

pub fn files(&self) -> &[Arc<PathBuf>]

Returns matched files in global row order.

pub fn tree_name(&self) -> &str

Returns the selected TTree name.

pub fn tree_names(path: impl AsRef<Path>) -> LadduDataResult<Vec<Name>>

Lists TTrees in one ROOT file.

Errors

Returns LadduDataError when the ROOT file cannot be opened or read.

pub fn columns( path: impl AsRef<Path>, tree: Option<&str>, ) -> LadduDataResult<Vec<RootColumnInfo>>

Lists branch metadata for a selected or first TTree.

Errors

Returns LadduDataError when the file or tree cannot be read, no tree exists, or branch metadata is invalid.

Trait Implementations

impl Clone for RootSource

fn clone(&self) -> RootSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RootSource

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

Formats the value using the given formatter.

impl EventSource for RootSource

fn schema(&self) -> LadduDataResult<Arc<Schema>>

Returns the source schema.

fn capabilities(&self) -> SourceCapabilities

Returns optional source capabilities.

fn num_events(&self) -> LadduDataResult<Option<u64>>

Returns the exact event count when cheaply available.

fn batches( &self, plan: ReadPlan, ) -> LadduDataResult<Box<dyn Iterator<Item = LadduDataResult<EventBatch>> + Send>>

Opens a batch iterator using plan.

fn weighted_total(&self) -> LadduDataResult<Option<f64>>

Returns the exact sum of event weights when cheaply available.

impl FragmentedSource for RootSource

type Key = RootFragmentKey

Source-specific fragment key.

fn fragments(&self) -> LadduDataResult<Vec<DataFragment<Self::Key>>>

Lists all fragments in global row order.

fn read_fragment_range( &self, key: &Self::Key, local_start: usize, local_len: usize, chunk_size: Option<usize>, ) -> LadduDataResult<Box<dyn Iterator<Item = LadduDataResult<EventBatch>> + Send>>

Reads a contiguous range within one fragment.