Struct Dataset 

pub struct Dataset { /* private fields */ }

A collection of events with optional metadata for name-based lookups.

Implementations

impl Dataset

pub fn events_local(&self) -> &[Event]

Borrow locally stored events.

When MPI is enabled, this slice contains only the current rank’s event ownership.

pub fn events_global(&self) -> Vec<Event>

Collect all events into a Vec using the default global iteration semantics.

When MPI is enabled, the returned vector is ordered like Dataset::iter and may include remotely owned events fetched on demand.

pub fn iter(&self) -> DatasetIter<'_>

Iterate over all events in the dataset. When MPI is enabled, this will visit every event across all ranks, fetching remote events on demand.

pub fn iter_global(&self) -> DatasetIter<'_>

Alias for Dataset::iter.

This preserves dataset-wide ordering under MPI.

pub fn metadata(&self) -> &DatasetMetadata

Borrow the dataset metadata used for name lookups.

pub fn metadata_arc(&self) -> Arc<DatasetMetadata>

Clone the internal metadata handle for external consumers (e.g., language bindings).

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

Names corresponding to stored four-momenta.

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

Names corresponding to stored auxiliary scalars.

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

Resolve the index of a four-momentum by name.

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

Resolve the index of an auxiliary scalar by name.

pub fn named_event(&self, index: usize) -> LadduResult<Event>

Borrow event data together with metadata-based helpers as an Event view.

pub fn named_event_global(&self, index: usize) -> LadduResult<Event>

Alias for Dataset::named_event.

pub fn get_event(&self, index: usize) -> Option<Event>

Retrieve a single event by index, returning None when out of range.

pub fn get_event_global(&self, index: usize) -> Option<Event>

Alias for Dataset::get_event.

This preserves the default global indexing semantics under MPI.

pub fn event(&self, index: usize) -> LadduResult<Event>

Retrieve a single event by index.

pub fn event_global(&self, index: usize) -> LadduResult<Event>

Alias for Dataset::event.

This preserves the default global indexing semantics under MPI.

pub fn p4_by_name(&self, event_index: usize, name: &str) -> Option<Vec4>

Retrieve a four-momentum by name for the event at event_index.

pub fn aux_by_name(&self, event_index: usize, name: &str) -> Option<f64>

Retrieve an auxiliary scalar by name for the event at event_index.

pub fn for_each_named_event_local<F>(&self, op: F)

where F: FnMut(usize, NamedEventView<'_>),

Iterate over all local events as metadata-aware columnar views.

pub fn event_view(&self, event_index: usize) -> NamedEventView<'_>

Retrieve a metadata-aware columnar event view by local index.

pub fn index_local(&self, index: usize) -> &Event

Get a reference to the EventData at the given index in the Dataset (non-MPI version).

Notes

This method is not intended to be called in analyses but rather in writing methods that have mpi-feature-gated versions. Most users should use Dataset::event instead:

let ds: Dataset = Dataset::new(events);
let event_0 = ds.event(0)?;

impl Dataset

pub fn new_local( events: Vec<Arc<EventData>>, metadata: Arc<DatasetMetadata>, ) -> Self

Create a new Dataset from a list of EventData (non-MPI version).

Notes

This method is not intended to be called in analyses but rather in writing methods that have mpi-feature-gated versions. Most users should just call Dataset::new instead.

pub fn new(events: Vec<Arc<EventData>>) -> Self

Create a new Dataset from a list of EventData.

This method is prefered for external use because it contains proper MPI construction methods. Constructing a Dataset manually is possible, but may cause issues when interfacing with MPI and should be avoided unless you know what you are doing.

pub fn new_with_metadata( events: Vec<Arc<EventData>>, metadata: Arc<DatasetMetadata>, ) -> Self

Create a dataset with explicit metadata for name-based lookups. Create a dataset with explicit metadata for name-based lookups.

pub fn n_events_local(&self) -> usize

The number of EventDatas in the Dataset (non-MPI version).

Notes

This method is not intended to be called in analyses but rather in writing methods that have mpi-feature-gated versions. Most users should just call Dataset::n_events instead.

pub fn n_events(&self) -> usize

The number of EventDatas in the Dataset.

pub fn n_events_global(&self) -> usize

Alias for Dataset::n_events.

This returns the global event count under MPI.

impl Dataset

pub fn weights_local(&self) -> Vec<f64>

Extract a list of weights over each EventData in the Dataset (non-MPI version).

Notes

This method is not intended to be called in analyses but rather in writing methods that have mpi-feature-gated versions. Most users should just call Dataset::weights instead.

pub fn weights(&self) -> Vec<f64>

Extract a list of weights over each EventData in the Dataset.

pub fn weights_global(&self) -> Vec<f64>

Alias for Dataset::weights.

This returns the global weight vector in dataset order under MPI.

pub fn n_events_weighted_local(&self) -> f64

Returns the sum of the weights for each EventData in the Dataset (non-MPI version).

Notes

This method is not intended to be called in analyses but rather in writing methods that have mpi-feature-gated versions. Most users should just call Dataset::n_events_weighted instead.

pub fn n_events_weighted(&self) -> f64

Returns the sum of the weights for each EventData in the Dataset.

pub fn n_events_weighted_global(&self) -> f64

Alias for Dataset::n_events_weighted.

This returns the global weighted event count under MPI.

pub fn bootstrap_local(&self, seed: usize) -> Arc<Dataset>

Generate a new dataset with the same length by resampling the events in the original datset with replacement. This can be used to perform error analysis via the bootstrap method. (non-MPI version).

Notes

This method is not intended to be called in analyses but rather in writing methods that have mpi-feature-gated versions. Most users should just call Dataset::bootstrap instead.

pub fn bootstrap(&self, seed: usize) -> Arc<Dataset>

Generate a new dataset with the same length by resampling the events in the original datset with replacement. This can be used to perform error analysis via the bootstrap method.

pub fn filter( &self, expression: &VariableExpression, ) -> LadduResult<Arc<Dataset>>

Filter the Dataset by a given VariableExpression, selecting events for which the expression returns true.

pub fn bin_by<V>( &self, variable: V, bins: usize, range: (f64, f64), ) -> LadduResult<BinnedDataset>

where V: Variable,

Bin a Dataset by the value of the given Variable into a number of bins within the given range.

pub fn boost_to_rest_frame_of<S>(&self, names: &[S]) -> Arc<Dataset>

where S: AsRef<str>,

Boost all the four-momenta in all EventDatas to the rest frame of the given set of four-momenta identified by name.

pub fn evaluate<V: Variable>(&self, variable: &V) -> LadduResult<Vec<f64>>

Evaluate a Variable on every event in the Dataset.

Trait Implementations

impl Add<&Dataset> for &Dataset

type Output = Dataset

The resulting type after applying the + operator.

fn add(self, rhs: &Dataset) -> Self::Output

Performs the + operation.

impl Add<&Dataset> for Dataset

type Output = Dataset

The resulting type after applying the + operator.

fn add(self, rhs: &Dataset) -> Self::Output

Performs the + operation.

impl Add<Dataset> for &Dataset

type Output = Dataset

The resulting type after applying the + operator.

fn add(self, rhs: Dataset) -> Self::Output

Performs the + operation.

impl Add for Dataset

type Output = Dataset

The resulting type after applying the + operator.

fn add(self, rhs: Dataset) -> Self::Output

Performs the + operation.

impl Clone for Dataset

fn clone(&self) -> Dataset

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Dataset

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

Formats the value using the given formatter.

impl IntoIterator for Dataset

type Item = Event

The type of the elements being iterated over.

type IntoIter = DatasetIntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.