net.myrrix.common.math

Class MatrixUtils

java.lang.Object

net.myrrix.common.math.MatrixUtils

public final class MatrixUtils
extends Object

Contains utility methods for dealing with matrices, which are here represented as FastByIDMaps of FastByIDFloatMaps, or of float[].

Since:

1.0

Author:

Sean Owen

Method Summary

Methods

Modifier and Type	Method and Description
static double[][]	accessMatrixDataDirectly(org.apache.commons.math3.linear.RealMatrix matrix)
static void	addTo(long row, long column, float value, FastByIDMap<FastByIDFloatMap> RbyRow, FastByIDMap<FastByIDFloatMap> RbyColumn) Efficiently increments an entry in two parallel, sparse matrices.
static Solver	getSolver(org.apache.commons.math3.linear.RealMatrix M)
static boolean	isNonSingular(org.apache.commons.math3.linear.RealMatrix M)
static String	matrixToString(FastByIDMap<FastByIDFloatMap> M)
static FastByIDMap<float[]>	multiply(org.apache.commons.math3.linear.RealMatrix M, FastByIDMap<float[]> S)
static double[]	multiply(org.apache.commons.math3.linear.RealMatrix matrix, float[] V)
static org.apache.commons.math3.linear.RealMatrix	multiplyXYT(FastByIDMap<float[]> X, FastByIDMap<float[]> Y)
static void	remove(long row, long column, FastByIDMap<FastByIDFloatMap> RbyRow, FastByIDMap<FastByIDFloatMap> RbyColumn) Efficiently removes an entry in two parallel, sparse matrices.
static org.apache.commons.math3.linear.RealMatrix	transposeTimesSelf(FastByIDMap<float[]> M)

Methods inherited from class java.lang.Object

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

Method Detail

addTo

public static void addTo(long row,
         long column,
         float value,
         FastByIDMap<FastByIDFloatMap> RbyRow,
         FastByIDMap<FastByIDFloatMap> RbyColumn)

Efficiently increments an entry in two parallel, sparse matrices.

Parameters:

row - row to increment

column - column to increment

value - increment value

RbyRow - matrix R to update, keyed by row

RbyColumn - matrix R to update, keyed by column

remove

public static void remove(long row,
          long column,
          FastByIDMap<FastByIDFloatMap> RbyRow,
          FastByIDMap<FastByIDFloatMap> RbyColumn)

Efficiently removes an entry in two parallel, sparse matrices.

Parameters:

row - row to remove

column - column to remove

RbyRow - matrix R to update, keyed by row

RbyColumn - matrix R to update, keyed by column

isNonSingular

public static boolean isNonSingular(org.apache.commons.math3.linear.RealMatrix M)

Returns:

LinearSystemSolver.isNonSingular(RealMatrix)

getSolver

public static Solver getSolver(org.apache.commons.math3.linear.RealMatrix M)

Returns:

LinearSystemSolver.getSolver(RealMatrix)

multiply

public static FastByIDMap<float[]> multiply(org.apache.commons.math3.linear.RealMatrix M,
                            FastByIDMap<float[]> S)

Parameters:

M - small RealMatrix

S - wide, short matrix

Returns:

M * S as a newly allocated matrix

multiplyXYT

public static org.apache.commons.math3.linear.RealMatrix multiplyXYT(FastByIDMap<float[]> X,
                                                     FastByIDMap<float[]> Y)

accessMatrixDataDirectly

public static double[][] accessMatrixDataDirectly(org.apache.commons.math3.linear.RealMatrix matrix)

Parameters:

matrix - an Array2DRowRealMatrix

Returns:

its "data" field -- not a copy

multiply

public static double[] multiply(org.apache.commons.math3.linear.RealMatrix matrix,
                float[] V)

transposeTimesSelf

public static org.apache.commons.math3.linear.RealMatrix transposeTimesSelf(FastByIDMap<float[]> M)

Parameters:

M - tall, skinny matrix

Returns:

MT * M as a dense matrix

matrixToString

public static String matrixToString(FastByIDMap<FastByIDFloatMap> M)

Parameters:

M - matrix to print

Returns:

a print-friendly rendering of a sparse matrix. Not useful for wide matrices.