cupy.sparse.dia_matrix

class cupy.sparse.dia_matrix(arg1, shape=None, dtype=None, copy=False)

Sparse matrix with DIAgonal storage.

Now it has only one initializer format below:

dia_matrix((data, offsets))

Parameters:

• arg1 – Arguments for the initializer.
• shape (tuple) – Shape of a matrix. Its length must be two.
• dtype – Data type. It must be an argument of numpy.dtype.
• copy (bool) – If True, copies of given arrays are always used.

See also

scipy.sparse.dia_matrix

Methods

__len__()

__iter__()

arcsin()

Elementwise arcsin.

arcsinh()

Elementwise arcsinh.

arctan()

Elementwise arctan.

arctanh()

Elementwise arctanh.

asformat(format)

Return this matrix in a given sparse format.

Parameters:format (str or None) – Format you need.

asfptype()

Upcasts matrix to a floating point format.

When the matrix has floating point type, the method returns itself. Otherwise it makes a copy with floating point type and the same format.

Returns:A matrix with float type. Return type:cupy.sparse.spmatrix

astype(t)

Casts the array to given data type.

Parameters:dtype – Type specifier. Returns:A copy of the array with a given type.

ceil()

Elementwise ceil.

conj()

conjugate()

copy()

Returns a copy of this matrix.

count_nonzero()

Returns number of non-zero entries.

Note

This method counts the actual number of non-zero entories, which does not include explicit zero entries. Instead nnz returns the number of entries including explicit zeros.

Returns:Number of non-zero entries.

deg2rad()

Elementwise deg2rad.

diagonal()

Returns the main diagonal of the matrix

dot(other)

Ordinary dot product

expm1()

Elementwise expm1.

floor()

Elementwise floor.

get(stream=None)

Returns a copy of the array on host memory.

Parameters:stream (cupy.cuda.Stream) – CUDA stream object. If it is given, the copy runs asynchronously. Otherwise, the copy is synchronous. Returns:Copy of the array on host memory. Return type:scipy.sparse.dia_matrix

getH()

get_shape()

Returns the shape of the matrix.

Returns:Shape of the matrix. Return type:tuple

getformat()

getmaxprint()

getnnz(axis=None)

Returns the number of stored values, including explicit zeros.

Parameters:axis – Not supported yet. Returns:The number of stored values. Return type:int

log1p()

Elementwise log1p.

maximum(other)

minimum(other)

multiply(other)

Point-wise multiplication by another matrix

power(n, dtype=None)

Elementwise power function.

Parameters:

• n – Exponent.
• dtype – Type specifier.

rad2deg()

Elementwise rad2deg.

reshape(shape, order='C')

Gives a new shape to a sparse matrix without changing its data.

rint()

Elementwise rint.

set_shape(shape)

sign()

Elementwise sign.

sin()

Elementwise sin.

sinh()

Elementwise sinh.

sqrt()

Elementwise sqrt.

sum(axis=None, dtype=None, out=None)

Sums the matrix elements over a given axis.

Parameters:

• axis (int or None) – Axis along which the sum is comuted. If it is None, it computes the sum of all the elements. Select from {None, 0, 1, -2, -1}.
• dtype – The type of returned matrix. If it is not specified, type of the array is used.
• out (cupy.ndarray) – Output matrix.

Returns:

Summed array.

Return type:

cupy.ndarray

See also

scipy.sparse.spmatrix.sum()

tan()

Elementwise tan.

tanh()

Elementwise tanh.

toarray(order=None, out=None)

Returns a dense matrix representing the same value.

tobsr(blocksize=None, copy=False)

Convert this matrix to Block Sparse Row format.

tocoo(copy=False)

Convert this matrix to COOrdinate format.

tocsc(copy=False)

Converts the matrix to Compressed Sparse Column format.

Parameters:copy (bool) – If False, it shares data arrays as much as possible. Actually this option is ignored because all arrays in a matrix cannot be shared in dia to csc conversion. Returns:Converted matrix. Return type:cupy.sparse.csc_matrix

tocsr(copy=False)

Converts the matrix to Compressed Sparse Row format.

Parameters:copy (bool) – If False, it shares data arrays as much as possible. Actually this option is ignored because all arrays in a matrix cannot be shared in dia to csr conversion. Returns:Converted matrix. Return type:cupy.sparse.csc_matrix

todense(order=None, out=None)

Return a dense matrix representation of this matrix.

todia(copy=False)

Convert this matrix to sparse DIAgonal format.

todok(copy=False)

Convert this matrix to Dictionary Of Keys format.

tolil(copy=False)

Convert this matrix to LInked List format.

transpose(axes=None, copy=False)

Reverses the dimensions of the sparse matrix.

trunc()

Elementwise trunc.

__eq__(other)

Return self==value.

__ne__(other)

Return self!=value.

__lt__(other)

Return self<value.

__le__(other)

Return self<=value.

__gt__(other)

Return self>value.

__ge__(other)

Return self>=value.

__nonzero__()

__bool__()

Attributes

A

Dense ndarray representation of this matrix.

This property is equivalent to toarray() method.

H

T

device

CUDA device on which this array resides.

dtype

Data type of the matrix.

format = 'dia'

ndim

nnz

shape

size