org.interpss.numeric.matrix

Class MatrixUtil

java.lang.Object

org.interpss.numeric.matrix.MatrixUtil

public class MatrixUtil
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
MatrixUtil()

Method Summary

Modifier and Type	Method and Description
static org.apache.commons.math3.complex.Complex[][]	add(org.apache.commons.math3.complex.Complex[][] A, org.apache.commons.math3.complex.Complex[][] B) add the two matrix together
static Complex3x1[][]	add(Complex3x1[][] A, Complex3x1[][] B) add the two matrix together
static Complex3x1[]	add(Complex3x1[] A, Complex3x1[] B) add the two vector together
static Complex3x3[][]	add(Complex3x3[][] A, Complex3x3[][] B) add the two matrix together
static java.lang.String	complex2DAry2String(org.apache.commons.math3.complex.Complex[][] ary)
static java.lang.String	complex3x1Ary2String(Complex3x1[] ary)
static java.lang.String	complex3x32DAry2String(Complex3x3[][] ary)
static org.apache.commons.math3.complex.Complex[]	createComplex1DArray(int row) create a Complex vector with all fields initialized to (0.0,0.0)
static org.apache.commons.math3.complex.Complex[][]	createComplex2DArray(int row, int col) create a Complex matrix with all fields initialized to (0.0,0.0)
static Complex3x1[]	createComplex3x1DArray(int row) create a Complex3x1 vector with all fields initialized
static Complex3x3[][]	createComplex3x32DArray(int row, int col) create a Complex3x3 block matrix with all fields initialized
static org.apache.commons.math3.complex.Complex[]	mul(org.apache.commons.math3.complex.Complex[][] a, org.apache.commons.math3.complex.Complex[] b) complex matrix multiplication [A] x [b]
static org.apache.commons.math3.complex.Complex[][]	multiply(org.apache.commons.math3.complex.Complex[][] matrix, int[][] transMatrix) multiply the matrix by a transformation matrix.
static Complex3x1[][]	multiply(Complex3x1[][] matrix, int[][] transMatrix) multiply the matrix by a transformation matrix.
static Complex3x3[][]	multiply(Complex3x3[][] matrix, double[][] transMatrix) multiply the matrix by a transformation matrix.
static Complex3x3[][]	multiply(Complex3x3[][] matrix, int[][] transMatrix) multiply the matrix by a transformation matrix.
static double[]	multiply(double[][] matrix, double[] vector) multiply the matrix by the vector.
static Complex3x1[]	preMultiply(double[][] transMatrix, Complex3x1[] vector) pre-multiply the vector by a transformation matrix.
static Complex3x3[][]	preMultiply(double[][] transMatrix, Complex3x3[][] matrix) pre-multiply the matrix by a transformation matrix.
static org.apache.commons.math3.complex.Complex[][]	preMultiply(int[][] transMatrix, org.apache.commons.math3.complex.Complex[][] matrix) pre-multiply the matrix by a transformation matrix.
static Complex3x1[]	preMultiply(int[][] transMatrix, Complex3x1[] vector) pre-multiply the vector by a transformation matrix.
static Complex3x1[][]	preMultiply(int[][] transMatrix, Complex3x1[][] matrix) pre-multiply the matrix by a transformation matrix.
static Complex3x3[][]	preMultiply(int[][] transMatrix, Complex3x3[][] matrix) pre-multiply the matrix by a transformation matrix.
static org.apache.commons.math3.complex.Complex[][]	prePostMultiply(org.apache.commons.math3.complex.Complex[][] matrix, int[][] transM) transpose[M] x [A] x [M]
static Complex3x1[][]	prePostMultiply(Complex3x1[][] matrix, int[][] transM) transpose[M] x [A] x [M]
static Complex3x1[]	toComplex3x1Ary(org.apache.commons.math3.complex.Complex[] vector0, org.apache.commons.math3.complex.Complex[] vector1, org.apache.commons.math3.complex.Complex[] vector2) Convert three vectors to a Complex3x1 vector
static org.apache.commons.math3.complex.Complex[][]	toComplexAry(Complex3x1[] vector) convert a Complex3x1 vector to a Complex[] vector
static org.apache.commons.math3.complex.Complex[][][]	toComplexMatrix(Complex3x1[][] matrix) Convert a Complex3x1 matrix to a Complex[3] matrix
static java.lang.String	toString(org.apache.commons.math3.complex.Complex[][] m)
static java.lang.String	toString(int[][] m)
static double[][]	transpose(double[][] t) transpose the matrix, result = [matrix]T
static int[][]	transpose(int[][] t) transpose the matrix, result = [matrix]T

Methods inherited from class java.lang.Object

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

Constructor Detail

MatrixUtil

public MatrixUtil()

Method Detail

mul

public static org.apache.commons.math3.complex.Complex[] mul(org.apache.commons.math3.complex.Complex[][] a,
                                                             org.apache.commons.math3.complex.Complex[] b)
                                                      throws IpssNumericException

complex matrix multiplication [A] x [b]

Parameters:

a - matrix A

b - vector b

Returns:

return vector

Throws:

IpssNumericException

createComplex2DArray

public static org.apache.commons.math3.complex.Complex[][] createComplex2DArray(int row,
                                                                                int col)

create a Complex matrix with all fields initialized to (0.0,0.0)

Parameters:

row - row count

col - column cound

Returns:

createComplex3x32DArray

public static Complex3x3[][] createComplex3x32DArray(int row,
                                                     int col)

create a Complex3x3 block matrix with all fields initialized

Parameters:

row - row count

col - column cound

Returns:

createComplex1DArray

public static org.apache.commons.math3.complex.Complex[] createComplex1DArray(int row)

create a Complex vector with all fields initialized to (0.0,0.0)

Parameters:

row - row count

Returns:

createComplex3x1DArray

public static Complex3x1[] createComplex3x1DArray(int row)

create a Complex3x1 vector with all fields initialized

Parameters:

row - row count

Returns:

multiply

public static double[] multiply(double[][] matrix,
                                double[] vector)
                         throws IpssNumericException

multiply the matrix by the vector.

Parameters:

matrix -

vector -

Returns:

matrix * vector

Throws:

IpssNumericException

multiply

public static Complex3x3[][] multiply(Complex3x3[][] matrix,
                                      int[][] transMatrix)

multiply the matrix by a transformation matrix. result = matrix*transMatrix A typical application is multiplying the ISparseEqnComplexMatrix3x3 matrix by the corresponding incidence matrix

Parameters:

matrix -

transMatrix -

Returns:

matrix * transMatrix

multiply

public static org.apache.commons.math3.complex.Complex[][] multiply(org.apache.commons.math3.complex.Complex[][] matrix,
                                                                    int[][] transMatrix)

multiply the matrix by a transformation matrix. result = matrix*transMatrix

Parameters:

matrix -

transMatrix -

Returns:

matrix * transMatrix

multiply

public static Complex3x1[][] multiply(Complex3x1[][] matrix,
                                      int[][] transMatrix)

multiply the matrix by a transformation matrix. result = matrix*transMatrix

Parameters:

matrix -

transMatrix -

Returns:

matrix * transMatrix

multiply

public static Complex3x3[][] multiply(Complex3x3[][] matrix,
                                      double[][] transMatrix)

multiply the matrix by a transformation matrix. result = matrix*transMatrix A typical application is multiplying the ISparseEqnComplexMatrix3x3 matrix by the corresponding incidence matrix

Parameters:

matrix -

transMatrix -

Returns:

matrix * transMatrix

preMultiply

public static Complex3x3[][] preMultiply(double[][] transMatrix,
                                         Complex3x3[][] matrix)

pre-multiply the matrix by a transformation matrix. result = transMatrix*matrix

Parameters:

transMatrix -

matrix -

Returns:

transMatrix * matrix

preMultiply

public static Complex3x3[][] preMultiply(int[][] transMatrix,
                                         Complex3x3[][] matrix)

pre-multiply the matrix by a transformation matrix. result = transMatrix*matrix

Parameters:

transMatrix -

matrix -

Returns:

transMatrix * matrix

prePostMultiply

public static org.apache.commons.math3.complex.Complex[][] prePostMultiply(org.apache.commons.math3.complex.Complex[][] matrix,
                                                                           int[][] transM)

transpose[M] x [A] x [M]

Parameters:

matrix - matrix [A]

transM - transformation matrix

Returns:

prePostMultiply

public static Complex3x1[][] prePostMultiply(Complex3x1[][] matrix,
                                             int[][] transM)

transpose[M] x [A] x [M]

Parameters:

matrix - matrix [A]

transM - transformation matrix

Returns:

preMultiply

public static org.apache.commons.math3.complex.Complex[][] preMultiply(int[][] transMatrix,
                                                                       org.apache.commons.math3.complex.Complex[][] matrix)

pre-multiply the matrix by a transformation matrix. result = transMatrix*matrix

Parameters:

transMatrix -

matrix -

Returns:

transMatrix * matrix

preMultiply

public static Complex3x1[][] preMultiply(int[][] transMatrix,
                                         Complex3x1[][] matrix)

pre-multiply the matrix by a transformation matrix. result = transMatrix*matrix

Parameters:

transMatrix -

matrix -

Returns:

transMatrix * matrix

preMultiply

public static Complex3x1[] preMultiply(int[][] transMatrix,
                                       Complex3x1[] vector)

pre-multiply the vector by a transformation matrix. result = transMatrix*vector

Parameters:

transMatrix -

vector -

Returns:

transMatrix * vector

preMultiply

public static Complex3x1[] preMultiply(double[][] transMatrix,
                                       Complex3x1[] vector)

pre-multiply the vector by a transformation matrix. result = transMatrix*vector

Parameters:

transMatrix -

vector -

Returns:

transMatrix * vector

add

public static Complex3x3[][] add(Complex3x3[][] A,
                                 Complex3x3[][] B)

add the two matrix together

Parameters:

A -

B -

Returns:

add

public static org.apache.commons.math3.complex.Complex[][] add(org.apache.commons.math3.complex.Complex[][] A,
                                                               org.apache.commons.math3.complex.Complex[][] B)

add the two matrix together

Parameters:

A -

B -

Returns:

add

public static Complex3x1[][] add(Complex3x1[][] A,
                                 Complex3x1[][] B)

add the two matrix together

Parameters:

A -

B -

Returns:

add

public static Complex3x1[] add(Complex3x1[] A,
                               Complex3x1[] B)

add the two vector together

Parameters:

A -

B -

Returns:

transpose

public static int[][] transpose(int[][] t)

transpose the matrix, result = [matrix]T

Parameters:

t -

Returns:

transpose

public static double[][] transpose(double[][] t)

transpose the matrix, result = [matrix]T

Parameters:

t -

Returns:

toComplex3x1Ary

public static Complex3x1[] toComplex3x1Ary(org.apache.commons.math3.complex.Complex[] vector0,
                                           org.apache.commons.math3.complex.Complex[] vector1,
                                           org.apache.commons.math3.complex.Complex[] vector2)

Convert three vectors to a Complex3x1 vector

Parameters:

vector0 -

vector1 -

vector2 -

Returns:

toComplexAry

public static org.apache.commons.math3.complex.Complex[][] toComplexAry(Complex3x1[] vector)

convert a Complex3x1 vector to a Complex[] vector

Parameters:

vector - the Complex3x1 vector

Returns:

the Complex[] vector

toComplexMatrix

public static org.apache.commons.math3.complex.Complex[][][] toComplexMatrix(Complex3x1[][] matrix)

Convert a Complex3x1 matrix to a Complex[3] matrix

Parameters:

matrix - the Complex3x1 matrix

Returns:

the Complex[3] matrix

complex3x32DAry2String

public static java.lang.String complex3x32DAry2String(Complex3x3[][] ary)

complex3x1Ary2String

public static java.lang.String complex3x1Ary2String(Complex3x1[] ary)

complex2DAry2String

public static java.lang.String complex2DAry2String(org.apache.commons.math3.complex.Complex[][] ary)

toString

public static java.lang.String toString(org.apache.commons.math3.complex.Complex[][] m)

toString

public static java.lang.String toString(int[][] m)