scipy.sparse.hstack#

scipy.sparse.hstack(blocks, format=None, dtype=None)[source]#

Stack sparse matrices horizontally (column wise)

Parameters:
blocks

sequence of sparse matrices with compatible shapes

formatstr

sparse format of the result (e.g., “csr”) by default an appropriate sparse matrix format is returned. This choice is subject to change.

dtypedtype, optional

The data-type of the output matrix. If not given, the dtype is determined from that of blocks.

Returns:
new_arraysparse matrix or array

If any block in blocks is a sparse array, return a sparse array. Otherwise return a sparse matrix.

If you want a sparse array built from blocks that are not sparse arrays, use block(hstack(blocks)) or convert one block e.g. blocks[0] = csr_array(blocks[0]).

See also

vstack

stack sparse matrices vertically (row wise)

Examples

>>> from scipy.sparse import coo_matrix, hstack
>>> A = coo_matrix([[1, 2], [3, 4]])
>>> B = coo_matrix([[5], [6]])
>>> hstack([A,B]).toarray()
array([[1, 2, 5],
       [3, 4, 6]])