Matrix (Bouncy Castle Library 1.52 API Specification)

org.bouncycastle.pqc.math.linearalgebra

## Class Matrix

- java.lang.Object
- - org.bouncycastle.pqc.math.linearalgebra.Matrix

- Direct Known Subclasses:
    GF2Matrix, GF2mMatrix

      public abstract class Matrix
      extends java.lang.Object

  This abstract class defines matrices. It holds the number of rows and the number of columns of the matrix and defines some basic methods.

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static char` | `MATRIX_TYPE_RANDOM_LT` random lower triangular matrix
    `static char` | `MATRIX_TYPE_RANDOM_REGULAR` random regular matrix
    `static char` | `MATRIX_TYPE_RANDOM_UT` random upper triangular matrix
    `static char` | `MATRIX_TYPE_UNIT` unit matrix
    `static char` | `MATRIX_TYPE_ZERO` zero matrix
    `protected int` | `numColumns` number of columns
    `protected int` | `numRows` number of rows

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `Matrix()`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `abstract Matrix` | `computeInverse()` Compute the inverse of this matrix.
    `abstract byte[]` | `getEncoded()`
    `int` | `getNumColumns()`
    `int` | `getNumRows()`
    `abstract boolean` | `isZero()` Check if this is the zero matrix (i.e., all entries are zero).
    `abstract Vector` | `leftMultiply(Vector vector)` Compute the product of a vector and this matrix.
    `abstract Matrix` | `rightMultiply(Matrix a)` Compute the product of this matrix and another matrix.
    `abstract Matrix` | `rightMultiply(Permutation p)` Compute the product of this matrix and a permutation.
    `abstract Vector` | `rightMultiply(Vector vector)` Compute the product of this matrix and a vector.
    `abstract java.lang.String` | `toString()`

    - ### Methods inherited from class java.lang.Object

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

- - ### Field Detail

    - #### numRows

          protected int numRows

      number of rows

    - #### numColumns

          protected int numColumns

      number of columns

    - #### MATRIX_TYPE_ZERO

          public static final char MATRIX_TYPE_ZERO

      zero matrix
      See Also:
        Constant Field Values

    - #### MATRIX_TYPE_UNIT

          public static final char MATRIX_TYPE_UNIT

      unit matrix
      See Also:
        Constant Field Values

    - #### MATRIX_TYPE_RANDOM_LT

          public static final char MATRIX_TYPE_RANDOM_LT

      random lower triangular matrix
      See Also:
        Constant Field Values

    - #### MATRIX_TYPE_RANDOM_UT

          public static final char MATRIX_TYPE_RANDOM_UT

      random upper triangular matrix
      See Also:
        Constant Field Values

    - #### MATRIX_TYPE_RANDOM_REGULAR

          public static final char MATRIX_TYPE_RANDOM_REGULAR

      random regular matrix
      See Also:
        Constant Field Values

  - ### Constructor Detail

    - #### Matrix

          public Matrix()

  - ### Method Detail

    - #### getNumRows

          public int getNumRows()

      Returns:
        the number of rows in the matrix

    - #### getNumColumns

          public int getNumColumns()

      Returns:
        the number of columns in the binary matrix

    - #### getEncoded

          public abstract byte[] getEncoded()

      Returns:
        the encoded matrix, i.e., this matrix in byte array form.

    - #### computeInverse

          public abstract Matrix computeInverse()

      Compute the inverse of this matrix.
      Returns:
        the inverse of this matrix (newly created).

    - #### isZero

          public abstract boolean isZero()

      Check if this is the zero matrix (i.e., all entries are zero).
      Returns:
        `true` if this is the zero matrix

    - #### rightMultiply

          public abstract Matrix rightMultiply(Matrix a)

      Compute the product of this matrix and another matrix.
      Parameters:
        `a` - the other matrix
      Returns:
        `this * a` (newly created)

    - #### rightMultiply

          public abstract Matrix rightMultiply(Permutation p)

      Compute the product of this matrix and a permutation.
      Parameters:
        `p` - the permutation
      Returns:
        `this * p` (newly created)

    - #### leftMultiply

          public abstract Vector leftMultiply(Vector vector)

      Compute the product of a vector and this matrix. If the length of the vector is greater than the number of rows of this matrix, the matrix is multiplied by each m-bit part of the vector.
      Parameters:
        `vector` - a vector
      Returns:
        `vector * this` (newly created)

    - #### rightMultiply

          public abstract Vector rightMultiply(Vector vector)

      Compute the product of this matrix and a vector.
      Parameters:
        `vector` - a vector
      Returns:
        `this * vector` (newly created)

    - #### toString

          public abstract java.lang.String toString()

      Overrides:
        `toString` in class `java.lang.Object`
      Returns:
        a human readable form of the matrix.