Package org.ejml.dense.row

Class CommonOps_CDRM

java.lang.Object

org.ejml.dense.row.CommonOps_CDRM

public class CommonOps_CDRM
extends java.lang.Object

Common operations on complex numbers

Constructor Summary

Constructors

Constructor	Description
CommonOps_CDRM()

Method Summary

Modifier and Type	Method	Description
static void	add(org.ejml.data.CMatrixD1 a, org.ejml.data.CMatrixD1 b, org.ejml.data.CMatrixD1 c)	Performs the following operation: c = a + b cij = aij + bij
static org.ejml.data.CMatrixRMaj[]	columnsToVector(org.ejml.data.CMatrixRMaj A, org.ejml.data.CMatrixRMaj[] v)	Converts the columns in a matrix into a set of vectors.
static void	conjugate(org.ejml.data.CMatrixD1 input, org.ejml.data.CMatrixD1 output)	Computes the complex conjugate of the input matrix. reali,j = reali,j imaginaryi,j = -1*imaginaryi,j
static void	convert(org.ejml.data.FMatrixD1 input, org.ejml.data.CMatrixD1 output)	Converts the real matrix into a complex matrix.
static org.ejml.data.Complex_F32	det(org.ejml.data.CMatrixRMaj mat)	Returns the determinant of the matrix.
static org.ejml.data.CMatrixRMaj	diag(float... data)	Creates a new square matrix whose diagonal elements are specified by data and all the other elements are zero. aij = 0 if i ≤ j aij = diag[i] if i = j
static org.ejml.data.CMatrixRMaj	diag(org.ejml.data.CMatrixRMaj output, int N, float... data)
static void	elementDivide(float real, float imaginary, org.ejml.data.CMatrixD1 input, org.ejml.data.CMatrixD1 output)	Performs element by element division operation with a complex number on the right outputij = (real + imaginary*i) / inputij
static void	elementDivide(org.ejml.data.CMatrixD1 input, float real, float imaginary, org.ejml.data.CMatrixD1 output)	Performs element by element division operation with a complex number on the right outputij = inputij / (real + imaginary*i)
static float	elementMaxAbs(org.ejml.data.CMatrixRMaj a)	Returns the largest absolute value of any element in the matrix. Max{ |aij| } for all i and j
static float	elementMaxImaginary(org.ejml.data.CMatrixD1 a)	Returns the value of the imaginary element in the matrix that has the minimum value. Min{ aij } for all i and j
static float	elementMaxMagnitude2(org.ejml.data.CMatrixD1 a)	Returns the magnitude squared of the complex element with the largest magnitude Max{ |aij|^2 } for all i and j
static float	elementMaxReal(org.ejml.data.CMatrixD1 a)	Returns the value of the real element in the matrix that has the minimum value. Min{ aij } for all i and j
static float	elementMinAbs(org.ejml.data.CMatrixRMaj a)	Returns the smallest absolute value of any element in the matrix. Min{ |aij| } for all i and j
static float	elementMinImaginary(org.ejml.data.CMatrixD1 a)	Returns the value of the imaginary element in the matrix that has the minimum value. Min{ aij } for all i and j
static float	elementMinReal(org.ejml.data.CMatrixD1 a)	Returns the value of the real element in the matrix that has the minimum value. Min{ aij } for all i and j
static void	elementMultiply(org.ejml.data.CMatrixD1 input, float real, float imaginary, org.ejml.data.CMatrixD1 output)	Performs element by element multiplication operation with a complex numbert outputij = inputij * (real + imaginary*i)
static org.ejml.data.CMatrixRMaj	extract(org.ejml.data.CMatrixRMaj src, int srcY0, int srcY1, int srcX0, int srcX1)	Creates a new matrix which is the specified submatrix of 'src'
static void	extract(org.ejml.data.CMatrixRMaj src, int srcY0, int srcY1, int srcX0, int srcX1, org.ejml.data.CMatrixRMaj dst, int dstY0, int dstX0)	Extracts a submatrix from 'src' and inserts it in a submatrix in 'dst'.
static void	extractDiag(org.ejml.data.CMatrixRMaj src, org.ejml.data.CMatrixRMaj dst)	Extracts the diagonal elements 'src' write it to the 'dst' vector.
static void	fill(org.ejml.data.CMatrixD1 a, float real, float imaginary)	Sets every element in the matrix to the specified value. aij = value
static org.ejml.data.CMatrixRMaj	identity(int width)	Creates an identity matrix of the specified size. aij = 0+0i if i ≠ j aij = 1+0i if i = j
static org.ejml.data.CMatrixRMaj	identity(int width, int height)	Creates a matrix with diagonal elements set to 1 and the rest 0. aij = 0+0i if i ≠ j aij = 1+0i if i = j
static boolean	invert(org.ejml.data.CMatrixRMaj A)	Performs a matrix inversion operation on the specified matrix and stores the results in the same matrix. a = a-1
static boolean	invert(org.ejml.data.CMatrixRMaj input, org.ejml.data.CMatrixRMaj output)	Performs a matrix inversion operation that does not modify the original and stores the results in another matrix.
static void	magnitude(org.ejml.data.CMatrixD1 input, org.ejml.data.FMatrixD1 output)	Computes the magnitude of the complex number in the input matrix and stores the results in the output matrix.
static void	mult(float realAlpha, float imgAlpha, org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = α * a * b cij = α ∑k=1:n { * aik * bkj}
static void	mult(org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = a * b cij = ∑k=1:n { * aik * bkj}
static void	multAdd(float realAlpha, float imgAlpha, org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = c + α * a * b cij = cij + α * ∑k=1:n { aik * bkj}
static void	multAdd(org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = c + a * b cij = cij + ∑k=1:n { aik * bkj}
static void	multAddTransA(float realAlpha, float imagAlpha, org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = c + α * aH * b cij =cij + α * ∑k=1:n { aki * bkj}
static void	multAddTransA(org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = c + aH * b cij = cij + ∑k=1:n { aki * bkj}
static void	multAddTransAB(float realAlpha, float imagAlpha, org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = c + α * aH * bH cij = cij + α * ∑k=1:n { aki * bjk}
static void	multAddTransAB(org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = c + aH * bH cij = cij + ∑k=1:n { aki * bjk}
static void	multAddTransB(float realAlpha, float imagAlpha, org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = c + α * a * bH cij = cij + α * ∑k=1:n { aik * bjk}
static void	multAddTransB(org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = c + a * bH cij = cij + ∑k=1:n { aik * bjk}
static void	multTransA(float realAlpha, float imagAlpha, org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = α * aH * b cij = α ∑k=1:n { aki * bkj}
static void	multTransA(org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = aH * b cij = ∑k=1:n { aki * bkj}
static void	multTransAB(float realAlpha, float imagAlpha, org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = α * aH * bH cij = α ∑k=1:n { aki * bjk}
static void	multTransAB(org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = aT * bT cij = ∑k=1:n { aki * bjk}
static void	multTransB(float realAlpha, float imagAlpha, org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = α * a * bH cij = α ∑k=1:n { aik * bjk}
static void	multTransB(org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj c)	Performs the following operation: c = a * bH cij = ∑k=1:n { aik * bjk}
static void	scale(float alphaReal, float alphaImag, org.ejml.data.CMatrixD1 a)	Performs an in-place element by element scalar multiplication. aij = α*aij
static void	setIdentity(org.ejml.data.CMatrixRMaj mat)	Sets all the diagonal elements equal to one and everything else equal to zero.
static boolean	solve(org.ejml.data.CMatrixRMaj a, org.ejml.data.CMatrixRMaj b, org.ejml.data.CMatrixRMaj x)	Solves for x in the following equation: A*x = b
static org.ejml.data.FMatrixRMaj	stripImaginary(org.ejml.data.CMatrixD1 input, org.ejml.data.FMatrixRMaj output)	Places the imaginary component of the input matrix into the output matrix.
static org.ejml.data.FMatrixRMaj	stripReal(org.ejml.data.CMatrixD1 input, org.ejml.data.FMatrixRMaj output)	Places the real component of the input matrix into the output matrix.
static void	subtract(org.ejml.data.CMatrixD1 a, org.ejml.data.CMatrixD1 b, org.ejml.data.CMatrixD1 c)	Performs the following operation: c = a - b cij = aij - bij
static void	transpose(org.ejml.data.CMatrixRMaj mat)	Performs an "in-place" transpose.
static org.ejml.data.CMatrixRMaj	transpose(org.ejml.data.CMatrixRMaj input, org.ejml.data.CMatrixRMaj output)	Transposes input matrix 'a' and stores the results in output matrix 'b': bij = aji where 'b' is the transpose of 'a'.
static void	transposeConjugate(org.ejml.data.CMatrixRMaj mat)	Performs an "in-place" conjugate transpose.
static org.ejml.data.CMatrixRMaj	transposeConjugate(org.ejml.data.CMatrixRMaj input, org.ejml.data.CMatrixRMaj output)	Conjugate transposes input matrix 'a' and stores the results in output matrix 'b': b-reali,j = a-realj,i b-imaginaryi,j = -1*a-imaginaryj,i where 'b' is the transpose of 'a'.

Methods inherited from class java.lang.Object

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

Constructor Detail

CommonOps_CDRM

public CommonOps_CDRM()

Method Detail

identity

public static org.ejml.data.CMatrixRMaj identity(int width)

Creates an identity matrix of the specified size.

a_ij = 0+0i if i ≠ j
a_ij = 1+0i if i = j

Parameters:

width - The width and height of the identity matrix.

Returns:

A new instance of an identity matrix.

identity

public static org.ejml.data.CMatrixRMaj identity(int width,
                                                 int height)

Creates a matrix with diagonal elements set to 1 and the rest 0.

a_ij = 0+0i if i ≠ j
a_ij = 1+0i if i = j

Parameters:

width - The width of the identity matrix.

height - The height of the identity matrix.

Returns:

A new instance of an identity matrix.

diag

public static org.ejml.data.CMatrixRMaj diag(float... data)

Creates a new square matrix whose diagonal elements are specified by data and all the other elements are zero.

a_ij = 0 if i ≤ j
a_ij = diag[i] if i = j

Parameters:

data - Contains the values of the diagonal elements of the resulting matrix.

Returns:

A new complex matrix.

diag

public static org.ejml.data.CMatrixRMaj diag(org.ejml.data.CMatrixRMaj output,
                                             int N,
                                             float... data)

extractDiag

public static void extractDiag(org.ejml.data.CMatrixRMaj src,
                               org.ejml.data.CMatrixRMaj dst)

Extracts the diagonal elements 'src' write it to the 'dst' vector. 'dst' can either be a row or column vector.

Parameters:

src - Matrix whose diagonal elements are being extracted. Not modified.

dst - A vector the results will be written into. Modified.

convert

public static void convert(org.ejml.data.FMatrixD1 input,
                           org.ejml.data.CMatrixD1 output)

Converts the real matrix into a complex matrix.

Parameters:

input - Real matrix. Not modified.

output - Complex matrix. Modified.

stripReal

public static org.ejml.data.FMatrixRMaj stripReal(org.ejml.data.CMatrixD1 input,
                                                  org.ejml.data.FMatrixRMaj output)

Places the real component of the input matrix into the output matrix.

Parameters:

input - Complex matrix. Not modified.

output - real matrix. Modified.

stripImaginary

public static org.ejml.data.FMatrixRMaj stripImaginary(org.ejml.data.CMatrixD1 input,
                                                       org.ejml.data.FMatrixRMaj output)

Places the imaginary component of the input matrix into the output matrix.

Parameters:

input - Complex matrix. Not modified.

output - real matrix. Modified.

magnitude

public static void magnitude(org.ejml.data.CMatrixD1 input,
                             org.ejml.data.FMatrixD1 output)

Computes the magnitude of the complex number in the input matrix and stores the results in the output matrix.

magnitude = sqrt(real^2 + imaginary^2)

Parameters:

input - Complex matrix. Not modified.

output - real matrix. Modified.

conjugate

public static void conjugate(org.ejml.data.CMatrixD1 input,
                             org.ejml.data.CMatrixD1 output)

Computes the complex conjugate of the input matrix.

real_i,j = real_i,j
imaginary_i,j = -1*imaginary_i,j

Parameters:

input - Input matrix. Not modified.

output - The complex conjugate of the input matrix. Modified.

fill

public static void fill(org.ejml.data.CMatrixD1 a,
                        float real,
                        float imaginary)

Sets every element in the matrix to the specified value.

a_ij = value

Parameters:

a - A matrix whose elements are about to be set. Modified.

real - The real component

imaginary - The imaginary component

add

public static void add(org.ejml.data.CMatrixD1 a,
                       org.ejml.data.CMatrixD1 b,
                       org.ejml.data.CMatrixD1 c)

Performs the following operation:

c = a + b
c_ij = a_ij + b_ij

Matrix C can be the same instance as Matrix A and/or B.

Parameters:

a - A Matrix. Not modified.

b - A Matrix. Not modified.

c - A Matrix where the results are stored. Modified.

subtract

public static void subtract(org.ejml.data.CMatrixD1 a,
                            org.ejml.data.CMatrixD1 b,
                            org.ejml.data.CMatrixD1 c)

Performs the following operation:

c = a - b
c_ij = a_ij - b_ij

Matrix C can be the same instance as Matrix A and/or B.

Parameters:

a - A Matrix. Not modified.

b - A Matrix. Not modified.

c - A Matrix where the results are stored. Modified.

scale

public static void scale(float alphaReal,
                         float alphaImag,
                         org.ejml.data.CMatrixD1 a)

Performs an in-place element by element scalar multiplication.

a_ij = α*a_ij

Parameters:

a - The matrix that is to be scaled. Modified.

alphaReal - real component of scale factor

alphaImag - imaginary component of scale factor

mult

public static void mult(org.ejml.data.CMatrixRMaj a,
                        org.ejml.data.CMatrixRMaj b,
                        org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = a * b

c_ij = ∑_k=1:n { * a_ik * b_kj}

Parameters:

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

mult

public static void mult(float realAlpha,
                        float imgAlpha,
                        org.ejml.data.CMatrixRMaj a,
                        org.ejml.data.CMatrixRMaj b,
                        org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = α * a * b

c_ij = α ∑_k=1:n { * a_ik * b_kj}

Parameters:

realAlpha - real component of scaling factor.

imgAlpha - imaginary component of scaling factor.

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multAdd

public static void multAdd(org.ejml.data.CMatrixRMaj a,
                           org.ejml.data.CMatrixRMaj b,
                           org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = c + a * b
c_ij = c_ij + ∑_k=1:n { a_ik * b_kj}

Parameters:

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multAdd

public static void multAdd(float realAlpha,
                           float imgAlpha,
                           org.ejml.data.CMatrixRMaj a,
                           org.ejml.data.CMatrixRMaj b,
                           org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = c + α * a * b
c_ij = c_ij + α * ∑_k=1:n { a_ik * b_kj}

Parameters:

realAlpha - real component of scaling factor.

imgAlpha - imaginary component of scaling factor.

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multTransA

public static void multTransA(org.ejml.data.CMatrixRMaj a,
                              org.ejml.data.CMatrixRMaj b,
                              org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = a^H * b

c_ij = ∑_k=1:n { a_ki * b_kj}

Parameters:

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multTransA

public static void multTransA(float realAlpha,
                              float imagAlpha,
                              org.ejml.data.CMatrixRMaj a,
                              org.ejml.data.CMatrixRMaj b,
                              org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = α * a^H * b

c_ij = α ∑_k=1:n { a_ki * b_kj}

Parameters:

realAlpha - Real component of scaling factor.

imagAlpha - Imaginary component of scaling factor.

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multTransB

public static void multTransB(org.ejml.data.CMatrixRMaj a,
                              org.ejml.data.CMatrixRMaj b,
                              org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = a * b^H
c_ij = ∑_k=1:n { a_ik * b_jk}

Parameters:

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multTransB

public static void multTransB(float realAlpha,
                              float imagAlpha,
                              org.ejml.data.CMatrixRMaj a,
                              org.ejml.data.CMatrixRMaj b,
                              org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = α * a * b^H
c_ij = α ∑_k=1:n { a_ik * b_jk}

Parameters:

realAlpha - Real component of scaling factor.

imagAlpha - Imaginary component of scaling factor.

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multTransAB

public static void multTransAB(org.ejml.data.CMatrixRMaj a,
                               org.ejml.data.CMatrixRMaj b,
                               org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = a^T * b^T
c_ij = ∑_k=1:n { a_ki * b_jk}

Parameters:

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multTransAB

public static void multTransAB(float realAlpha,
                               float imagAlpha,
                               org.ejml.data.CMatrixRMaj a,
                               org.ejml.data.CMatrixRMaj b,
                               org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = α * a^H * b^H
c_ij = α ∑_k=1:n { a_ki * b_jk}

Parameters:

realAlpha - Real component of scaling factor.

imagAlpha - Imaginary component of scaling factor.

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multAddTransA

public static void multAddTransA(org.ejml.data.CMatrixRMaj a,
                                 org.ejml.data.CMatrixRMaj b,
                                 org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = c + a^H * b
c_ij = c_ij + ∑_k=1:n { a_ki * b_kj}

Parameters:

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multAddTransA

public static void multAddTransA(float realAlpha,
                                 float imagAlpha,
                                 org.ejml.data.CMatrixRMaj a,
                                 org.ejml.data.CMatrixRMaj b,
                                 org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = c + α * a^H * b
c_ij =c_ij + α * ∑_k=1:n { a_ki * b_kj}

Parameters:

realAlpha - Real component of scaling factor.

imagAlpha - Imaginary component of scaling factor.

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multAddTransB

public static void multAddTransB(org.ejml.data.CMatrixRMaj a,
                                 org.ejml.data.CMatrixRMaj b,
                                 org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = c + a * b^H
c_ij = c_ij + ∑_k=1:n { a_ik * b_jk}

Parameters:

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multAddTransB

public static void multAddTransB(float realAlpha,
                                 float imagAlpha,
                                 org.ejml.data.CMatrixRMaj a,
                                 org.ejml.data.CMatrixRMaj b,
                                 org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = c + α * a * b^H
c_ij = c_ij + α * ∑_k=1:n { a_ik * b_jk}

Parameters:

realAlpha - Real component of scaling factor.

imagAlpha - Imaginary component of scaling factor.

a - The left matrix in the multiplication operation. Not modified.

b - The right matrix in the multiplication operation. Not modified.

c - Where the results of the operation are stored. Modified.

multAddTransAB

public static void multAddTransAB(org.ejml.data.CMatrixRMaj a,
                                  org.ejml.data.CMatrixRMaj b,
                                  org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = c + a^H * b^H
c_ij = c_ij + ∑_k=1:n { a_ki * b_jk}

Parameters:

a - The left matrix in the multiplication operation. Not Modified.

b - The right matrix in the multiplication operation. Not Modified.

c - Where the results of the operation are stored. Modified.

multAddTransAB

public static void multAddTransAB(float realAlpha,
                                  float imagAlpha,
                                  org.ejml.data.CMatrixRMaj a,
                                  org.ejml.data.CMatrixRMaj b,
                                  org.ejml.data.CMatrixRMaj c)

Performs the following operation:

c = c + α * a^H * b^H
c_ij = c_ij + α * ∑_k=1:n { a_ki * b_jk}

Parameters:

realAlpha - Real component of scaling factor.

imagAlpha - Imaginary component of scaling factor.

a - The left matrix in the multiplication operation. Not Modified.

b - The right matrix in the multiplication operation. Not Modified.

c - Where the results of the operation are stored. Modified.

transpose

public static void transpose(org.ejml.data.CMatrixRMaj mat)

Performs an "in-place" transpose.

For square matrices the transpose is truly in-place and does not require additional memory. For non-square matrices, internally a temporary matrix is declared and transpose(CMatrixRMaj, CMatrixRMaj) is invoked.

Parameters:

mat - The matrix that is to be transposed. Modified.

transposeConjugate

public static void transposeConjugate(org.ejml.data.CMatrixRMaj mat)

Performs an "in-place" conjugate transpose.

Parameters:

mat - The matrix that is to be transposed. Modified.

See Also:

transpose(CMatrixRMaj)

transpose

public static org.ejml.data.CMatrixRMaj transpose(org.ejml.data.CMatrixRMaj input,
                                                  org.ejml.data.CMatrixRMaj output)

Transposes input matrix 'a' and stores the results in output matrix 'b':

b_ij = a_ji
where 'b' is the transpose of 'a'.

Parameters:

input - The original matrix. Not modified.

output - Where the transpose is stored. If null a new matrix is created. Modified.

Returns:

The transposed matrix.

transposeConjugate

public static org.ejml.data.CMatrixRMaj transposeConjugate(org.ejml.data.CMatrixRMaj input,
                                                           org.ejml.data.CMatrixRMaj output)

Conjugate transposes input matrix 'a' and stores the results in output matrix 'b':

b-real_i,j = a-real_j,i
b-imaginary_i,j = -1*a-imaginary_j,i
where 'b' is the transpose of 'a'.

Parameters:

input - The original matrix. Not modified.

output - Where the transpose is stored. If null a new matrix is created. Modified.

Returns:

The transposed matrix.

invert

public static boolean invert(org.ejml.data.CMatrixRMaj A)

Performs a matrix inversion operation on the specified matrix and stores the results in the same matrix.

a = a^-1

If the algorithm could not invert the matrix then false is returned. If it returns true that just means the algorithm finished. The results could still be bad because the matrix is singular or nearly singular.

Parameters:

A - The matrix that is to be inverted. Results are stored here. Modified.

Returns:

true if it could invert the matrix false if it could not.

invert

public static boolean invert(org.ejml.data.CMatrixRMaj input,
                             org.ejml.data.CMatrixRMaj output)

Performs a matrix inversion operation that does not modify the original and stores the results in another matrix. The two matrices must have the same dimension.

b = a^-1

If the algorithm could not invert the matrix then false is returned. If it returns true that just means the algorithm finished. The results could still be bad because the matrix is singular or nearly singular.

For medium to large matrices there might be a slight performance boost to using LinearSolverFactory_CDRM instead.

Parameters:

input - The matrix that is to be inverted. Not modified.

output - Where the inverse matrix is stored. Modified.

Returns:

true if it could invert the matrix false if it could not.

solve

public static boolean solve(org.ejml.data.CMatrixRMaj a,
                            org.ejml.data.CMatrixRMaj b,
                            org.ejml.data.CMatrixRMaj x)

Solves for x in the following equation:

A*x = b

If the system could not be solved then false is returned. If it returns true that just means the algorithm finished operating, but the results could still be bad because 'A' is singular or nearly singular.

If repeat calls to solve are being made then one should consider using LinearSolverFactory_CDRM instead.

It is ok for 'b' and 'x' to be the same matrix.

Parameters:

a - A matrix that is m by n. Not modified.

b - A matrix that is n by k. Not modified.

x - A matrix that is m by k. Modified.

Returns:

true if it could invert the matrix false if it could not.

det

public static org.ejml.data.Complex_F32 det(org.ejml.data.CMatrixRMaj mat)

Returns the determinant of the matrix. If the inverse of the matrix is also needed, then using LUDecompositionAlt_CDRM directly (or any similar algorithm) can be more efficient.

Parameters:

mat - The matrix whose determinant is to be computed. Not modified.

Returns:

The determinant.

elementMultiply

public static void elementMultiply(org.ejml.data.CMatrixD1 input,
                                   float real,
                                   float imaginary,
                                   org.ejml.data.CMatrixD1 output)

Performs element by element multiplication operation with a complex numbert

output_ij = input_ij * (real + imaginary*i)

Parameters:

input - The left matrix in the multiplication operation. Not modified.

real - Real component of the number it is multiplied by

imaginary - Imaginary component of the number it is multiplied by

output - Where the results of the operation are stored. Modified.

elementDivide

public static void elementDivide(org.ejml.data.CMatrixD1 input,
                                 float real,
                                 float imaginary,
                                 org.ejml.data.CMatrixD1 output)

Performs element by element division operation with a complex number on the right

output_ij = input_ij / (real + imaginary*i)

Parameters:

input - The left matrix in the multiplication operation. Not modified.

real - Real component of the number it is multiplied by

imaginary - Imaginary component of the number it is multiplied by

output - Where the results of the operation are stored. Modified.

elementDivide

public static void elementDivide(float real,
                                 float imaginary,
                                 org.ejml.data.CMatrixD1 input,
                                 org.ejml.data.CMatrixD1 output)

Performs element by element division operation with a complex number on the right

output_ij = (real + imaginary*i) / input_ij

Parameters:

real - Real component of the number it is multiplied by

imaginary - Imaginary component of the number it is multiplied by

input - The right matrix in the multiplication operation. Not modified.

output - Where the results of the operation are stored. Modified.

elementMinReal

public static float elementMinReal(org.ejml.data.CMatrixD1 a)

Returns the value of the real element in the matrix that has the minimum value.

Min{ a_ij } for all i and j

Parameters:

a - A matrix. Not modified.

Returns:

The the minimum value out of all the real values.

elementMinImaginary

public static float elementMinImaginary(org.ejml.data.CMatrixD1 a)

Returns the value of the imaginary element in the matrix that has the minimum value.

Min{ a_ij } for all i and j

Parameters:

a - A matrix. Not modified.

Returns:

The the minimum value out of all the real values.

elementMaxReal

public static float elementMaxReal(org.ejml.data.CMatrixD1 a)

Returns the value of the real element in the matrix that has the minimum value.

Min{ a_ij } for all i and j

Parameters:

a - A matrix. Not modified.

Returns:

The the minimum value out of all the real values.

elementMaxImaginary

public static float elementMaxImaginary(org.ejml.data.CMatrixD1 a)

Returns the value of the imaginary element in the matrix that has the minimum value.

Min{ a_ij } for all i and j

Parameters:

a - A matrix. Not modified.

Returns:

The the minimum value out of all the real values.

elementMaxMagnitude2

public static float elementMaxMagnitude2(org.ejml.data.CMatrixD1 a)

Returns the magnitude squared of the complex element with the largest magnitude

Max{ |a_ij|^2 } for all i and j

Parameters:

a - A matrix. Not modified.

Returns:

The max magnitude squared

setIdentity

public static void setIdentity(org.ejml.data.CMatrixRMaj mat)

Sets all the diagonal elements equal to one and everything else equal to zero. If this is a square matrix then it will be an identity matrix.

Parameters:

mat - A square matrix.

extract

public static org.ejml.data.CMatrixRMaj extract(org.ejml.data.CMatrixRMaj src,
                                                int srcY0,
                                                int srcY1,
                                                int srcX0,
                                                int srcX1)

Creates a new matrix which is the specified submatrix of 'src'

s_{i-y0 , j-x0} = o_ij for all y0 ≤ i < y1 and x0 ≤ j < x1

where 's_ij' is an element in the submatrix and 'o_ij' is an element in the original matrix.

Parameters:

src - The original matrix which is to be copied. Not modified.

srcX0 - Start column.

srcX1 - Stop column+1.

srcY0 - Start row.

srcY1 - Stop row+1.

Returns:

Extracted submatrix.

extract

public static void extract(org.ejml.data.CMatrixRMaj src,
                           int srcY0,
                           int srcY1,
                           int srcX0,
                           int srcX1,
                           org.ejml.data.CMatrixRMaj dst,
                           int dstY0,
                           int dstX0)

Extracts a submatrix from 'src' and inserts it in a submatrix in 'dst'.

s_{i-y0 , j-x0} = o_ij for all y0 ≤ i < y1 and x0 ≤ j < x1

where 's_ij' is an element in the submatrix and 'o_ij' is an element in the original matrix.

Parameters:

src - The original matrix which is to be copied. Not modified.

srcX0 - Start column.

srcX1 - Stop column+1.

srcY0 - Start row.

srcY1 - Stop row+1.

dst - Where the submatrix are stored. Modified.

dstY0 - Start row in dst.

dstX0 - start column in dst.

columnsToVector

public static org.ejml.data.CMatrixRMaj[] columnsToVector(org.ejml.data.CMatrixRMaj A,
                                                          org.ejml.data.CMatrixRMaj[] v)

Converts the columns in a matrix into a set of vectors.

Parameters:

A - Matrix. Not modified.

v - Optional storage for columns.

Returns:

An array of vectors.

elementMaxAbs

public static float elementMaxAbs(org.ejml.data.CMatrixRMaj a)

Returns the largest absolute value of any element in the matrix.

Max{ |a_ij| } for all i and j

Parameters:

a - A matrix. Not modified.

Returns:

The max abs element value in the matrix.

elementMinAbs

public static float elementMinAbs(org.ejml.data.CMatrixRMaj a)

Returns the smallest absolute value of any element in the matrix.

Min{ |a_ij| } for all i and j

Parameters:

a - A matrix. Not modified.

Returns:

The min abs element value in the matrix.