Package org.apache.commons.math.linear

Class BigMatrixImpl

java.lang.Object
org.apache.commons.math.linear.BigMatrixImpl
All Implemented Interfaces:
Serializable, AnyMatrix, BigMatrix
@Deprecated public class BigMatrixImpl extends Object implements BigMatrix, Serializable
Deprecated.
as of 2.0, replaced by Array2DRowFieldMatrix with a BigReal parameter
Implementation of BigMatrix using a BigDecimal[][] array to store entries and LU decompostion to support linear system solution and inverse.

The LU decompostion is performed as needed, to support the following operations:

  • solve
  • isSingular
  • getDeterminant
  • inverse

Usage notes:

  • The LU decomposition is stored and reused on subsequent calls. If matrix data are modified using any of the public setXxx methods, the saved decomposition is discarded. If data are modified via references to the underlying array obtained using getDataRef(), then the stored LU decomposition will not be discarded. In this case, you need to explicitly invoke LUDecompose() to recompute the decomposition before using any of the methods above.
  • As specified in the BigMatrix interface, matrix element indexing is 0-based -- e.g., getEntry(0, 0) returns the element in the first row, first column of the matrix.

See Also:

  • Constructor Summary

    Constructors
    Constructor
    Description
    BigMatrixImpl()
    Deprecated.
    Creates a matrix with no data
    BigMatrixImpl(double[][] d)
    Deprecated.
    Create a new BigMatrix using d as the underlying data array.
    BigMatrixImpl(int rowDimension, int columnDimension)
    Deprecated.
    Create a new BigMatrix with the supplied row and column dimensions.
    BigMatrixImpl(String[][] d)
    Deprecated.
    Create a new BigMatrix using the values represented by the strings in d as the underlying data array.
    BigMatrixImpl(BigDecimal[] v)
    Deprecated.
    Create a new (column) BigMatrix using v as the data for the unique column of the v.length x 1 matrix created.
    BigMatrixImpl(BigDecimal[][] d)
    Deprecated.
    Create a new BigMatrix using d as the underlying data array.
    BigMatrixImpl(BigDecimal[][] d, boolean copyArray)
    Deprecated.
    Create a new BigMatrix using the input array as the underlying data array.

  • Method Summary

    Modifier and Type
    Method
    Description
    BigMatrix
    add(BigMatrix m)
    Deprecated.
    Compute the sum of this and m.
    BigMatrixImpl
    add(BigMatrixImpl m)
    Deprecated.
    Compute the sum of this and m.
    BigMatrix
    copy()
    Deprecated.
    Create a new BigMatrix which is a copy of this.
    boolean
    equals(Object object)
    Deprecated.
    Returns true iff object is a BigMatrixImpl instance with the same dimensions as this and all corresponding matrix entries are equal.
    BigDecimal[]
    getColumn(int col)
    Deprecated.
    Returns the entries in column number col as an array.
    double[]
    getColumnAsDoubleArray(int col)
    Deprecated.
    Returns the entries in column number col as an array of double values.
    int
    getColumnDimension()
    Deprecated.
    Returns the number of columns in the matrix.
    BigMatrix
    getColumnMatrix(int column)
    Deprecated.
    Returns the entries in column number column as a column matrix.
    BigDecimal[][]
    getData()
    Deprecated.
    Returns matrix entries as a two-dimensional array.
    double[][]
    getDataAsDoubleArray()
    Deprecated.
    Returns matrix entries as a two-dimensional array.
    BigDecimal[][]
    getDataRef()
    Deprecated.
    Returns a reference to the underlying data array.
    BigDecimal
    getDeterminant()
    Deprecated.
    Returns the determinant of this matrix.
    BigDecimal
    getEntry(int row, int column)
    Deprecated.
    Returns the entry in the specified row and column.
    double
    getEntryAsDouble(int row, int column)
    Deprecated.
    Returns the entry in the specified row and column as a double.
    BigDecimal
    getNorm()
    Deprecated.
    Returns the maximum absolute row sum norm of the matrix.
    int
    getRoundingMode()
    Deprecated.
    Gets the rounding mode for division operations The default is BigDecimal.ROUND_HALF_UP
    BigDecimal[]
    getRow(int row)
    Deprecated.
    Returns the entries in row number row as an array.
    double[]
    getRowAsDoubleArray(int row)
    Deprecated.
    Returns the entries in row number row as an array of double values.
    int
    getRowDimension()
    Deprecated.
    Returns the number of rows in the matrix.
    BigMatrix
    getRowMatrix(int row)
    Deprecated.
    Returns the entries in row number row as a row matrix.
    int
    getScale()
    Deprecated.
    Sets the scale for division operations.
    BigMatrix
    getSubMatrix(int[] selectedRows, int[] selectedColumns)
    Deprecated.
    Gets a submatrix.
    BigMatrix
    getSubMatrix(int startRow, int endRow, int startColumn, int endColumn)
    Deprecated.
    Gets a submatrix.
    BigDecimal
    getTrace()
    Deprecated.
    Returns the trace of the matrix (the sum of the elements on the main diagonal).
    int
    hashCode()
    Deprecated.
    Computes a hashcode for the matrix.
    BigMatrix
    inverse()
    Deprecated.
    Returns the inverse matrix if this matrix is invertible.
    boolean
    isSingular()
    Deprecated.
    Is this a singular matrix?
    boolean
    isSquare()
    Deprecated.
    Is this a square matrix?
    void
    luDecompose()
    Deprecated.
    Computes a new LU decompostion for this matrix, storing the result for use by other methods.
    BigMatrix
    multiply(BigMatrix m)
    Deprecated.
    Returns the result of postmultiplying this by m.
    BigMatrixImpl
    multiply(BigMatrixImpl m)
    Deprecated.
    Returns the result of postmultiplying this by m.
    BigDecimal[]
    operate(double[] v)
    Deprecated.
    Returns the result of multiplying this by the vector v.
    BigDecimal[]
    operate(BigDecimal[] v)
    Deprecated.
    Returns the result of multiplying this by the vector v.
    BigDecimal[]
    preMultiply(BigDecimal[] v)
    Deprecated.
    Returns the (row) vector result of premultiplying this by the vector v.
    BigMatrix
    preMultiply(BigMatrix m)
    Deprecated.
    Returns the result premultiplying this by m.
    BigMatrix
    scalarAdd(BigDecimal d)
    Deprecated.
    Returns the result of adding d to each entry of this.
    BigMatrix
    scalarMultiply(BigDecimal d)
    Deprecated.
    Returns the result of multiplying each entry of this by d
    void
    setRoundingMode(int roundingMode)
    Deprecated.
    Sets the rounding mode for decimal divisions.
    void
    setScale(int scale)
    Deprecated.
    Sets the scale for division operations.
    void
    setSubMatrix(BigDecimal[][] subMatrix, int row, int column)
    Deprecated.
    Replace the submatrix starting at row, column using data in the input subMatrix array.
    BigDecimal[]
    solve(double[] b)
    Deprecated.
    Returns a matrix of (column) solution vectors for linear systems with coefficient matrix = this and constant vectors = columns of b.
    BigDecimal[]
    solve(BigDecimal[] b)
    Deprecated.
    Returns a matrix of (column) solution vectors for linear systems with coefficient matrix = this and constant vectors = columns of b.
    BigMatrix
    solve(BigMatrix b)
    Deprecated.
    Returns a matrix of (column) solution vectors for linear systems with coefficient matrix = this and constant vectors = columns of b.
    BigMatrix
    subtract(BigMatrix m)
    Deprecated.
    Compute this minus m.
    BigMatrixImpl
    subtract(BigMatrixImpl m)
    Deprecated.
    Compute this minus m.
    String
    toString()
    Deprecated.
    Get a string representation for this matrix.
    BigMatrix
    transpose()
    Deprecated.
    Returns the transpose matrix.

    Methods inherited from class java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • BigMatrixImpl

      public BigMatrixImpl()
      Deprecated.
      Creates a matrix with no data

    • BigMatrixImpl

      public BigMatrixImpl(int rowDimension, int columnDimension)
      Deprecated.
      Create a new BigMatrix with the supplied row and column dimensions.
      Parameters:
      rowDimension - the number of rows in the new matrix
      columnDimension - the number of columns in the new matrix
      Throws:
      IllegalArgumentException - if row or column dimension is not positive

    • BigMatrixImpl

      public BigMatrixImpl(BigDecimal[][] d)
      Deprecated.
      Create a new BigMatrix using d as the underlying data array.

      The input array is copied, not referenced. This constructor has the same effect as calling BigMatrixImpl(BigDecimal[][], boolean) with the second argument set to true.

      Parameters:
      d - data for new matrix
      Throws:
      IllegalArgumentException - if d is not rectangular (not all rows have the same length) or empty
      NullPointerException - if d is null

    • BigMatrixImpl

      public BigMatrixImpl(BigDecimal[][] d, boolean copyArray)
      Deprecated.
      Create a new BigMatrix using the input array as the underlying data array.

      If an array is built specially in order to be embedded in a BigMatrix and not used directly, the copyArray may be set to falseinvalid input: '<'/code. This will prevent the copying and improve performance as no new array will be built and no data will be copied.

      Parameters:
      d - data for new matrix
      copyArray - if true, the input array will be copied, otherwise it will be referenced
      Throws:
      IllegalArgumentException - if d is not rectangular (not all rows have the same length) or empty
      NullPointerException - if d is null
      See Also:

    • BigMatrixImpl

      public BigMatrixImpl(double[][] d)
      Deprecated.
      Create a new BigMatrix using d as the underlying data array.

      Since the underlying array will hold BigDecimal instances, it will be created.

      Parameters:
      d - data for new matrix
      Throws:
      IllegalArgumentException - if d is not rectangular (not all rows have the same length) or empty
      NullPointerException - if d is null

    • BigMatrixImpl

      public BigMatrixImpl(String[][] d)
      Deprecated.
      Create a new BigMatrix using the values represented by the strings in d as the underlying data array.
      Parameters:
      d - data for new matrix
      Throws:
      IllegalArgumentException - if d is not rectangular (not all rows have the same length) or empty
      NullPointerException - if d is null

    • BigMatrixImpl

      public BigMatrixImpl(BigDecimal[] v)
      Deprecated.
      Create a new (column) BigMatrix using v as the data for the unique column of the v.length x 1 matrix created.

      The input array is copied, not referenced.

      Parameters:
      v - column vector holding data for new matrix

  • Method Details

    • copy

      public BigMatrix copy()
      Deprecated.
      Create a new BigMatrix which is a copy of this.
      Specified by:
      copy in interface BigMatrix
      Returns:
      the cloned matrix

    • add

      public BigMatrix add(BigMatrix m) throws IllegalArgumentException
      Deprecated.
      Compute the sum of this and m.
      Specified by:
      add in interface BigMatrix
      Parameters:
      m - matrix to be added
      Returns:
      this + m
      Throws:
      IllegalArgumentException - if m is not the same size as this

    • add

      public BigMatrixImpl add(BigMatrixImpl m) throws IllegalArgumentException
      Deprecated.
      Compute the sum of this and m.
      Parameters:
      m - matrix to be added
      Returns:
      this + m
      Throws:
      IllegalArgumentException - if m is not the same size as this

    • subtract

      public BigMatrix subtract(BigMatrix m) throws IllegalArgumentException
      Deprecated.
      Compute this minus m.
      Specified by:
      subtract in interface BigMatrix
      Parameters:
      m - matrix to be subtracted
      Returns:
      this + m
      Throws:
      IllegalArgumentException - if m is not the same size as this

    • subtract

      public BigMatrixImpl subtract(BigMatrixImpl m) throws IllegalArgumentException
      Deprecated.
      Compute this minus m.
      Parameters:
      m - matrix to be subtracted
      Returns:
      this + m
      Throws:
      IllegalArgumentException - if m is not the same size as this

    • scalarAdd

      public BigMatrix scalarAdd(BigDecimal d)
      Deprecated.
      Returns the result of adding d to each entry of this.
      Specified by:
      scalarAdd in interface BigMatrix
      Parameters:
      d - value to be added to each entry
      Returns:
      d + this

    • scalarMultiply

      public BigMatrix scalarMultiply(BigDecimal d)
      Deprecated.
      Returns the result of multiplying each entry of this by d
      Specified by:
      scalarMultiply in interface BigMatrix
      Parameters:
      d - value to multiply all entries by
      Returns:
      d * this

    • multiply

      public BigMatrix multiply(BigMatrix m) throws IllegalArgumentException
      Deprecated.
      Returns the result of postmultiplying this by m.
      Specified by:
      multiply in interface BigMatrix
      Parameters:
      m - matrix to postmultiply by
      Returns:
      this*m
      Throws:
      IllegalArgumentException - if columnDimension(this) != rowDimension(m)

    • multiply

      public BigMatrixImpl multiply(BigMatrixImpl m) throws IllegalArgumentException
      Deprecated.
      Returns the result of postmultiplying this by m.
      Parameters:
      m - matrix to postmultiply by
      Returns:
      this*m
      Throws:
      IllegalArgumentException - if columnDimension(this) != rowDimension(m)

    • preMultiply

      public BigMatrix preMultiply(BigMatrix m) throws IllegalArgumentException
      Deprecated.
      Returns the result premultiplying this by m.
      Specified by:
      preMultiply in interface BigMatrix
      Parameters:
      m - matrix to premultiply by
      Returns:
      m * this
      Throws:
      IllegalArgumentException - if rowDimension(this) != columnDimension(m)

    • getData

      public BigDecimal[][] getData()
      Deprecated.
      Returns matrix entries as a two-dimensional array.

      Makes a fresh copy of the underlying data.

      Specified by:
      getData in interface BigMatrix
      Returns:
      2-dimensional array of entries

    • getDataAsDoubleArray

      public double[][] getDataAsDoubleArray()
      Deprecated.
      Returns matrix entries as a two-dimensional array.

      Makes a fresh copy of the underlying data converted to double values.

      Specified by:
      getDataAsDoubleArray in interface BigMatrix
      Returns:
      2-dimensional array of entries

    • getDataRef

      public BigDecimal[][] getDataRef()
      Deprecated.
      Returns a reference to the underlying data array.

      Does not make a fresh copy of the underlying data.

      Returns:
      2-dimensional array of entries

    • getRoundingMode

      public int getRoundingMode()
      Deprecated.
      Gets the rounding mode for division operations The default is BigDecimal.ROUND_HALF_UP
      Specified by:
      getRoundingMode in interface BigMatrix
      Returns:
      the rounding mode.
      See Also:

    • setRoundingMode

      public void setRoundingMode(int roundingMode)
      Deprecated.
      Sets the rounding mode for decimal divisions.
      Parameters:
      roundingMode - rounding mode for decimal divisions
      See Also:

    • getScale

      public int getScale()
      Deprecated.
      Sets the scale for division operations. The default is 64
      Returns:
      the scale
      See Also:

    • setScale

      public void setScale(int scale)
      Deprecated.
      Sets the scale for division operations.
      Parameters:
      scale - scale for division operations
      See Also:

    • getNorm

      public BigDecimal getNorm()
      Deprecated.
      Returns the maximum absolute row sum norm of the matrix.
      Specified by:
      getNorm in interface BigMatrix
      Returns:
      norm

    • getSubMatrix

      public BigMatrix getSubMatrix(int startRow, int endRow, int startColumn, int endColumn) throws MatrixIndexException
      Deprecated.
      Gets a submatrix. Rows and columns are indicated counting from 0 to n-1.
      Specified by:
      getSubMatrix in interface BigMatrix
      Parameters:
      startRow - Initial row index
      endRow - Final row index
      startColumn - Initial column index
      endColumn - Final column index
      Returns:
      The subMatrix containing the data of the specified rows and columns
      Throws:
      MatrixIndexException - if row or column selections are not valid

    • getSubMatrix

      public BigMatrix getSubMatrix(int[] selectedRows, int[] selectedColumns) throws MatrixIndexException
      Deprecated.
      Gets a submatrix. Rows and columns are indicated counting from 0 to n-1.
      Specified by:
      getSubMatrix in interface BigMatrix
      Parameters:
      selectedRows - Array of row indices must be non-empty
      selectedColumns - Array of column indices must be non-empty
      Returns:
      The subMatrix containing the data in the specified rows and columns
      Throws:
      MatrixIndexException - if supplied row or column index arrays are not valid

    • setSubMatrix

      public void setSubMatrix(BigDecimal[][] subMatrix, int row, int column) throws MatrixIndexException
      Deprecated.
      Replace the submatrix starting at row, column using data in the input subMatrix array. Indexes are 0-based.

      Example:
      Starting with 

       1  2  3  4
 5  6  7  8
 9  0  1  2
      and subMatrix = {{3, 4} {5,6}}, invoking setSubMatrix(subMatrix,1,1)) will result in 
       1  2  3  4
 5  3  4  8
 9  5  6  2

      Parameters:
      subMatrix - array containing the submatrix replacement data
      row - row coordinate of the top, left element to be replaced
      column - column coordinate of the top, left element to be replaced
      Throws:
      MatrixIndexException - if subMatrix does not fit into this matrix from element in (row, column)
      IllegalArgumentException - if subMatrix is not rectangular (not all rows have the same length) or empty
      NullPointerException - if subMatrix is null
      Since:
      1.1

    • getRowMatrix

      public BigMatrix getRowMatrix(int row) throws MatrixIndexException
      Deprecated.
      Returns the entries in row number row as a row matrix. Row indices start at 0.
      Specified by:
      getRowMatrix in interface BigMatrix
      Parameters:
      row - the row to be fetched
      Returns:
      row matrix
      Throws:
      MatrixIndexException - if the specified row index is invalid

    • getColumnMatrix

      public BigMatrix getColumnMatrix(int column) throws MatrixIndexException
      Deprecated.
      Returns the entries in column number column as a column matrix. Column indices start at 0.
      Specified by:
      getColumnMatrix in interface BigMatrix
      Parameters:
      column - the column to be fetched
      Returns:
      column matrix
      Throws:
      MatrixIndexException - if the specified column index is invalid

    • getRow

      public BigDecimal[] getRow(int row) throws MatrixIndexException
      Deprecated.
      Returns the entries in row number row as an array.

      Row indices start at 0. A MatrixIndexException is thrown unless 0 invalid input: '<'= row invalid input: '<' rowDimension.

      Specified by:
      getRow in interface BigMatrix
      Parameters:
      row - the row to be fetched
      Returns:
      array of entries in the row
      Throws:
      MatrixIndexException - if the specified row index is not valid

    • getRowAsDoubleArray

      public double[] getRowAsDoubleArray(int row) throws MatrixIndexException
      Deprecated.
      Returns the entries in row number row as an array of double values.

      Row indices start at 0. A MatrixIndexException is thrown unless 0 invalid input: '<'= row invalid input: '<' rowDimension.

      Specified by:
      getRowAsDoubleArray in interface BigMatrix
      Parameters:
      row - the row to be fetched
      Returns:
      array of entries in the row
      Throws:
      MatrixIndexException - if the specified row index is not valid

    • getColumn

      public BigDecimal[] getColumn(int col) throws MatrixIndexException
      Deprecated.
      Returns the entries in column number col as an array.

      Column indices start at 0. A MatrixIndexException is thrown unless 0 invalid input: '<'= column invalid input: '<' columnDimension.

      Specified by:
      getColumn in interface BigMatrix
      Parameters:
      col - the column to be fetched
      Returns:
      array of entries in the column
      Throws:
      MatrixIndexException - if the specified column index is not valid

    • getColumnAsDoubleArray

      public double[] getColumnAsDoubleArray(int col) throws MatrixIndexException
      Deprecated.
      Returns the entries in column number col as an array of double values.

      Column indices start at 0. A MatrixIndexException is thrown unless 0 invalid input: '<'= column invalid input: '<' columnDimension.

      Specified by:
      getColumnAsDoubleArray in interface BigMatrix
      Parameters:
      col - the column to be fetched
      Returns:
      array of entries in the column
      Throws:
      MatrixIndexException - if the specified column index is not valid

    • getEntry

      public BigDecimal getEntry(int row, int column) throws MatrixIndexException
      Deprecated.
      Returns the entry in the specified row and column.

      Row and column indices start at 0 and must satisfy

      • 0 invalid input: '<'= row invalid input: '<' rowDimension
      • 0 invalid input: '<'= column invalid input: '<' columnDimension
      otherwise a MatrixIndexException is thrown.

      Specified by:
      getEntry in interface BigMatrix
      Parameters:
      row - row location of entry to be fetched
      column - column location of entry to be fetched
      Returns:
      matrix entry in row,column
      Throws:
      MatrixIndexException - if the row or column index is not valid

    • getEntryAsDouble

      public double getEntryAsDouble(int row, int column) throws MatrixIndexException
      Deprecated.
      Returns the entry in the specified row and column as a double.

      Row and column indices start at 0 and must satisfy

      • 0 invalid input: '<'= row invalid input: '<' rowDimension
      • 0 invalid input: '<'= column invalid input: '<' columnDimension
      otherwise a MatrixIndexException is thrown.

      Specified by:
      getEntryAsDouble in interface BigMatrix
      Parameters:
      row - row location of entry to be fetched
      column - column location of entry to be fetched
      Returns:
      matrix entry in row,column
      Throws:
      MatrixIndexException - if the row or column index is not valid

    • transpose

      public BigMatrix transpose()
      Deprecated.
      Returns the transpose matrix.
      Specified by:
      transpose in interface BigMatrix
      Returns:
      transpose matrix

    • inverse

      public BigMatrix inverse() throws InvalidMatrixException
      Deprecated.
      Returns the inverse matrix if this matrix is invertible.
      Specified by:
      inverse in interface BigMatrix
      Returns:
      inverse matrix
      Throws:
      InvalidMatrixException - if this is not invertible

    • getDeterminant

      public BigDecimal getDeterminant() throws InvalidMatrixException
      Deprecated.
      Returns the determinant of this matrix.
      Specified by:
      getDeterminant in interface BigMatrix
      Returns:
      determinant
      Throws:
      InvalidMatrixException - if matrix is not square

    • isSquare

      public boolean isSquare()
      Deprecated.
      Is this a square matrix?
      Specified by:
      isSquare in interface AnyMatrix
      Returns:
      true if the matrix is square (rowDimension = columnDimension)

    • isSingular

      public boolean isSingular()
      Deprecated.
      Is this a singular matrix?
      Returns:
      true if the matrix is singular

    • getRowDimension

      public int getRowDimension()
      Deprecated.
      Returns the number of rows in the matrix.
      Specified by:
      getRowDimension in interface AnyMatrix
      Returns:
      rowDimension

    • getColumnDimension

      public int getColumnDimension()
      Deprecated.
      Returns the number of columns in the matrix.
      Specified by:
      getColumnDimension in interface AnyMatrix
      Returns:
      columnDimension

    • getTrace

      public BigDecimal getTrace() throws IllegalArgumentException
      Deprecated.
      Returns the trace of the matrix (the sum of the elements on the main diagonal).
      Specified by:
      getTrace in interface BigMatrix
      Returns:
      trace
      Throws:
      IllegalArgumentException - if this matrix is not square.

    • operate

      public BigDecimal[] operate(BigDecimal[] v) throws IllegalArgumentException
      Deprecated.
      Returns the result of multiplying this by the vector v.
      Specified by:
      operate in interface BigMatrix
      Parameters:
      v - the vector to operate on
      Returns:
      this*v
      Throws:
      IllegalArgumentException - if columnDimension != v.size()

    • operate

      public BigDecimal[] operate(double[] v) throws IllegalArgumentException
      Deprecated.
      Returns the result of multiplying this by the vector v.
      Parameters:
      v - the vector to operate on
      Returns:
      this*v
      Throws:
      IllegalArgumentException - if columnDimension != v.size()

    • preMultiply

      public BigDecimal[] preMultiply(BigDecimal[] v) throws IllegalArgumentException
      Deprecated.
      Returns the (row) vector result of premultiplying this by the vector v.
      Specified by:
      preMultiply in interface BigMatrix
      Parameters:
      v - the row vector to premultiply by
      Returns:
      v*this
      Throws:
      IllegalArgumentException - if rowDimension != v.size()

    • solve

      public BigDecimal[] solve(BigDecimal[] b) throws IllegalArgumentException, InvalidMatrixException
      Deprecated.
      Returns a matrix of (column) solution vectors for linear systems with coefficient matrix = this and constant vectors = columns of b.
      Specified by:
      solve in interface BigMatrix
      Parameters:
      b - array of constants forming RHS of linear systems to to solve
      Returns:
      solution array
      Throws:
      IllegalArgumentException - if this.rowDimension != row dimension
      InvalidMatrixException - if this matrix is not square or is singular

    • solve

      public BigDecimal[] solve(double[] b) throws IllegalArgumentException, InvalidMatrixException
      Deprecated.
      Returns a matrix of (column) solution vectors for linear systems with coefficient matrix = this and constant vectors = columns of b.
      Parameters:
      b - array of constants forming RHS of linear systems to to solve
      Returns:
      solution array
      Throws:
      IllegalArgumentException - if this.rowDimension != row dimension
      InvalidMatrixException - if this matrix is not square or is singular

    • solve

      public BigMatrix solve(BigMatrix b) throws IllegalArgumentException, InvalidMatrixException
      Deprecated.
      Returns a matrix of (column) solution vectors for linear systems with coefficient matrix = this and constant vectors = columns of b.
      Specified by:
      solve in interface BigMatrix
      Parameters:
      b - matrix of constant vectors forming RHS of linear systems to to solve
      Returns:
      matrix of solution vectors
      Throws:
      IllegalArgumentException - if this.rowDimension != row dimension
      InvalidMatrixException - if this matrix is not square or is singular

    • luDecompose

      public void luDecompose() throws InvalidMatrixException
      Deprecated.
      Computes a new LU decompostion for this matrix, storing the result for use by other methods.

      Implementation Note:
      Uses Crout's algortithm, with partial pivoting.

      Usage Note:
      This method should rarely be invoked directly. Its only use is to force recomputation of the LU decomposition when changes have been made to the underlying data using direct array references. Changes made using setXxx methods will trigger recomputation when needed automatically.

      Throws:
      InvalidMatrixException - if the matrix is non-square or singular.

    • toString

      public String toString()
      Deprecated.
      Get a string representation for this matrix.
      Overrides:
      toString in class Object
      Returns:
      a string representation for this matrix

    • equals

      public boolean equals(Object object)
      Deprecated.
      Returns true iff object is a BigMatrixImpl instance with the same dimensions as this and all corresponding matrix entries are equal. BigDecimal.equals is used to compare corresponding entries.
      Overrides:
      equals in class Object
      Parameters:
      object - the object to test equality against.
      Returns:
      true if object equals this

    • hashCode

      public int hashCode()
      Deprecated.
      Computes a hashcode for the matrix.
      Overrides:
      hashCode in class Object
      Returns:
      hashcode for matrix