Packages

class SparseMatrixR extends MatriR with Error with Serializable

The SparseMatrixR class stores and operates on Matrices of Reals. Rather than storing the matrix as a 2 dimensional array, it is stored as an array of sorted-linked-maps, which record all the non-zero values for each particular row, along with their j-index as (j, v) pairs.

Linear Supertypes
Serializable, Serializable, MatriR, Error, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. SparseMatrixR
  2. Serializable
  3. Serializable
  4. MatriR
  5. Error
  6. AnyRef
  7. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new SparseMatrixR(b: MatrixR)

    Construct a sparse matrix and assign values from dense matrix MatrixR 'b'.

    Construct a sparse matrix and assign values from dense matrix MatrixR 'b'.

    b

    the matrix of values to assign

  2. new SparseMatrixR(b: SparseMatrixR)

    Construct a sparse matrix and assign values from matrix 'b'.

    Construct a sparse matrix and assign values from matrix 'b'.

    b

    the matrix of values to assign

  3. new SparseMatrixR(dim: (Int, Int), u: Real*)

    Construct a matrix from repeated values.

    Construct a matrix from repeated values.

    dim

    the (row, column) dimensions

    u

    the repeated values

  4. new SparseMatrixR(dim1: Int, dim2: Int, x: Real)

    Construct a 'dim1' by 'dim2' sparse matrix and assign each element the value 'x'.

    Construct a 'dim1' by 'dim2' sparse matrix and assign each element the value 'x'.

    dim1

    the row dimension

    dim2

    the column dimension

    x

    the scalar value to assign

  5. new SparseMatrixR(dim1: Int)

    Construct a 'dim1' by 'dim1' square sparse matrix.

    Construct a 'dim1' by 'dim1' square sparse matrix.

    dim1

    the row and column dimension

  6. new SparseMatrixR(dim1: Int, dim2: Int, u: Array[RowMap])

    Construct a 'dim1' by 'dim2' sparse matrix from an array of sorted-linked-maps.

    Construct a 'dim1' by 'dim2' sparse matrix from an array of sorted-linked-maps.

    dim1

    the row dimension

    dim2

    the column dimension

    u

    the array of sorted-linked-maps

  7. new SparseMatrixR(d1: Int, d2: Int)

    d1

    the first/row dimension

    d2

    the second/column dimension

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. def *(x: Real): SparseMatrixR

    Multiply 'this' sparse matrix by scalar 'x'.

    Multiply 'this' sparse matrix by scalar 'x'.

    x

    the scalar to multiply by

    Definition Classes
    SparseMatrixRMatriR
  4. def *(u: VectoR): VectorR

    Multiply 'this' sparse matrix by vector 'u' (vector elements beyond 'dim2' ignored).

    Multiply 'this' sparse matrix by vector 'u' (vector elements beyond 'dim2' ignored).

    u

    the vector to multiply by

    Definition Classes
    SparseMatrixRMatriR
  5. def *(b: MatriR): SparseMatrixR

    Multiply 'this' sparse matrix by dense matrix 'b'.

    Multiply 'this' sparse matrix by dense matrix 'b'.

    b

    the matrix to multiply by (requires 'sameCrossDimensions')

    Definition Classes
    SparseMatrixRMatriR
  6. def *(b: SparseMatrixR): SparseMatrixR

    Multiply 'this' sparse matrix by sparse matrix 'b', by performing a merge operation on the rows on 'this' sparse matrix and the transpose of the 'b' matrix.

    Multiply 'this' sparse matrix by sparse matrix 'b', by performing a merge operation on the rows on 'this' sparse matrix and the transpose of the 'b' matrix.

    b

    the matrix to multiply by (requires 'sameCrossDimensions')

  7. def **(u: VectoR): SparseMatrixR

    Multiply 'this' sparse matrix by vector 'u' to produce another matrix 'a_ij * u_j'.

    Multiply 'this' sparse matrix by vector 'u' to produce another matrix 'a_ij * u_j'.

    u

    the vector to multiply by

    Definition Classes
    SparseMatrixRMatriR
  8. def **:(u: VectoR): SparseMatrixR

    Multiply vector 'u' by 'this' matrix to produce another matrix 'u_i * a_ij'.

    Multiply vector 'u' by 'this' matrix to produce another matrix 'u_i * a_ij'. E.g., multiply a diagonal matrix represented as a vector by a matrix. This operator is right associative.

    u

    the vector to multiply by

    Definition Classes
    SparseMatrixRMatriR
  9. def **=(u: VectoR): SparseMatrixR

    Multiply in-place 'this' sparse matrix by vector 'u' to produce another matrix 'a_ij * u_j'.

    Multiply in-place 'this' sparse matrix by vector 'u' to produce another matrix 'a_ij * u_j'.

    u

    the vector to multiply by

    Definition Classes
    SparseMatrixRMatriR
  10. def *:(u: VectoR): VectoR

    Multiply (row) vector 'u' by 'this' matrix.

    Multiply (row) vector 'u' by 'this' matrix. Note '*:' is right associative. vector = vector *: matrix

    u

    the vector to multiply by

    Definition Classes
    MatriR
  11. def *=(x: Real): SparseMatrixR

    Multiply in-place 'this' sparse matrix by scalar 'x'.

    Multiply in-place 'this' sparse matrix by scalar 'x'.

    x

    the scalar to multiply by

    Definition Classes
    SparseMatrixRMatriR
  12. def *=(b: MatriR): SparseMatrixR

    Multiply in-place 'this' sparse matrix by dense matrix 'b'.

    Multiply in-place 'this' sparse matrix by dense matrix 'b'.

    b

    the matrix to multiply by (requires square and 'sameCrossDimensions')

    Definition Classes
    SparseMatrixRMatriR
  13. def *=(b: SparseMatrixR): SparseMatrixR

    Multiply in-place 'this' sparse matrix by sparse matrix 'b', by performing a merge operation on the rows on 'this' sparse matrix and the transpose of the 'b' matrix.

    Multiply in-place 'this' sparse matrix by sparse matrix 'b', by performing a merge operation on the rows on 'this' sparse matrix and the transpose of the 'b' matrix.

    b

    the matrix to multiply by (requires square and 'sameCrossDimensions')

  14. def +(x: Real): MatrixR

    Add 'this' sparse matrix and scalar 'x'.

    Add 'this' sparse matrix and scalar 'x'. Note: every element will be likely filled, hence the return type is a dense matrix.

    x

    the scalar to add

    Definition Classes
    SparseMatrixRMatriR
  15. def +(u: VectoR): SparseMatrixR

    Add 'this' sparse matrix and (row) vector 'u'.

    Add 'this' sparse matrix and (row) vector 'u'.

    u

    the vector to add

    Definition Classes
    SparseMatrixRMatriR
  16. def +(b: MatriR): SparseMatrixR

    Add 'this' sparse matrix and matrix 'b'.

    Add 'this' sparse matrix and matrix 'b'. 'b' may be any subtype of MatriR. Note, subtypes of MatriR should also implement a more efficient version, e.g., def + (b: SparseMatrixR): SparseMatrixR.

    b

    the matrix to add (requires 'sameCrossDimensions')

    Definition Classes
    SparseMatrixRMatriR
  17. def +(b: SparseMatrixR): SparseMatrixR

    Add 'this' sparse matrix and sparse matrix 'b'.

    Add 'this' sparse matrix and sparse matrix 'b'.

    b

    the matrix to add (requires 'sameCrossDimensions')

  18. def ++(b: MatriR): SparseMatrixR

    Concatenate (row-wise) 'this' matrix and matrix 'b'.

    Concatenate (row-wise) 'this' matrix and matrix 'b'.

    b

    the matrix to be concatenated as the new last rows in new matrix

    Definition Classes
    SparseMatrixRMatriR
  19. def ++^(b: MatriR): SparseMatrixR

    Concatenate (column-wise) 'this' matrix and matrix 'b'.

    Concatenate (column-wise) 'this' matrix and matrix 'b'.

    b

    the matrix to be concatenated as the new last columns in new matrix

    Definition Classes
    SparseMatrixRMatriR
  20. def +:(u: VectoR): SparseMatrixR

    Concatenate (row) vector 'u' and 'this' matrix, i.e., prepend 'u' to 'this'.

    Concatenate (row) vector 'u' and 'this' matrix, i.e., prepend 'u' to 'this'.

    u

    the vector to be prepended as the new first row in new matrix

    Definition Classes
    SparseMatrixRMatriR
  21. def +=(x: Real): SparseMatrixR

    Add in-place 'this' sparse matrix and scalar 'x'.

    Add in-place 'this' sparse matrix and scalar 'x'.

    x

    the scalar to add

    Definition Classes
    SparseMatrixRMatriR
  22. def +=(u: VectoR): SparseMatrixR

    Add in-place this matrix and (row) vector 'u'.

    Add in-place this matrix and (row) vector 'u'.

    u

    the vector to add

    Definition Classes
    SparseMatrixRMatriR
  23. def +=(b: MatriR): SparseMatrixR

    Add in-place 'this' sparse matrix and matrix 'b'.

    Add in-place 'this' sparse matrix and matrix 'b'.

    b

    the matrix to add (requires 'sameCrossDimensions')

    Definition Classes
    SparseMatrixRMatriR
  24. def +=(b: SparseMatrixR): SparseMatrixR

    Add in-place 'this' sparse matrix and sparse matrix 'b'.

    Add in-place 'this' sparse matrix and sparse matrix 'b'.

    b

    the matrix to add (requires 'sameCrossDimensions')

  25. def +^:(u: VectoR): SparseMatrixR

    Concatenate (column) vector 'u' and 'this' matrix, i.e., prepend 'u' to 'this'.

    Concatenate (column) vector 'u' and 'this' matrix, i.e., prepend 'u' to 'this'.

    u

    the vector to be prepended as the new first column in new matrix

    Definition Classes
    SparseMatrixRMatriR
  26. def -(x: Real): MatrixR

    From 'this' sparse matrix subtract scalar 'x'.

    From 'this' sparse matrix subtract scalar 'x'. Note: every element will be likely filled, hence the return type is a dense matrix.

    x

    the scalar to subtract

    Definition Classes
    SparseMatrixRMatriR
  27. def -(u: VectoR): SparseMatrixR

    From this sparse matrix subtract (row) vector 'u'.

    From this sparse matrix subtract (row) vector 'u'.

    u

    the vector to subtract

    Definition Classes
    SparseMatrixRMatriR
  28. def -(b: MatriR): SparseMatrixR

    From 'this' sparse matrix subtract matrix 'b'.

    From 'this' sparse matrix subtract matrix 'b'.

    b

    the matrix to subtract (requires 'sameCrossDimensions')

    Definition Classes
    SparseMatrixRMatriR
  29. def -(b: SparseMatrixR): SparseMatrixR

    From 'this' sparse matrix subtract matrix 'b'.

    From 'this' sparse matrix subtract matrix 'b'.

    b

    the sparse matrix to subtract (requires 'sameCrossDimensions')

  30. def -=(x: Real): SparseMatrixR

    From 'this' sparse matrix subtract in-place scalar 'x'.

    From 'this' sparse matrix subtract in-place scalar 'x'.

    x

    the scalar to subtract

    Definition Classes
    SparseMatrixRMatriR
  31. def -=(u: VectoR): SparseMatrixR

    From this sparse matrix subtract in-place (row) vector 'u'.

    From this sparse matrix subtract in-place (row) vector 'u'.

    u

    the vector to subtract

    Definition Classes
    SparseMatrixRMatriR
  32. def -=(b: MatriR): SparseMatrixR

    From 'this' sparse matrix subtract in-place matrix 'b'.

    From 'this' sparse matrix subtract in-place matrix 'b'.

    b

    the matrix to subtract (requires 'sameCrossDimensions')

    Definition Classes
    SparseMatrixRMatriR
  33. def -=(b: SparseMatrixR): SparseMatrixR

    From 'this' sparse matrix subtract in-place sparse matrix 'b'.

    From 'this' sparse matrix subtract in-place sparse matrix 'b'.

    b

    the sparse matrix to subtract (requires 'sameCrossDimensions')

  34. def /(x: Real): SparseMatrixR

    Divide 'this' sparse matrix by scalar 'x'.

    Divide 'this' sparse matrix by scalar 'x'.

    x

    the scalar to divide by

    Definition Classes
    SparseMatrixRMatriR
  35. def /=(x: Real): SparseMatrixR

    Divide in-place 'this' sparse matrix by scalar 'x'.

    Divide in-place 'this' sparse matrix by scalar 'x'.

    x

    the scalar to divide by

    Definition Classes
    SparseMatrixRMatriR
  36. def :+(u: VectoR): SparseMatrixR

    Concatenate 'this' matrix and (row) vector 'u', i.e., append 'u' to 'this'.

    Concatenate 'this' matrix and (row) vector 'u', i.e., append 'u' to 'this'.

    u

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

    Definition Classes
    SparseMatrixRMatriR
  37. def :^+(u: VectoR): SparseMatrixR

    Concatenate 'this' matrix and (column) vector 'u', i.e., append 'u' to 'this'.

    Concatenate 'this' matrix and (column) vector 'u', i.e., append 'u' to 'this'.

    u

    the vector to be appended as the new last column in new matrix

    Definition Classes
    SparseMatrixRMatriR
  38. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  39. def apply(ir: Range, jr: Range): SparseMatrixR

    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

    Definition Classes
    SparseMatrixRMatriR
  40. def apply(i: Int): VectorR

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

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

    i

    the row index

    Definition Classes
    SparseMatrixRMatriR
  41. def apply(i: Int, j: Int): Real

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

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

    i

    the row index

    j

    the column index

    Definition Classes
    SparseMatrixRMatriR
  42. def apply(i: Int, jr: Range): VectoR

    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

    Definition Classes
    MatriR
  43. def apply(ir: Range, j: Int): VectoR

    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

    Definition Classes
    MatriR
  44. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  45. def bsolve(y: VectoR): VectorR

    Solve for 'x' using back substitution in the equation 'u*x = y' where 'this' matrix ('u') is upper triangular (see 'lud_npp' above).

    Solve for 'x' using back substitution in the equation 'u*x = y' where 'this' matrix ('u') is upper triangular (see 'lud_npp' above).

    y

    the constant vector

    Definition Classes
    SparseMatrixRMatriR
  46. def clean(thres: Double, relative: Boolean = true): SparseMatrixR

    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

    Definition Classes
    SparseMatrixRMatriR
  47. def clone(): AnyRef
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  48. 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

    Definition Classes
    SparseMatrixRMatriR
  49. def copy(): SparseMatrixR

    Create a clone of 'this' 'm-by-n' sparse matrix.

    Create a clone of 'this' 'm-by-n' sparse matrix.

    Definition Classes
    SparseMatrixRMatriR
  50. val d1: Int
  51. val d2: Int
  52. def det: Real

    Compute the determinant of 'this' sparse matrix.

    Compute the determinant of 'this' sparse matrix.

    Definition Classes
    SparseMatrixRMatriR
  53. def diag(p: Int, q: Int): SparseMatrixR

    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

    Definition Classes
    SparseMatrixRMatriR
  54. def diag(b: MatriR): SparseMatrixR

    Combine 'this' sparse matrix with matrix 'b', placing them along the diagonal and filling in the bottom left and top right regions with zeros: '[this, b]'.

    Combine 'this' sparse matrix with matrix 'b', placing them along the diagonal and filling in the bottom left and top right regions with zeros: '[this, b]'.

    b

    the matrix to combine with this matrix

    Definition Classes
    SparseMatrixRMatriR
  55. lazy val dim1: Int

    Dimension 1

    Dimension 1

    Definition Classes
    SparseMatrixRMatriR
  56. lazy val dim2: Int

    Dimension 2

    Dimension 2

    Definition Classes
    SparseMatrixRMatriR
  57. def dot(b: MatriR): VectorR

    Compute the dot product of 'this' matrix with matrix 'b' to produce a vector.

    Compute the dot product of 'this' matrix with matrix 'b' to produce a vector.

    b

    the second matrix of the dot product

    Definition Classes
    SparseMatrixRMatriR
  58. def dot(u: VectoR): VectorR

    Compute the dot product of 'this' matrix and vector 'u', by first transposing 'this' matrix and then multiplying by 'u' (i.e., 'a dot u = a.t * u').

    Compute the dot product of 'this' matrix and vector 'u', by first transposing 'this' matrix and then multiplying by 'u' (i.e., 'a dot u = a.t * u').

    u

    the vector to multiply by (requires same first dimensions)

    Definition Classes
    SparseMatrixRMatriR
  59. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  60. def equals(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  61. val fString: String

    Format string used for printing vector values (change using 'setFormat')

    Format string used for printing vector values (change using 'setFormat')

    Attributes
    protected
    Definition Classes
    MatriR
  62. def finalize(): Unit
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  63. final 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
  64. def foreach[U](f: (Array[Real]) ⇒ U): Unit

    Iterate over 'this' matrix row by row applying method 'f'.

    Iterate over 'this' matrix row by row applying method 'f'.

    f

    the function to apply

    Definition Classes
    MatriR
  65. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
  66. def getDiag(k: Int = 0): VectorR

    Get the 'k'th diagonal of this matrix.

    Get the 'k'th diagonal of this matrix. Assumes 'dim2 >= dim1'.

    k

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

    Definition Classes
    SparseMatrixRMatriR
  67. def hashCode(): Int
    Definition Classes
    AnyRef → Any
  68. def inverse: SparseMatrixR

    Invert 'this' sparse matrix (requires a 'squareMatrix') using partial pivoting.

    Invert 'this' sparse matrix (requires a 'squareMatrix') using partial pivoting.

    Definition Classes
    SparseMatrixRMatriR
  69. def inverse_ip(): SparseMatrixR

    Invert in-place 'this' sparse matrix (requires a 'squareMatrix').

    Invert in-place 'this' sparse matrix (requires a 'squareMatrix'). This version uses partial pivoting.

    Definition Classes
    SparseMatrixRMatriR
  70. def inverse_npp: SparseMatrixR

    Invert 'this' sparse matrix (requires a 'squareMatrix') not using partial pivoting.

  71. def isBidiagonal: Boolean

    Check whether 'this' matrix is bidiagonal (has non-zero elements only in main diagonal and super-diagonal).

    Check whether 'this' matrix is bidiagonal (has non-zero elements only in main diagonal and super-diagonal). The method may be overriding for efficiency.

    Definition Classes
    MatriR
  72. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  73. def isNonnegative: Boolean

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

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

    Definition Classes
    SparseMatrixRMatriR
  74. def isRectangular: Boolean

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

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

    Definition Classes
    SparseMatrixRMatriR
  75. def isSquare: Boolean

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

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

    Definition Classes
    MatriR
  76. def isSymmetric: Boolean

    Check whether 'this' matrix is symmetric.

    Check whether 'this' matrix is symmetric.

    Definition Classes
    MatriR
  77. def isTridiagonal: Boolean

    Check whether 'this' matrix is bidiagonal (has non-zero elements only in main diagonal and super-diagonal).

    Check whether 'this' matrix is bidiagonal (has non-zero elements only in main diagonal and super-diagonal). The method may be overriding for efficiency.

    Definition Classes
    MatriR
  78. def leDimensions(b: MatriR): Boolean

    Check whether 'this' matrix dimensions are less than or equal to 'le' those of the other matrix 'b'.

    Check whether 'this' matrix dimensions are less than or equal to 'le' those of the other matrix 'b'.

    b

    the other matrix

    Definition Classes
    MatriR
  79. def lowerT: SparseMatrixR

    Return the lower triangular of 'this' matrix (rest are zero).

    Return the lower triangular of 'this' matrix (rest are zero).

    Definition Classes
    SparseMatrixRMatriR
  80. def lud_ip(): (SparseMatrixR, SparseMatrixR)

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

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

    Definition Classes
    SparseMatrixRMatriR
  81. def lud_npp: (SparseMatrixR, SparseMatrixR)

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

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

    Definition Classes
    SparseMatrixRMatriR
  82. def mag: Real

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

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

    Definition Classes
    MatriR
  83. def max(e: Int = dim1): Real

    Find the maximum element in 'this' sparse matrix.

    Find the maximum element in 'this' sparse matrix.

    e

    the ending row index (exclusive) for the search

    Definition Classes
    SparseMatrixRMatriR
  84. def mdot(b: MatriR): SparseMatrixR

    Compute the matrix dot product of 'this' matrix and matrix 'b', by first transposing 'this' matrix and then multiplying by 'b' (i.e., 'a dot b = a.t * b').

    Compute the matrix dot product of 'this' matrix and matrix 'b', by first transposing 'this' matrix and then multiplying by 'b' (i.e., 'a dot b = a.t * b').

    b

    the matrix to multiply by (requires same first dimensions)

    Definition Classes
    SparseMatrixRMatriR
  85. def mean: VectoR

    Compute the column means of this matrix.

    Compute the column means of this matrix.

    Definition Classes
    MatriR
  86. def min(e: Int = dim1): Real

    Find the minimum element in 'this' sparse matrix.

    Find the minimum element in 'this' sparse matrix.

    e

    the ending row index (exclusive) for the search

    Definition Classes
    SparseMatrixRMatriR
  87. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  88. def norm1: Real

    Compute the 1-norm of 'this' matrix, i.e., the maximum 1-norm of the column vectors.

    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'.

    Definition Classes
    MatriR
  89. final def notify(): Unit
    Definition Classes
    AnyRef
  90. final def notifyAll(): Unit
    Definition Classes
    AnyRef
  91. 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.

    nullspace (a) = set of orthogonal vectors v s.t. a * v = 0

    The left nullspace of matrix 'a' is the same as the right nullspace of 'a.t'. FIX: need a more robust algorithm for computing nullspace (@see Fac_QR.scala). FIX: remove the 'n = m+1' restriction.

    Definition Classes
    SparseMatrixRMatriR
    See also

    /solving-ax-0-pivot-variables-special-solutions/MIT18_06SCF11_Ses1.7sum.pdf

    http://ocw.mit.edu/courses/mathematics/18-06sc-linear-algebra-fall-2011/ax-b-and-the-four-subspaces

  92. def nullspace_ip(): VectorR

    Compute in-place 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 in-place 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.

    nullspace (a) = set of orthogonal vectors v s.t. a * v = 0

    The left nullspace of matrix 'a' is the same as the right nullspace of 'a.t'. FIX: need a more robust algorithm for computing nullspace (@see Fac_QR.scala). FIX: remove the 'n = m+1' restriction.

    Definition Classes
    SparseMatrixRMatriR
    See also

    /solving-ax-0-pivot-variables-special-solutions/MIT18_06SCF11_Ses1.7sum.pdf

    http://ocw.mit.edu/courses/mathematics/18-06sc-linear-algebra-fall-2011/ax-b-and-the-four-subspaces

  93. val range1: Range

    Range for the storage array on dimension 1 (rows)

    Range for the storage array on dimension 1 (rows)

    Definition Classes
    MatriR
  94. val range2: Range

    Range for the storage array on dimension 2 (columns)

    Range for the storage array on dimension 2 (columns)

    Definition Classes
    MatriR
  95. def reduce: SparseMatrixR

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

    Use Gauss-Jordan reduction on 'this' sparse matrix to make the left part embed an identity matrix. A constraint on this m by n matrix is that n >= m. It can be used to solve 'a * x = b': augment 'a' with 'b' and call reduce. Takes '[a | b]' to '[I | x]'.

    Definition Classes
    SparseMatrixRMatriR
  96. def reduce_ip(): Unit

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

    Use Gauss-Jordan reduction in-place on 'this' sparse matrix to make the left part embed an identity matrix. A constraint on this m by n matrix is that n >= m. It can be used to solve 'a * x = b': augment 'a' with 'b' and call reduce. Takes '[a | b]' to '[I | x]'.

    Definition Classes
    SparseMatrixRMatriR
  97. def sameCrossDimensions(b: MatriR): Boolean

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

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

    b

    the other matrix

    Definition Classes
    MatriR
  98. def sameDimensions(b: MatriR): Boolean

    Check whether 'this' matrix and the other matrix 'b' have the same dimensions.

    Check whether 'this' matrix and the other matrix 'b' have the same dimensions.

    b

    the other matrix

    Definition Classes
    MatriR
  99. def selectCols(colIndex: Array[Int]): SparseMatrixR

    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))

    Definition Classes
    SparseMatrixRMatriR
  100. def selectRows(rowIndex: Array[Int]): SparseMatrixR

    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))

    Definition Classes
    SparseMatrixRMatriR
  101. def set(i: Int, u: VectoR, j: Int = 0): Unit

    Set this matrix's 'i'th row starting at column 'j' to the vector 'u'.

    Set this matrix's 'i'th row starting at column 'j' to the vector 'u'.

    i

    the row index

    u

    the vector value to assign

    j

    the starting column index

    Definition Classes
    SparseMatrixRMatriR
  102. def set(u: Array[Array[Real]]): Unit

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

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

    u

    the 2D array of values to assign

    Definition Classes
    SparseMatrixRMatriR
  103. def set(x: Real): 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

    Definition Classes
    SparseMatrixRMatriR
  104. def setCol(col: Int, u: VectoR): 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

    Definition Classes
    SparseMatrixRMatriR
  105. def setDiag(x: Real): 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

    Definition Classes
    SparseMatrixRMatriR
  106. def setDiag(u: VectoR, k: Int = 0): Unit

    Set the 'k'th diagonal of this matrix to the vector 'u'.

    Set the 'k'th 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)

    Definition Classes
    SparseMatrixRMatriR
  107. def setFormat(newFormat: String): Unit

    Set the format to the 'newFormat'.

    Set the format to the 'newFormat'.

    newFormat

    the new format string

    Definition Classes
    MatriR
  108. def showAll(): Unit

    Show all elements in 'this' sparse matrix.

  109. def slice(r_from: Int, r_end: Int, c_from: Int, c_end: Int): SparseMatrixR

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

    Slice 'this' sparse 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

    Definition Classes
    SparseMatrixRMatriR
  110. def slice(from: Int, end: Int): SparseMatrixR

    Slice 'this' sparse matrix row-wise 'from' to 'end'.

    Slice 'this' sparse matrix row-wise 'from' to 'end'.

    from

    the start row of the slice

    end

    the end row of the slice

    Definition Classes
    SparseMatrixRMatriR
  111. def sliceCol(from: Int, end: Int): SparseMatrixR

    Slice 'this' sparse matrix column-wise 'from' to 'end'.

    Slice 'this' sparse matrix column-wise 'from' to 'end'.

    from

    the start column of the slice (inclusive)

    end

    the end column of the slice (exclusive)

    Definition Classes
    SparseMatrixRMatriR
  112. def sliceExclude(row: Int, col: Int): SparseMatrixR

    Slice 'this' sparse matrix excluding the given row and column.

    Slice 'this' sparse matrix excluding the given row and column.

    row

    the row to exclude

    col

    the column to exclude

    Definition Classes
    SparseMatrixRMatriR
  113. def solve(b: VectoR): VectoR

    Solve for 'x' in the equation 'a*x = b' where 'a' is 'this' matrix.

    Solve for 'x' in the equation 'a*x = b' where 'a' is 'this' matrix.

    b

    the constant vector.

    Definition Classes
    SparseMatrixRMatriR
  114. def solve(l: MatriR, u: MatriR, b: VectoR): VectoR

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

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

    l

    the lower triangular matrix

    u

    the upper triangular matrix

    b

    the constant vector

    Definition Classes
    SparseMatrixRMatriR
  115. def solve(lu: (MatriR, MatriR), b: VectoR): VectoR

    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

    Definition Classes
    MatriR
  116. def sum: Real

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

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

    Definition Classes
    SparseMatrixRMatriR
  117. def sumAbs: Real

    Compute the 'abs' sum of this matrix, i.e., the sum of the absolute value of its elements.

    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'.

    Definition Classes
    SparseMatrixRMatriR
  118. def sumLower: Real

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

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

    Definition Classes
    SparseMatrixRMatriR
  119. def swap(i: Int, k: Int, col: Int = 0): Unit

    Swap the elements in rows 'i' and 'k' starting from column 'col'.

    Swap the elements in rows 'i' and 'k' starting from column 'col'.

    i

    the first row in the swap

    k

    the second row in the swap

    col

    the starting column for the swap (default 0 => whole row)

    Definition Classes
    MatriR
  120. def swapCol(j: Int, l: Int, row: Int = 0): Unit

    Swap the elements in columns 'j' and 'l' starting from row 'row'.

    Swap the elements in columns 'j' and 'l' starting from row 'row'.

    j

    the first column in the swap

    l

    the second column in the swap

    row

    the starting row for the swap (default 0 => whole column)

    Definition Classes
    MatriR
  121. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  122. def t: SparseMatrixR

    Transpose 'this' sparse matrix (rows => columns).

    Transpose 'this' sparse matrix (rows => columns).

    Definition Classes
    SparseMatrixRMatriR
  123. def times_s(b: SparseMatrixR): SparseMatrixR

    Multiply 'this' sparse matrix by sparse matrix 'b' using the Strassen matrix multiplication algorithm.

    Multiply 'this' sparse matrix by sparse matrix 'b' using the Strassen matrix multiplication algorithm. Both matrices ('this' and 'b') must be square. Although the algorithm is faster than the traditional cubic algorithm, its requires more memory and is often less stable (due to round-off errors). FIX: could be make more efficient using a virtual slice 'vslice' method.

    b

    the matrix to multiply by (it has to be a square matrix)

    See also

    http://en.wikipedia.org/wiki/Strassen_algorithm

  124. def toDense: MatrixR

    Convert this sparse matrix to a dense matrix.

    Convert this sparse matrix to a dense matrix. FIX - new builder

    Definition Classes
    SparseMatrixRMatriR
  125. def toInt: MatrixI

    Convert 'this' SparseMatrixR into a MatrixI.

    Convert 'this' SparseMatrixR into a MatrixI.

    Definition Classes
    SparseMatrixRMatriR
  126. def toString(): String

    Show the non-zero elements in 'this' sparse matrix.

    Show the non-zero elements in 'this' sparse matrix.

    Definition Classes
    SparseMatrixR → AnyRef → Any
  127. def trace: Real

    Compute the trace of 'this' sparse matrix, i.e., the sum of the elements on the main diagonal.

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

    Definition Classes
    SparseMatrixRMatriR
    See also

    Eigen.scala

  128. def update(ir: Range, jr: Range, b: MatriR): Unit

    Set a slice 'this' sparse matrix row-wise on range 'ir' and column-wise on range 'jr'.

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

    ir

    the row range

    jr

    the column range

    b

    the matrix to assign

    Definition Classes
    SparseMatrixRMatriR
  129. def update(i: Int, u: RowMap): Unit

    Set 'this' sparse matrix's row at the 'i'-th index position to the sorted-linked-map 'u'.

    Set 'this' sparse matrix's row at the 'i'-th index position to the sorted-linked-map 'u'.

    i

    the row index

    u

    the sorted-linked-map of non-zero values to assign

  130. def update(i: Int, u: VectoR): Unit

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

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

    i

    the row index

    u

    the vector value to assign

    Definition Classes
    SparseMatrixRMatriR
  131. def update(i: Int, j: Int, x: Real): Unit

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

    Set 'this' sparse matrix's element at the 'i,j'-th index position to the scalar 'x'. Only store 'x' if it is non-zero.

    i

    the row index

    j

    the column index

    x

    the scalar value to assign

    Definition Classes
    SparseMatrixRMatriR
  132. def update(i: Int, jr: Range, u: VectoR): Unit

    Set a slice of 'this' matrix row-wise at index 'i' and column-wise on range 'jr' to vector 'u'.

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

    i

    the row index

    jr

    the column range

    u

    the vector to assign

    Definition Classes
    MatriR
  133. def update(ir: Range, j: Int, u: VectoR): Unit

    Set a slice of 'this' matrix row-wise on range 'ir' and column-wise at index 'j' to vector 'u'.

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

    ir

    the row range

    j

    the column index

    u

    the vector to assign

    Definition Classes
    MatriR
  134. def upperT: SparseMatrixR

    Return the upper triangular of 'this' matrix (rest are zero).

    Return the upper triangular of 'this' matrix (rest are zero).

    Definition Classes
    SparseMatrixRMatriR
  135. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  136. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  137. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  138. def write(fileName: String): Unit

    Write 'this' matrix to a CSV-formatted text file with name 'fileName'.

    Write 'this' matrix to a CSV-formatted text file with name 'fileName'.

    fileName

    the name of file to hold the data

    Definition Classes
    SparseMatrixRMatriR
  139. def zero(m: Int = dim1, n: Int = dim2): SparseMatrixR

    Create an 'm-by-n' sparse matrix with all elements initialized to zero.

    Create an 'm-by-n' sparse matrix with all elements initialized to zero.

    m

    the number of rows

    n

    the number of columns

    Definition Classes
    SparseMatrixRMatriR
  140. def ~^(p: Int): SparseMatrixR

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

    Raise 'this' sparse matrix to the 'p'th power (for some integer 'p' >= 2). Caveat: should be replace by a divide and conquer algorithm.

    p

    the power to raise this matrix to

    Definition Classes
    SparseMatrixRMatriR

Inherited from Serializable

Inherited from Serializable

Inherited from MatriR

Inherited from Error

Inherited from AnyRef

Inherited from Any

Ungrouped