scalation.linalgebra

Matrir

trait Matrir extends Error

The Matrir trait specifies the operations to be defined by three concrete implemeting classes: MatrixR, SparseMatrixR and SymTriMatrixR.

Linear Supertypes
Error, AnyRef, Any
Known Subclasses
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Matrir
  2. Error
  3. AnyRef
  4. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def *(x: Rational): Matrir

    Multiply this matrix by scalar x.

    Multiply this matrix by scalar x.

    x

    the scalar to multiply by

  2. abstract def *(u: VectorR): VectorR

    Multiply this matrix by vector u.

    Multiply this matrix by vector u.

    u

    the vector to multiply by

  3. abstract def **(u: VectorR): Matrir

    Multiply this matrix by vector u to produce another matrix (a_ij * b_j)

  4. abstract def **=(u: VectorR): Matrir

    Multiply in-place this matrix by vector u to produce another matrix (a_ij * b_j)

    Multiply in-place this matrix by vector u to produce another matrix (a_ij * b_j)

    u

    the vector to multiply by

  5. abstract def *=(x: Rational): Matrir

    Multiply in-place this matrix by scalar x.

    Multiply in-place this matrix by scalar x.

    x

    the scalar to multiply by

  6. abstract def +(x: Rational): Matrir

    Add this matrix and scalar x.

    Add this matrix and scalar x.

    x

    the scalar to add

  7. abstract def ++(u: VectorR): Matrir

    Concatenate this matrix and vector u.

    Concatenate this matrix and vector u.

    u

    the vector to be concatenated as the new last row in matrix

  8. abstract def +=(x: Rational): Matrir

    Add in-place this matrix and scalar x.

    Add in-place this matrix and scalar x.

    x

    the scalar to add

  9. abstract def -(x: Rational): Matrir

    From this matrix subtract scalar x.

    From this matrix subtract scalar x.

    x

    the scalar to subtract

  10. abstract def -=(x: Rational): Matrir

    From this matrix subtract in-place scalar x.

    From this matrix subtract in-place scalar x.

    x

    the scalar to subtract

  11. abstract def /(x: Rational): Matrir

    Divide this matrix by scalar x.

    Divide this matrix by scalar x.

    x

    the scalar to divide by

  12. abstract def /=(x: Rational): Matrir

    Divide in-place this matrix by scalar x.

    Divide in-place this matrix by scalar x.

    x

    the scalar to divide by

  13. abstract def apply(i: Int, jr: Range): VectorR

    Get a slice this matrix row-wise at index i and column-wise on range jr.

    Get a slice this matrix row-wise at index i and column-wise on range jr. Ex: u = a(2, 3..5)

    i

    the row index

    jr

    the column range

  14. abstract def apply(ir: Range, j: Int): VectorR

    Get a slice this matrix row-wise on range ir and column-wise at index j.

    Get a slice this matrix row-wise on range ir and column-wise at index j. Ex: u = a(2..4, 3)

    ir

    the row range

    j

    the column index

  15. abstract def apply(ir: Range, jr: Range): Matrir

    Get a slice this matrix row-wise on range ir and column-wise on range jr.

    Get a slice this matrix row-wise on range ir and column-wise on range jr. Ex: b = a(2..4, 3..5)

    ir

    the row range

    jr

    the column range

  16. abstract def apply(i: Int): VectorR

    Get this matrix's vector at the i-th index position (i-th row).

    Get this matrix's vector at the i-th index position (i-th row).

    i

    the row index

  17. abstract def apply(i: Int, j: Int): Rational

    Get this matrix's element at the i,j-th index position.

    Get this matrix's element at the i,j-th index position.

    i

    the row index

    j

    the column index

  18. abstract def clean(thres: Rational, relative: Boolean = true): Matrir

    Clean values in matrix at or below the threshold by setting them to zero.

    Clean values in matrix at or below the threshold by setting them to zero. Iterative algorithms give approximate values and if very close to zero, may throw off other calculations, e.g., in computing eigenvectors.

    thres

    the cutoff threshold (a small value)

    relative

    whether to use relative or absolute cutoff

  19. abstract def col(col: Int, from: Int = 0): VectorR

    Get column 'col' from the matrix, returning it as a vector.

    Get column 'col' from the matrix, returning it as a vector.

    col

    the column to extract from the matrix

    from

    the position to start extracting from

  20. abstract def det: Rational

    Compute the determinant of this matrix.

  21. abstract def diag(p: Int, q: Int): Matrir

    Form a matrix [Ip, this, Iq] where Ir is a r by r identity matrix, by positioning the three matrices Ip, this and Iq along the diagonal.

    Form a matrix [Ip, this, Iq] where Ir is a r by r identity matrix, by positioning the three matrices Ip, this and Iq along the diagonal.

    p

    the size of identity matrix Ip

    q

    the size of identity matrix Iq

  22. abstract val dim1: Int

    Matrix dimension 1 (# rows)

  23. abstract val dim2: Int

    Matrix dimension 2 (# columns)

  24. abstract def getDiag(k: Int = 0): VectorR

    Get the kth diagonal of this matrix.

    Get the kth diagonal of this matrix. Assumes dim2 >= dim1.

    k

    how far above the main diagonal, e.g., (-1, 0, 1) for (sub, main, super)

  25. abstract def inverse: Matrir

    Invert this matrix (requires a squareMatrix) and use partial pivoting.

  26. abstract def inverse_ip: Matrir

    Invert in-place this matrix (requires a squareMatrix) and use partial pivoting.

  27. abstract def isNonnegative: Boolean

    Check whether this matrix is nonnegative (has no negative elements).

  28. abstract def isRectangular: Boolean

    Check whether this matrix is rectangular (all rows have the same number of columns).

  29. abstract def lud: (Matrir, Matrir)

    Decompose this matrix into the product of lower and upper triangular matrices (l, u) using the LU Decomposition algorithm.

    Decompose this matrix into the product of lower and upper triangular matrices (l, u) using the LU Decomposition algorithm. This version uses partial pivoting.

  30. abstract def lud_ip: (Matrir, Matrir)

    Decompose in-place this matrix into the product of lower and upper triangular matrices (l, u) using the LU Decomposition algorithm.

    Decompose in-place this matrix into the product of lower and upper triangular matrices (l, u) using the LU Decomposition algorithm. This version uses partial pivoting.

  31. abstract def max(e: Int = dim1): Rational

    Find the maximum element in this matrix.

    Find the maximum element in this matrix.

    e

    the ending row index (exclusive) for the search

  32. abstract def min(e: Int = dim1): Rational

    Find the minimum element in this matrix.

    Find the minimum element in this matrix.

    e

    the ending row index (exclusive) for the search

  33. abstract def norm1: Rational

    Compute the 1-norm of this matrix, i.

    Compute the 1-norm of this matrix, i.e., the maximum 1-norm of the column vectors. This is useful for comparing matrices (a - b).norm1

  34. abstract def nullspace: VectorR

    Compute the (right) nullspace of this m by n matrix (requires n = m + 1) by performing Gauss-Jordan reduction and extracting the negation of the last column augmented by 1.

    Compute the (right) nullspace of this m by n matrix (requires n = m + 1) by performing Gauss-Jordan reduction and extracting the negation of the last column augmented by 1. The nullspace of matrix a is "this vector v times any scalar s", i.e., a*(v*s) = 0. The left nullspace of matrix a is the same as the right nullspace of a.t (a transpose).

  35. abstract def nullspace_ip: VectorR

    Compute the (right) nullspace in-place of this m by n matrix (requires n = m + 1) by performing Gauss-Jordan reduction and extracting the negation of the last column augmented by 1.

    Compute the (right) nullspace in-place of this m by n matrix (requires n = m + 1) by performing Gauss-Jordan reduction and extracting the negation of the last column augmented by 1. The nullspace of matrix a is "this vector v times any scalar s", i.e., a*(v*s) = 0. The left nullspace of matrix a is the same as the right nullspace of a.t (a transpose).

  36. abstract def reduce: Matrir

    Use Gauss-Jordan reduction on this matrix to make the left part embed an identity matrix.

    Use Gauss-Jordan reduction on this matrix to make the left part embed an identity matrix. A constraint on this m by n matrix is that n >= m.

  37. abstract def reduce_ip: Unit

    Use Gauss-Jordan reduction in-place on this matrix to make the left part embed an identity matrix.

    Use Gauss-Jordan reduction in-place on this matrix to make the left part embed an identity matrix. A constraint on this m by n matrix is that n >= m.

  38. abstract def selectCols(colIndex: Array[Int]): Matrir

    Select columns from this matrix according to the given index/basis.

    Select columns from this matrix according to the given index/basis. Ex: Can be used to divide a matrix into a basis and a non-basis.

    colIndex

    the column index positions (e.g., (0, 2, 5))

  39. abstract def selectRows(rowIndex: Array[Int]): Matrir

    Select rows from this matrix according to the given index/basis.

    Select rows from this matrix according to the given index/basis.

    rowIndex

    the row index positions (e.g., (0, 2, 5))

  40. abstract def set(i: Int, u: VectorR, j: Int = 0): Unit

    Set this matrix's ith row starting a column j to the vector u.

    Set this matrix's ith row starting a column j to the vector u.

    i

    the row index

    u

    the vector value to assign

    j

    the starting column index

  41. abstract def set(u: Array[Array[Rational]]): Unit

    Set the values in this matrix as copies of the values in 2D array u.

    Set the values in this matrix as copies of the values in 2D array u.

    u

    the 2D array of values to assign

  42. abstract def set(x: Rational): Unit

    Set all the elements in this matrix to the scalar x.

    Set all the elements in this matrix to the scalar x.

    x

    the scalar value to assign

  43. abstract def setCol(col: Int, u: VectorR): Unit

    Set column 'col' of the matrix to a vector.

    Set column 'col' of the matrix to a vector.

    col

    the column to set

    u

    the vector to assign to the column

  44. abstract def setDiag(x: Rational): Unit

    Set the main diagonal of this matrix to the scalar x.

    Set the main diagonal of this matrix to the scalar x. Assumes dim2 >= dim1.

    x

    the scalar to set the diagonal to

  45. abstract def setDiag(u: VectorR, k: Int = 0): Unit

    Set the kth diagonal of this matrix to the vector u.

    Set the kth diagonal of this matrix to the vector u. Assumes dim2 >= dim1.

    u

    the vector to set the diagonal to

    k

    how far above the main diagonal, e.g., (-1, 0, 1) for (sub, main, super)

  46. abstract def slice(r_from: Int, r_end: Int, c_from: Int, c_end: Int): Matrir

    Slice this matrix row-wise r_from to r_end and column-wise c_from to c_end.

    Slice this matrix row-wise r_from to r_end and column-wise c_from to c_end.

    r_from

    the start of the row slice

    r_end

    the end of the row slice

    c_from

    the start of the column slice

    c_end

    the end of the column slice

  47. abstract def slice(from: Int, end: Int): Matrir

    Slice this matrix row-wise from to end.

    Slice this matrix row-wise from to end.

    from

    the start of the slice

    end

    the end of the slice

  48. abstract def sliceExclude(row: Int, col: Int): Matrir

    Slice this matrix excluding the given row and column.

    Slice this matrix excluding the given row and column.

    row

    the row to exclude

    col

    the column to exclude

  49. abstract def solve(b: VectorR): VectorR

    Solve for x in the equation a*x = b where a is this matrix (see lud above).

    Solve for x in the equation a*x = b where a is this matrix (see lud above).

    b

    the constant vector.

  50. abstract def solve(lu: (Matrir, Matrir), b: VectorR): VectorR

    Solve for x in the equation l*u*x = b (see lud above).

    Solve for x in the equation l*u*x = b (see lud above).

    lu

    the lower and upper triangular matrices

    b

    the constant vector

  51. abstract def solve(l: Matrir, u: Matrir, b: VectorR): VectorR

    Solve for x in the equation l*u*x = b (see lud above).

    Solve for x in the equation l*u*x = b (see lud above).

    l

    the lower triangular matrix

    u

    the upper triangular matrix

    b

    the constant vector

  52. abstract def sum: Rational

    Compute the sum of this matrix, i.

    Compute the sum of this matrix, i.e., the sum of its elements.

  53. abstract def sumAbs: Rational

    Compute the abs sum of this matrix, i.

    Compute the abs sum of this matrix, i.e., the sum of the absolute value of its elements. This is useful for comparing matrices (a - b).sumAbs

  54. abstract def sumLower: Rational

    Compute the sum of the lower triangular region of this matrix.

  55. abstract def t: Matrir

    Transpose this matrix (rows => columns).

  56. abstract def trace: Rational

    Compute the trace of this matrix, i.

    Compute the trace of this matrix, i.e., the sum of the elements on the main diagonal. Should also equal the sum of the eigenvalues.

    See also

    Eigen.scala

  57. abstract def update(i: Int, jr: Range, u: VectorR): Unit

    Set a slice this matrix row-wise at index i and column-wise on range jr.

    Set a slice this matrix row-wise at index i and column-wise on range jr. Ex: a(2, 3..5) = u

    i

    the row index

    jr

    the column range

    u

    the vector to assign

  58. abstract def update(ir: Range, j: Int, u: VectorR): Unit

    Set a slice this matrix row-wise on range ir and column-wise at index j.

    Set a slice this matrix row-wise on range ir and column-wise at index j. Ex: a(2..4, 3) = u

    ir

    the row range

    j

    the column index

    u

    the vector to assign

  59. abstract def update(i: Int, u: VectorR): Unit

    Set this matrix's row at the i-th index position to the vector u.

    Set this matrix's row at the i-th index position to the vector u.

    i

    the row index

    u

    the vector value to assign

  60. abstract def update(i: Int, j: Int, x: Rational): Unit

    Set this matrix's element at the i,j-th index position to the scalar x.

    Set this matrix's element at the i,j-th index position to the scalar x.

    i

    the row index

    j

    the column index

    x

    the scalar value to assign

  61. abstract def ~^(p: Int): Matrir

    Raise this matrix to the pth power (for some integer p >= 2).

    Raise this matrix to the pth power (for some integer p >= 2).

    p

    the power to raise this matrix to

Concrete Value Members

  1. final def !=(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  5. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  6. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  7. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  8. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  9. def flaw(method: String, message: String): Unit

    Show the flaw by printing the error message.

    Show the flaw by printing the error message.

    method

    the method where the error occurred

    message

    the error message

    Definition Classes
    Error
  10. def foreach[U](f: (Array[Rational]) ⇒ U): Unit

    Iterate over the matrix row by row.

    Iterate over the matrix row by row.

    f

    the function to apply

  11. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  12. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  13. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  14. def isSquare: Boolean

    Check whether this matrix is square (same row and column dimensions).

  15. def isSymmetric: Boolean

    Check whether this matrix is symmetric.

  16. def leDimensions(b: Matrir): Boolean

    Check whether this matrix dimensions are less than or equal to (le) those of the other Matrix.

    Check whether this matrix dimensions are less than or equal to (le) those of the other Matrix.

    b

    the other matrix

  17. def mag: Rational

    Find the magnitude of this matrix, the element value farthest from zero.

  18. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  19. final def notify(): Unit

    Definition Classes
    AnyRef
  20. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  21. def oneIf(cond: Boolean): Int

    Return 1 if the condition is true else 0

    Return 1 if the condition is true else 0

    cond

    the condition to evaluate

  22. val range1: Range

    Range for the storage array on dimension 1 (rows)

    Range for the storage array on dimension 1 (rows)

    Attributes
    protected
  23. val range2: Range

    Range for the storage array on dimension 2 (columns)

    Range for the storage array on dimension 2 (columns)

    Attributes
    protected
  24. def rank: Int

    Determine the rank of this m by n matrix by taking the upper triangular matrix from the LU Decomposition and counting the number of non-zero diagonal elements.

  25. def sameCrossDimensions(b: Matrir): Boolean

    Check whether this matrix and the other matrix have the same cross dimensions.

    Check whether this matrix and the other matrix have the same cross dimensions.

    b

    the other matrix

  26. def sameDimensions(b: Matrir): Boolean

    Check whether this matrix and the other Matrix have the same dimensions.

    Check whether this matrix and the other Matrix have the same dimensions.

    b

    the other matrix

  27. def set(x: Double): Unit

    Set all the elements in this matrix to the scalar x.

    Set all the elements in this matrix to the scalar x.

    x

    the scalar value to assign

  28. def setLower(x: Rational): Unit

    Set all the lower triangular elements in this matrix to the scalar x.

    Set all the lower triangular elements in this matrix to the scalar x.

    x

    the scalar value to assign

  29. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  30. def toString(): String

    Definition Classes
    AnyRef → Any
  31. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  32. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  33. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from Error

Inherited from AnyRef

Inherited from Any

Ungrouped