### Navigation

- index
- modules |
- next |
- previous |
- NumPy v1.3 Manual (DRAFT) »
- NumPy Reference »
- Routines »
- Array creation routines »

# numpy.bmat

`numpy.``bmat`(obj, ldict=None, gdict=None)

  Build a matrix object from a string, nested sequence, or array.

  Parameters: | obj : string, sequence or array Input data. Variables names in the current scope may be referenced, even if obj is a string.
  Returns: | out : matrix Returns a matrix object, which is a specialized 2-D array.

  See also

  `matrix`

  Examples

      >>> A = np.mat('1 1; 1 1')
      >>> B = np.mat('2 2; 2 2')
      >>> C = np.mat('3 4; 5 6')
      >>> D = np.mat('7 8; 9 0')

  All the following expressions construct the same block matrix:

      >>> np.bmat([[A, B], [C, D]])
      matrix([[1, 1, 2, 2],
              [1, 1, 2, 2],
              [3, 4, 7, 8],
              [5, 6, 9, 0]])
      >>> np.bmat(np.r_[np.c_[A, B], np.c_[C, D]])
      matrix([[1, 1, 2, 2],
              [1, 1, 2, 2],
              [3, 4, 7, 8],
              [5, 6, 9, 0]])
      >>> np.bmat('A,B; C,D')
      matrix([[1, 1, 2, 2],
              [1, 1, 2, 2],
              [3, 4, 7, 8],
              [5, 6, 9, 0]])

### Navigation

- index
- modules |
- next |
- previous |
- NumPy v1.3 Manual (DRAFT) »
- NumPy Reference »
- Routines »
- Array creation routines »