Extreme Optimization™: Complexity made simple.

Numerical Components
for .NET

  • Home
  • Features
    • Math Library
    • Vector and Matrix Library
    • Statistics Library
    • Performance
    • Usability
  • Documentation
    • Introduction
    • Math Library User's Guide
    • Vector and Matrix Library User's Guide
    • Statistics Library User's Guide
    • Reference
  • Resources
    • Downloads
    • QuickStart Samples
    • Sample Applications
    • Frequently Asked Questions
    • Technical Support
  • Blog
  • Order
  • Company
    • About us
    • Testimonials
    • Customers
    • Press Releases
    • Careers
    • Contact us
Introduction
Deployment Guide
Using Parallelism
Expand Mathematics Library User's GuideMathematics Library User's Guide
Expand Vector and Matrix Library User's GuideVector and Matrix Library User's Guide
Expand Statistics Library User's GuideStatistics Library User's Guide
Expand ReferenceReference
  • Home
    • Features
    • Solutions
    • Documentation
    • QuickStart Samples
    • Sample Applications
    • Downloads
    • Technical Support
    • Download trial
    • How to buy
    • Blog
    • Company
    • Resources
  • Documentation
    • Introduction
    • Deployment Guide
    • Using Parallelism
    • Mathematics Library User's Guide
    • Vector and Matrix Library User's Guide
    • Statistics Library User's Guide
    • Reference
  • Reference
    • Extreme.Mathematics Namespace
    • Extreme.Mathematics.Algorithms Namespace
    • Extreme.Mathematics.Calculus Namespace
    • Extreme.Mathematics.Calculus.OrdinaryDifferentialEquations Namespace
    • Extreme.Mathematics.Curves Namespace
    • Extreme.Mathematics.Curves.Nonlinear Namespace
    • Extreme.Mathematics.EquationSolvers Namespace
    • Extreme.Mathematics.Generic Namespace
    • Extreme.Mathematics.Generic.LinearAlgebra Namespace
    • Extreme.Mathematics.Generic.LinearAlgebra.Providers Namespace
    • Extreme.Mathematics.LinearAlgebra Namespace
    • Extreme.Mathematics.LinearAlgebra.Complex Namespace
    • Extreme.Mathematics.LinearAlgebra.Complex.Decompositions Namespace
    • Extreme.Mathematics.LinearAlgebra.IO Namespace
    • Extreme.Mathematics.LinearAlgebra.IterativeSolvers Namespace
    • Extreme.Mathematics.LinearAlgebra.IterativeSolvers.Preconditioners Namespace
    • Extreme.Mathematics.LinearAlgebra.Providers Namespace
    • Extreme.Mathematics.LinearAlgebra.Sparse Namespace
    • Extreme.Mathematics.Optimization Namespace
    • Extreme.Mathematics.Optimization.LineSearches Namespace
    • Extreme.Mathematics.SignalProcessing Namespace
    • Extreme.Statistics Namespace
    • Extreme.Statistics.Distributions Namespace
    • Extreme.Statistics.IO Namespace
    • Extreme.Statistics.Multivariate Namespace
    • Extreme.Statistics.Random Namespace
    • Extreme.Statistics.Tests Namespace
    • Extreme.Statistics.TimeSeriesAnalysis Namespace
  • Extreme.Mathematics.Optimization Namespace
    • BrentDerivativeOptimizer Class
    • BrentOptimizer Class
    • ConjugateGradientMethod Enumeration
    • ConjugateGradientOptimizer Class
    • Constraint Class
    • ConstraintCollection Class
    • ConstraintType Enumeration
    • DecisionVariable Class
    • DecisionVariableCollection Class
    • DirectionalOptimizer Class
    • ExtremumType Enumeration
    • GoldenSectionOptimizer Class
    • LevenbergMarquardtOptimizer Class
    • LinearConstraint Class
    • LinearProgram Class
    • LinearProgramConstraint Class
    • LinearProgramVariable Class
    • MpsReader Class
    • MultidimensionalOptimizer Class
    • NelderMeadOptimizer Class
    • NonlinearConstraint Class
    • NonlinearProgram Class
    • OneDimensionalOptimizer Class
    • OptimizationModel Class
    • OptimizationModelEntity Class
    • OptimizationModelStatus Enumeration
    • OptimizationSolutionReport Class
    • PowellOptimizer Class
    • QuadraticProgram Class
    • QuasiNewtonMethod Enumeration
    • QuasiNewtonOptimizer Class
  • ConjugateGradientOptimizer Class
    • Members
    • Constructors
    • Methods
    • Properties
Collapse image Expand Image Copy image CopyHover image
         




ConjugateGradientOptimizer Class

Members See Also 
Represents an optimizer that uses a conjugate gradient algorithm.

Namespace: Extreme.Mathematics.Optimization
Assembly: Extreme.Numerics.Net40 (in Extreme.Numerics.Net40.dll) Version: 4.2.11333.0 (4.2.12253.0)

Syntax

C#
                      public sealed class ConjugateGradientOptimizer : DirectionalOptimizer
Visual Basic (Declaration)
                      Public NotInheritable Class ConjugateGradientOptimizer _
	Inherits DirectionalOptimizer
Visual C++
                      public ref class ConjugateGradientOptimizer sealed : public DirectionalOptimizer
F#
[<SealedAttribute>]
type ConjugateGradientOptimizer =  
    class
        inherit DirectionalOptimizer
    end

Remarks

Use the ConjugateGradientOptimizer class to solve an optimization problem using a conjugate gradient algorithm. Three variants of the algorithm are available: the method of Fletcher and Reeves, the method of Polak and Ribière, and the positive method of Polak and Ribière. The default is the positive Polak-Ribière method.

The conjugate gradient method is the method of choice for large problems. For these problems, it consumes less memory and performs less work per iteration than the other common methods. On the downside, the search directions are often badly scaled, which makes the method less suitable for smaller problems. A quasi-Newton algorithm is preferred in such a case.

The objective function must be supplied as a multivariate function delegate to the ObjectiveFunction property. The gradient of the objective function can be supplied either as a multivariate function returning a vector delegate (by setting the GradientFunction property), or a multivariate function returning a vector in its second argument delegate (by setting the FastGradientFunction property). The latter has the advantage that the same Vector instance is reused to hold the result.

Before the algorithm is run, you must set the InitialGuess property to a vector that contains an initial estimate for the extremum. The ExtremumType property specifies whether a minimum or a maximum of the objective function is desired.

The FindExtremum()()()() method performs the actual search for an extremum, and returns a Vector containing the best approximation. The Extremum property also returns the best approximation to the extremum. The ValueAtExtremum property returns the value of the objective function at the extremum.

The Status property is a AlgorithmStatus value that indicates the outcome of the algorithm. A value of Normal shows normal termination. A value of Divergent usually indicates that the objective function is not bounded.

A number of properties let you control the search for an extremum. The LineSearch property returns a OneDimensionalOptimizer that is used to locate a suitable new point along the current search direction. You can modify its convergence criteria. Note that conjugate gradient algorithms require a fairly precise line search.

Sometimes, successive conjugate directions are almost parallel, or don't reflect the current curvature of the objective function well, resulting in poor convergence. This can be remedied in one of two ways. The RestartIterations property specifies how often the conjugate direction is to be reset to the steepest descent direction. A value of 0, which is the default, specifies not to reset the direction. The RestartThreshold property is used to test whether successive search directions are sufficiently orthogonal. If this is the case, then the search direction is reset to the steepest descent direction. A lower value indicates more frequent resets. The default value is 0.1.

The algorithm has three convergence tests. By default, the algorithm terminates when either of these is satisfied. You can deactivate either test by setting its Active property to falseFalsefalsefalse (False in Visual Basic). If both tests are deactivated, then the algorithm always terminates when the maximum number of iterations or function evaluations is reached.

The first test is based on the uncertainty in the location of the approximate extremum. The SolutionTest property returns a VectorConvergenceTest object that allows you to specify the desired Tolerance and specific ConvergenceCriterion. See the VectorConvergenceTest class for details on how to further customize this test.

The second test is based on the change in value of the objective function at the approximate extremum. The test is successful when the change of the value of the objective function is within the tolerance. Care should be taken with this test. When the tolerance is too large, the algorithm will terminate prematurely. The ValueTest property returns a SimpleConvergenceTest object that can be used to customize the test.

The third test is based on the value of the gradient at the approximate extremum. The GradientTest property returns a VectorConvergenceTest object that can be used to customize the test. By default, the error is set to the component with the largest absolute value.

Inheritance Hierarchy

System..::..Object
  Extreme.Mathematics.Algorithms..::..ManagedIterativeAlgorithm<(Of <(<'Vector>)>)>
    Extreme.Mathematics.Optimization..::..MultidimensionalOptimizer
      Extreme.Mathematics.Optimization..::..DirectionalOptimizer
        Extreme.Mathematics.Optimization..::..ConjugateGradientOptimizer

See Also

ConjugateGradientOptimizer Members
Extreme.Mathematics.Optimization Namespace

Send comments on this topic to support@extremeoptimization.com

Copyright (c) 2004-2011 ExoAnalytics Inc.

Copyright © 2003-2013, Extreme Optimization. All rights reserved.
Extreme Optimization, Complexity made simple, M#, and M Sharp are trademarks of ExoAnalytics Inc.
Microsoft, Visual C#, Visual Basic, Visual Studio, Visual Studio.NET, and the Optimized for Visual Studio logo
are registered trademarks of Microsoft Corporation.