Click or drag to resize

MultivariableFunctionDifferentialSolver Class

An intermediate base class for MultivariableFunctionSolvers that will solve a function by iteration towards a solution. In each iteration, the change of the variable values will be evaluated, applied to the previous variable values and repeated in the next iteration. An instance of a type derived from this will pass in values of Variables into a SolvableMultivariableFunction to drive them to satisfy this solver's constraints.
Inheritance Hierarchy

Namespace:  AGI.Foundation.NumericalMethods
Assembly:  AGI.Foundation.Core (in AGI.Foundation.Core.dll) Version: 24.2.419.0 (24.2.419.0)
Syntax
public abstract class MultivariableFunctionDifferentialSolver : MultivariableFunctionSolver

The MultivariableFunctionDifferentialSolver type exposes the following members.

Constructors
  NameDescription
Protected methodMultivariableFunctionDifferentialSolver
Initializes a new instance. You must add at least one variable to the Variables and one constraint to the Constraints, as well as set the Function.
Protected methodMultivariableFunctionDifferentialSolver(MultivariableFunctionDifferentialSolver, CopyContext)
Initializes a new instance as a copy of an existing instance.
Top
Properties
  NameDescription
Public propertyConstraints
Gets the constraint settings corresponding to the results computed by the Function. There must be at least one constraint set for this solver to work.
(Inherited from MultivariableFunctionSolver.)
Public propertyCurrentIteration
Gets or sets the number of the current iteration. This should be incremented in the FindSolution(Int32, Boolean, ITrackCalculationProgress) method.
(Inherited from MultivariableFunctionSolver.)
Public propertyFunction
Gets or sets the function to solve. When the solver converges, this function must have been run with the variable values that converged. This behavior must be obeyed when Multithreaded is either or .
(Inherited from MultivariableFunctionSolver.)
Public propertyIsThreadSafe
Gets a value indicating whether the methods on this instance are safe to call from multiple threads simultaneously.
(Inherited from MultivariableFunctionSolver.)
Public propertyLastRunsResults
Gets or sets the results of the solver run. This includes such information as if the solver converged, all the iteration results (if configured to save them), if the run was aborted, etc.
(Inherited from MultivariableFunctionSolver.)
Public propertyLineSearchSettings

Gets or sets an optional property that can be used to specify tolerances, convergence criteria, and maximum iterations for a line search that is used to find the optimal feasible step in the same direction as the computed step. The cost function that is minimized for the line search is the square root of the sum of the squares of the weighted and scaled constraint errors.

GoldenSectionFindExtremum is used to find the minimum of the cost function along the direction of the computed step.

Public propertyMultithreaded
Gets or sets a value indicating whether this solver should evaluate with as many threads as the current threading policy facet and solver algorithm will allow. Note that derived types should copy this in their copy constructor.
(Inherited from MultivariableFunctionSolver.)
Public propertyVariables
Gets the SolverVariableSettings that will be used when computing this function. The variables passed to the function will be in the same order as this list of settings. There must be at least one variable set for this solver to work.
(Inherited from MultivariableFunctionSolver.)
Top
Methods
  NameDescription
Public methodClone
Clones this object using the specified context.
(Inherited from MultivariableFunctionSolver.)
Public methodComputeNextStep
Computes the next differential step that this differential corrector should take.
Public methodDispose
Releases any resources associated with this instance.
(Inherited from MultivariableFunctionSolver.)
Protected methodDispose(Boolean)
Releases any resources associated with this instance.
(Inherited from MultivariableFunctionSolver.)
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodFindSolution(Int32)
Solves the Function. By default, the results of every iteration will be stored.
(Inherited from MultivariableFunctionSolver.)
Public methodFindSolution(Int32, Boolean)
Solves the function.
(Inherited from MultivariableFunctionSolver.)
Public methodFindSolution(Int32, Boolean, ITrackCalculationProgress)
Solves the function. This method must increment CurrentIteration as well as set LastRunsResults before this method returns.
(Overrides MultivariableFunctionSolverFindSolution(Int32, Boolean, ITrackCalculationProgress).)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodReset
Resets the MultivariableFunctionSolver by setting the LastRunsResults to and the CurrentIteration to zero. This method should be called in any derived version.
(Inherited from MultivariableFunctionSolver.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
See Also