Struct Manager

pub struct Manager<F: Field + 'static> {
    pub model: Model<F>,
    pub dataset: Dataset<F>,
}

The Manager struct links a Model to a Dataset and provides methods to manipulate the Model and evaluate it over the Dataset.

Fields

model: Model<F>

The associated Model.

dataset: Dataset<F>

The associated Dataset.

Implementations

impl<F: Field> Manager<F>

pub fn new( model: &Model<F>, dataset: &Dataset<F>, ) -> Result<Self, RustitudeError>

Generates a new Manager from a Model and Dataset.

Errors

This method will return a RustitudeError if the precaluclation phase of the Model fails for any events in the Dataset. See Model::load for more information.

pub fn evaluate(&self, parameters: &[F]) -> Result<Vec<F>, RustitudeError>

Evaluate the Model over the Dataset with the given free parameters.

Errors

This method will return a RustitudeError if the amplitude calculation fails. See Model::compute for more information.

pub fn evaluate_indexed( &self, parameters: &[F], indices: &[usize], ) -> Result<Vec<F>, RustitudeError>

Evaluate the Model over the Dataset with the given free parameters.

This method allows the user to supply a list of indices and will only evaluate events at those indices. This can be used to evaluate only a subset of events or to resample events with replacement, such as in a bootstrap.

Errors

This method will return a RustitudeError if the amplitude calculation fails. See Model::compute for more information.

pub fn par_evaluate(&self, parameters: &[F]) -> Result<Vec<F>, RustitudeError>

Evaluate the Model over the Dataset with the given free parameters.

This version uses a parallel loop over events.

Errors

This method will return a RustitudeError if the amplitude calculation fails. See Model::compute for more information.

pub fn par_evaluate_indexed( &self, parameters: &[F], indices: &[usize], ) -> Result<Vec<F>, RustitudeError>

Evaluate the Model over the Dataset with the given free parameters.

This method allows the user to supply a list of indices and will only evaluate events at those indices. This can be used to evaluate only a subset of events or to resample events with replacement, such as in a bootstrap.

This version uses a parallel loop over events.

Errors

This method will return a RustitudeError if the amplitude calculation fails. See Model::compute for more information.

pub fn get_amplitude( &self, amplitude_name: &str, ) -> Result<Amplitude<F>, RustitudeError>

Get a copy of an Amplitude in the Model by name.

Errors

This method will return a RustitudeError if there is no amplitude found with the given name in the parent Model. See Model::get_amplitude for more information.

pub fn get_parameter( &self, amplitude_name: &str, parameter_name: &str, ) -> Result<Parameter<F>, RustitudeError>

Get a copy of a Parameter in a Model by name and the name of the parent Amplitude.

Errors

This method will return a RustitudeError if there is no parameter found with the given name in the parent Model. It will also first check if the given amplitude exists, and this method can also fail in the same way (see Model::get_amplitude and Model::get_parameter).

pub fn print_parameters(&self)

Print the free parameters in the Model. See Model::print_parameters for more information.

pub fn free_parameters(&self) -> Vec<Parameter<F>>

Returns a Vec<Parameter<F>> containing the free parameters in the Model.

See Model::free_parameters for more information.

pub fn fixed_parameters(&self) -> Vec<Parameter<F>>

Returns a Vec<Parameter<F>> containing the fixed parameters in the Model.

See Model::fixed_parameters for more information.

pub fn constrain( &mut self, amplitude_1: &str, parameter_1: &str, amplitude_2: &str, parameter_2: &str, ) -> Result<(), RustitudeError>

Constrain two parameters by name, reducing the number of free parameters by one.

Errors

This method will fail if any of the given amplitude or parameter names don’t correspond to a valid amplitude-parameter pair. See Model::constrain for more information.

pub fn fix( &mut self, amplitude: &str, parameter: &str, value: F, ) -> Result<(), RustitudeError>

Fix a parameter by name to the given value.

Errors

This method will fail if the given amplitude-parameter pair does not exist. See Model::fix for more information.

pub fn free( &mut self, amplitude: &str, parameter: &str, ) -> Result<(), RustitudeError>

Free a fixed parameter by name.

Errors

This method will fail if the given amplitude-parameter pair does not exist. See Model::free for more information.

pub fn set_bounds( &mut self, amplitude: &str, parameter: &str, bounds: (F, F), ) -> Result<(), RustitudeError>

Set the bounds of a parameter by name.

Errors

This method will fail if the given amplitude-parameter pair does not exist. See Model::set_bounds for more information.

pub fn set_initial( &mut self, amplitude: &str, parameter: &str, initial: F, ) -> Result<(), RustitudeError>

Set the initial value of a parameter by name.

Errors

This method will fail if the given amplitude-parameter pair does not exist. See Model::set_initial for more information.

pub fn get_bounds(&self) -> Vec<(F, F)>

Get a list of bounds for all free parameters in the Model. See Model::get_bounds for more information.

pub fn get_initial(&self) -> Vec<F>

Get a list of initial values for all free parameters in the Model. See Model::get_initial for more information.

pub fn get_n_free(&self) -> usize

Get the number of free parameters in the Model See Model::get_n_free for more information.

pub fn activate(&mut self, amplitude: &str) -> Result<(), RustitudeError>

Activate an Amplitude by name. See Model::activate for more information.

Errors

This function will return a RustitudeError::AmplitudeNotFoundError if the given amplitude is not present in the Model.

pub fn activate_all(&mut self)

Activate all Amplitudes by name. See Model::activate_all for more information.

pub fn isolate(&mut self, amplitudes: Vec<&str>) -> Result<(), RustitudeError>

Activate only the specified Amplitudes while deactivating the rest. See Model::isolate for more information.

Errors

This function will return a RustitudeError::AmplitudeNotFoundError if a given amplitude is not present in the Model.

pub fn deactivate(&mut self, amplitude: &str) -> Result<(), RustitudeError>

Deactivate an Amplitude by name. See Model::deactivate for more information.

Errors

This function will return a RustitudeError::AmplitudeNotFoundError if the given amplitude is not present in the Model.

pub fn deactivate_all(&mut self)

Deactivate all Amplitudes by name. See Model::deactivate_all for more information.

Trait Implementations

impl<F: Clone + Field + 'static> Clone for Manager<F>

fn clone(&self) -> Manager<F>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<F: Field> Debug for Manager<F>

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

Formats the value using the given formatter.

impl<F: Field> Display for Manager<F>

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

Formats the value using the given formatter.