org.ojalgo.matrix.task.iterative

Class MutableSolver<D extends org.ojalgo.matrix.task.iterative.IterativeSolverTask & org.ojalgo.matrix.task.iterative.IterativeSolverTask.SparseDelegate>

java.lang.Object

org.ojalgo.matrix.task.iterative.MutableSolver<D>

All Implemented Interfaces:

MatrixTask<Double>, SolverTask<Double>

public abstract class MutableSolver<D extends org.ojalgo.matrix.task.iterative.IterativeSolverTask & org.ojalgo.matrix.task.iterative.IterativeSolverTask.SparseDelegate>
extends Object

Author:

apete

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

Modifier	Constructor and Description
protected	MutableSolver(D delegate, long size)

Method Summary

Modifier and Type	Method and Description
boolean	add(Equation row)
void	clear()
IterativeSolverTask.Configurator	configurator()
protected void	debug(int iteration, Access1D<?> current)
protected double	doubleValue(int row, int column)
protected NumberContext	getAccuracyContext()
protected D	getDelegate()
protected int	getIterationsLimit()
protected boolean	isDebugPrinterSet()
PhysicalStore<Double>	preallocate(Structure2D templateBody, Structure2D templateRHS) Will create a PhysicalStore instance suitable for use with SolverTask.solve(Access2D, Access2D, PhysicalStore).
boolean	remove(Equation row)
double	resolve(PhysicalStore<Double> solution) A variation of solve(Access2D, Access2D, PhysicalStore) where you do not supply the equation system body.
protected void	setAccuracyContext(NumberContext accuracyContext)
protected void	setDebugPrinter(BasicLogger.Printer debugPrinter)
protected void	setIterationsLimit(int iterationsLimit)
protected long	size()
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

MutableSolver

protected MutableSolver(D delegate,
                        long size)

Method Detail

add

public boolean add(Equation row)

clear

public void clear()

remove

public boolean remove(Equation row)

resolve

public final double resolve(PhysicalStore<Double> solution)

A variation of solve(Access2D, Access2D, PhysicalStore) where you do not supply the equation system body. It is assumed to have been set up beforehand.

solve

public 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

doubleValue

protected double doubleValue(int row,
                             int column)

getDelegate

protected final D getDelegate()

setAccuracyContext

protected void setAccuracyContext(NumberContext accuracyContext)

setDebugPrinter

protected void setDebugPrinter(BasicLogger.Printer debugPrinter)

setIterationsLimit

protected void setIterationsLimit(int iterationsLimit)

size

protected long size()

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()