org.ojalgo.matrix.task.iterative

Class JacobiSolver

java.lang.Object

org.ojalgo.matrix.task.iterative.JacobiSolver

All Implemented Interfaces:

MatrixTask<Double>, SolverTask<Double>

public final class JacobiSolver
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IterativeSolverTask.Configurator

Nested classes/interfaces inherited from interface org.ojalgo.matrix.task.SolverTask

SolverTask.Factory<N extends Number>

Field Summary

Fields inherited from interface org.ojalgo.matrix.task.SolverTask

BIG, COMPLEX, PRIMITIVE, QUATERNION, RATIONAL

Constructor Summary

Constructors

Constructor and Description
JacobiSolver()

Method Summary

Modifier and Type	Method and Description
IterativeSolverTask.Configurator	configurator()
protected void	debug(int iteration, Access1D<?> current)
protected NumberContext	getAccuracyContext()
protected int	getIterationsLimit()
double	getRelaxationFactor()
protected boolean	isDebugPrinterSet()
PhysicalStore<Double>	preallocate(Structure2D templateBody, Structure2D templateRHS) Will create a PhysicalStore instance suitable for use with SolverTask.solve(Access2D, Access2D, PhysicalStore).
protected void	setAccuracyContext(NumberContext accuracyContext)
protected void	setDebugPrinter(BasicLogger.Printer debugPrinter)
protected void	setIterationsLimit(int iterationsLimit)
void	setRelaxationFactor(double relaxation)
MatrixStore<Double>	solve(Access2D<?> body, Access2D<?> rhs, PhysicalStore<Double> current) Exactly how (if at all) a specific implementation makes use of preallocated is not specified by this interface.
Optional<MatrixStore<Double>>	solve(MatrixStore<Double> body, MatrixStore<Double> rhs)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.ojalgo.matrix.task.SolverTask

preallocate, solve

Constructor Detail

JacobiSolver

public JacobiSolver()

Method Detail

solve

public final MatrixStore<Double> solve(Access2D<?> body,
                                       Access2D<?> rhs,
                                       PhysicalStore<Double> current)
                                throws RecoverableCondition

Description copied from interface: SolverTask

Exactly how (if at all) a specific implementation makes use of preallocated is not specified by this interface. It must be documented for each implementation.

Should produce the same results as calling SolverTask.solve(Access2D, Access2D).

Use SolverTask.preallocate(Structure2D, Structure2D) to obtain a suitbale preallocated.

rhs - The Right Hand Side, wont be modfied

current - Preallocated memory for the results, possibly some intermediate results. You must assume this is modified, but you cannot assume it will contain the full/final/correct solution.

Returns:

The solution

Throws:

RecoverableCondition

getRelaxationFactor

public final double getRelaxationFactor()

setRelaxationFactor

public final void setRelaxationFactor(double relaxation)

configurator

public final IterativeSolverTask.Configurator configurator()

preallocate

public final PhysicalStore<Double> preallocate(Structure2D templateBody,
                                               Structure2D templateRHS)

Description copied from interface: SolverTask

Will create a PhysicalStore instance suitable for use with SolverTask.solve(Access2D, Access2D, PhysicalStore). The dimensions of the returned instance is not specified by this interface - it is specified by the behaviour/requirements of each implementation.

When solving an equation system [A][X]=[B] ([mxn][nxb]=[mxb]) the preallocated memory/matrix will typically be either mxb or nxb.

Specified by:

preallocate in interface SolverTask<Double>

solve

public final Optional<MatrixStore<Double>> solve(MatrixStore<Double> body,
                                                 MatrixStore<Double> rhs)

debug

protected final void debug(int iteration,
                           Access1D<?> current)

getAccuracyContext

protected final NumberContext getAccuracyContext()

getIterationsLimit

protected final int getIterationsLimit()

isDebugPrinterSet

protected final boolean isDebugPrinterSet()

setAccuracyContext

protected void setAccuracyContext(NumberContext accuracyContext)

setDebugPrinter

protected void setDebugPrinter(BasicLogger.Printer debugPrinter)

setIterationsLimit

protected void setIterationsLimit(int iterationsLimit)