`pub struct NonlinearConjugateGradient<P, L, B, F> { /* fields omitted */ }`
Expand description

The nonlinear conjugate gradient is a generalization of the conjugate gradient method for nonlinear optimization problems.

Example

# References:

[0] Jorge Nocedal and Stephen J. Wright (2006). Numerical Optimization. Springer. ISBN 0-387-30303-0.

## Implementations

### `impl<P, L, B, F> NonlinearConjugateGradient<P, L, B, F> where    P: Default,    F: ArgminFloat, `[src]

#### `pub fn new(linesearch: L, beta_method: B) -> Result<Self, Error>`[src]

Constructor (Polak Ribiere Conjugate Gradient (PR-CG))

#### `pub fn restart_iters(self, iters: u64) -> Self`[src]

Specifiy the number of iterations after which a restart should be performed This allows the algorithm to “forget” previous information which may not be helpful anymore.

#### `pub fn restart_orthogonality(self, v: F) -> Self`[src]

Set the value for the orthogonality measure. Setting this parameter leads to a restart of the algorithm (setting beta = 0) after two consecutive search directions are not orthogonal anymore. In other words, if this condition is met:

`|\nabla f_k^T * \nabla f_{k-1}| / | \nabla f_k ||^2 >= v`

A typical value for `v` is 0.1.

## Trait Implementations

### `impl<P: Clone, L: Clone, B: Clone, F: Clone> Clone for NonlinearConjugateGradient<P, L, B, F>`[src]

#### `fn clone(&self) -> NonlinearConjugateGradient<P, L, B, F>`[src]

Returns a copy of the value. Read more

#### `fn clone_from(&mut self, source: &Self)`1.0.0[src]

Performs copy-assignment from `source`. Read more

### `impl<'de, P, L, B, F> Deserialize<'de> for NonlinearConjugateGradient<P, L, B, F> where    P: Deserialize<'de>,    L: Deserialize<'de>,    B: Deserialize<'de>,    F: Deserialize<'de>, `[src]

#### `fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where    __D: Deserializer<'de>, `[src]

Deserialize this value from the given Serde deserializer. Read more

### `impl<P, L, B, F> Serialize for NonlinearConjugateGradient<P, L, B, F> where    P: Serialize,    L: Serialize,    B: Serialize,    F: Serialize, `[src]

#### `fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where    __S: Serializer, `[src]

Serialize this value into the given Serde serializer. Read more

### `impl<O, P, L, B, F> Solver<O> for NonlinearConjugateGradient<P, L, B, F> where    O: ArgminOp<Param = P, Output = F, Float = F>,    P: Clone + Default + Serialize + DeserializeOwned + ArgminSub<O::Param, O::Param> + ArgminDot<O::Param, O::Float> + ArgminScaledAdd<O::Param, O::Float, O::Param> + ArgminAdd<O::Param, O::Param> + ArgminMul<F, O::Param> + ArgminNorm<O::Float>,    O::Hessian: Default,    L: Clone + ArgminLineSearch<O::Param, O::Float> + Solver<OpWrapper<O>>,    B: ArgminNLCGBetaUpdate<O::Param, O::Float>,    F: ArgminFloat, `[src]

#### `const NAME: &'static str`[src]

Name of the solver

#### `fn next_iter(    &mut self,     op: &mut OpWrapper<O>,     state: &IterState<O>) -> Result<ArgminIterData<O>, Error>`[src]

Computes one iteration of the algorithm.

#### `fn terminate_internal(&mut self, state: &IterState<O>) -> TerminationReason`[src]

Checks whether basic termination reasons apply. Read more

#### `fn terminate(&mut self, _state: &IterState<O>) -> TerminationReason`[src]

Checks whether the algorithm must be terminated

## Blanket Implementations

### `impl<T> Any for T where    T: 'static + ?Sized, `[src]

#### `pub fn type_id(&self) -> TypeId`[src]

Gets the `TypeId` of `self`. Read more

### `impl<T> Borrow<T> for T where    T: ?Sized, `[src]

#### `pub fn borrow(&self) -> &T`[src]

Immutably borrows from an owned value. Read more

### `impl<T> BorrowMut<T> for T where    T: ?Sized, `[src]

#### `pub fn borrow_mut(&mut self) -> &mut T`[src]

Mutably borrows from an owned value. Read more

### `impl<T> From<T> for T`[src]

#### `pub fn from(t: T) -> T`[src]

Performs the conversion.

### `impl<T, U> Into<U> for T where    U: From<T>, `[src]

#### `pub fn into(self) -> U`[src]

Performs the conversion.

### `impl<T> ToOwned for T where    T: Clone, `[src]

#### `type Owned = T`

The resulting type after obtaining ownership.

#### `pub fn to_owned(&self) -> T`[src]

Creates owned data from borrowed data, usually by cloning. Read more

#### `pub fn clone_into(&self, target: &mut T)`[src]

🔬 This is a nightly-only experimental API. (`toowned_clone_into`)

Uses borrowed data to replace owned data, usually by cloning. Read more

### `impl<T, U> TryFrom<U> for T where    U: Into<T>, `[src]

#### `type Error = Infallible`

The type returned in the event of a conversion error.

#### `pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>`[src]

Performs the conversion.

### `impl<T, U> TryInto<U> for T where    U: TryFrom<T>, `[src]

#### `type Error = <U as TryFrom<T>>::Error`

The type returned in the event of a conversion error.

#### `pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>`[src]

Performs the conversion.