MinimumResidualSolver<T> Class

Solves symmetric or Hermitian linear systems using the minimum residual (MINRES) method.

Definition

Namespace: Numerics.NET.LinearAlgebra.IterativeSolvers
Assembly: Numerics.NET (in Numerics.NET.dll) Version: 10.9.0
C#
public sealed class MinimumResidualSolver<T> : IterativeSparseSolver<T>
Inheritance
Object  →  ManagedIterativeAlgorithm<DenseVector<T>, T, SolutionReport<DenseVector<T>, T>>  →  IterativeSparseSolver<T>  →  MinimumResidualSolver<T>

Type Parameters

T
The real or complex floating-point scalar type.

Remarks

The operator may be indefinite. Explicit matrices must be Hermitian; callers must ensure that matrix-free operators are Hermitian. Identity preconditioning is used by default. A supplied Preconditioner must remain a fixed linear, Hermitian positive-definite operator throughout each solve. The inherited LeftPreconditioner is not applied.

With a supplied preconditioner, residual minimization uses its induced norm. Stopping criteria still use the residual of the original system.

Convergence uses the true residual of the original system. Compatible singular systems can converge, but no minimum-length solution is promised. Lanczos breakdown with an unsatisfied residual, or an observed invalid preconditioner metric, reports RoundOffError. Arbitrary operator and preconditioner symmetry or definiteness is not certified.

Constructors

MinimumResidualSolver<T>Constructs a MINRES solver for a symmetric or Hermitian linear operator.

Properties

ConvergenceTests Gets the collection of convergence tests for the algorithm.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
EstimatedErrorGets the Euclidean norm of the true residual at termination.
(Inherited from IterativeSparseSolver<T>)
EvaluationsNeeded Gets the number of evaluations needed to execute the algorithm.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
HasSharedDegreeOfParallelism Indicates whether the degree of parallelism is a property that is shared across instances.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
InitialGuess Gets or sets the initial guess for the solution.
(Inherited from IterativeSparseSolver<T>)
IterationsNeeded Gets the number of iterations needed by the algorithm to reach the desired accuracy.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
LastCorrection Gets the most recent correction to the solution.
(Inherited from IterativeSparseSolver<T>)
LeftPreconditioner Gets or sets the Preconditioner<T>.
(Inherited from IterativeSparseSolver<T>)
LinearOperator Gets the sparse matrix of the system of equations.
(Inherited from IterativeSparseSolver<T>)
MaxDegreeOfParallelism Gets or sets the maximum degree of parallelism enabled by this instance.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
MaxEvaluations Gets or sets the maximum number of evaluations during the calculation.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
MaxIterationsGets or sets the maximum number of iterations to use when approximating the roots of the target function.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
MinIterations Gets or sets the minimum iterations that have to be performed.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
ParallelOptions Gets or sets the configuration for the parallel behavior of the algorithm.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
Preconditioner Gets or sets the Preconditioner<T>.
(Inherited from IterativeSparseSolver<T>)
Residuals Gets the vector containing the residuals of the solution.
(Inherited from IterativeSparseSolver<T>)
ResidualTest Gets the convergence test based on the size of the residuals.
(Inherited from IterativeSparseSolver<T>)
Result Gets the approximation to the solution from the most recent solve.
(Inherited from IterativeSparseSolver<T>)
RightHandSide Gets or sets the right hand side of the system of equations.
(Inherited from IterativeSparseSolver<T>)
SolutionReport Gets the result of an algorithm after it has executed.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
SolutionTest Gets the optional convergence test based on the size of the solution correction.
(Inherited from IterativeSparseSolver<T>)
Status Gets the AlgorithmStatus following an execution of the algorithm.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)
ThrowExceptionOnFailure Gets or sets whether to throw an exception when the algorithm fails to converge.
(Inherited from ManagedIterativeAlgorithm<T, TError, TReport>)

Methods

EqualsDetermines whether the specified object is equal to the current object.
(Inherited from Object)
GetHashCodeServes as the default hash function.
(Inherited from Object)
GetTypeGets the Type of the current instance.
(Inherited from Object)
Solve() Solves the system of equations and returns the solution.
(Inherited from IterativeSparseSolver<T>)
Solve(Vector<T>) Solves the system of equations for the specified right-hand side and returns the result.
(Inherited from IterativeSparseSolver<T>)
Solve(Vector<T>, Vector<T>) Solves the system of equations for the specified right-hand side and returns the result.
(Inherited from IterativeSparseSolver<T>)
ToStringReturns a string that represents the current object.
(Inherited from Object)

See Also