Struct argmin::core::OpWrapper

pub struct OpWrapper<O: ArgminOp> {
    pub op: Option<O>,
    pub cost_func_count: u64,
    pub grad_func_count: u64,
    pub hessian_func_count: u64,
    pub jacobian_func_count: u64,
    pub modify_func_count: u64,
}

This wraps an operator and keeps track of how often the cost, gradient and Hessian have been computed and how often the modify function has been called. Usually, this is an implementation detail unless a solver is needed within another solver (such as a line search within a gradient descent method).

Fields

op: Option<O>

Operator

cost_func_count: u64

Number of cost function evaluations

grad_func_count: u64

Number of gradient function evaluations

hessian_func_count: u64

Number of Hessian function evaluations

jacobian_func_count: u64

Number of Jacobian function evaluations

modify_func_count: u64

Number of modify function evaluations

Implementations

impl<O: ArgminOp> OpWrapper<O>

pub fn new(op: O) -> Self

Construct an OpWrapper from an operator

pub fn apply(&mut self, param: &O::Param) -> Result<O::Output, Error>

Calls the apply method of op and increments cost_func_count.

pub fn gradient(&mut self, param: &O::Param) -> Result<O::Param, Error>

Calls the gradient method of op and increments gradient_func_count.

pub fn hessian(&mut self, param: &O::Param) -> Result<O::Hessian, Error>

Calls the hessian method of op and increments hessian_func_count.

pub fn jacobian(&mut self, param: &O::Param) -> Result<O::Jacobian, Error>

Calls the jacobian method of op and increments jacobian_func_count.

pub fn modify(
    &mut self,
    param: &O::Param,
    extent: O::Float
) -> Result<O::Param, Error>

Calls the modify method of op and increments modify_func_count.

pub fn take_op(&mut self) -> Option<O>

Moves the operator out of the struct and replaces it with None

pub fn consume_op(&mut self, other: OpWrapper<O>)

Consumes an operator by increasing the function call counts of self by the ones in other.

pub fn consume_func_counts<O2: ArgminOp>(&mut self, other: OpWrapper<O2>)

Adds function evaluation counts of another operator.

pub fn reset(self) -> Self

Reset the cost function counts to zero.

pub fn get_op(self) -> O

Returns the operator op by taking ownership of self.

Trait Implementations

impl<O: Clone + ArgminOp> Clone for OpWrapper<O>

fn clone(&self) -> OpWrapper<O>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<O: Debug + ArgminOp> Debug for OpWrapper<O>

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

Formats the value using the given formatter.

impl<O: Default + ArgminOp> Default for OpWrapper<O>

fn default() -> OpWrapper<O>

Returns the “default value” for a type.

impl<'de, O: ArgminOp> Deserialize<'de> for OpWrapper<O> where
    O: Deserialize<'de>, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<O: ArgminOp> Serialize for OpWrapper<O> where
    O: Serialize, 

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.