dok_matrix#
- class scipy.sparse.dok_matrix(arg1, shape=None, dtype=None, copy=False, *, maxprint=None)[源代码]#
基于键的字典的稀疏矩阵。
这是一种用于增量构建稀疏矩阵的有效结构。
- 可以通过多种方式实例化
- dok_matrix(D)
其中 D 是一个二维 ndarray
- dok_matrix(S)
使用另一个稀疏数组或矩阵 S(等效于 S.todok())
- dok_matrix((M,N), [dtype])
创建初始形状为 (M,N) 的矩阵,dtype 是可选的,默认为 dtype='d'
注释
稀疏矩阵可以用于算术运算:它们支持加法、减法、乘法、除法和矩阵幂。
允许高效的 O(1) 访问单个元素。
不允许重复。
一旦构建完成,可以高效地转换为 coo_matrix。
示例
>>> import numpy as np >>> from scipy.sparse import dok_matrix >>> S = dok_matrix((5, 5), dtype=np.float32) >>> for i in range(5): ... for j in range(5): ... S[i, j] = i + j # Update element
方法
__len__
()返回 len(self)。
__mul__
(other)asformat
(format[, copy])以传递的格式返回此数组/矩阵。
asfptype
()将矩阵向上转换为浮点格式(如果需要)
astype
(dtype[, casting, copy])将数组/矩阵元素强制转换为指定的类型。
clear
()conj
([copy])逐元素的复共轭。
已弃用:返回共轭转置。
conjugate
([copy])逐元素的复共轭。
copy
()返回此数组/矩阵的副本。
count_nonzero
([axis])非零条目的数量,等效于
diagonal
([k])返回数组/矩阵的第 k 个对角线。
dot
(other)普通点积
fromkeys
(iterable[, value])创建一个新字典,其键来自 iterable,值设置为 value。
get
(key[, default])这提供了具有类型检查的 dict.get 方法功能
getH
()返回此矩阵的 Hermitian 转置。
获取稀疏矩阵的形状。
getcol
(j)返回矩阵第 j 列的副本,作为 (m x 1) 稀疏矩阵(列向量)。
矩阵存储格式
打印时要显示的最大元素数。
getnnz
([axis])存储值的数量,包括显式零。
getrow
(i)返回矩阵第 i 行的副本,作为 (1 x n) 稀疏矩阵(行向量)。
items
()keys
()maximum
(other)此数组/矩阵与另一个数组/矩阵之间的逐元素最大值。
mean
([axis, dtype, out])计算指定轴上的算术平均值。
minimum
(other)此数组/矩阵与另一个数组/矩阵之间的逐元素最小值。
multiply
(other)与另一个数组/矩阵进行逐点乘法。
nonzero
()数组/矩阵的非零索引。
pop
(k[,d])如果找不到键,则返回默认值(如果给定);否则,引发 KeyError。
popitem
()删除并返回一个 (键,值) 对,作为 2 元组。
power
(n[, dtype])逐元素幂。
reshape
(self, shape[, order, copy])在不更改数据的情况下,为稀疏数组/矩阵赋予新的形状。
resize
(*shape)将数组/矩阵就地调整为
shape
给定的尺寸set_shape
(shape)就地设置矩阵的形状
setdefault
(key[, default])如果键不在字典中,则插入值为 default 的键。
setdiag
(values[, k])设置数组/矩阵的对角线或非对角线元素。
sum
([axis, dtype, out])对给定轴上的数组/矩阵元素求和。
toarray
([order, out])返回此稀疏数组/矩阵的密集 ndarray 表示形式。
tobsr
([blocksize, copy])将此数组/矩阵转换为块稀疏行格式。
tocoo
([copy])将此数组/矩阵转换为 COOrdinate 格式。
tocsc
([copy])将此数组/矩阵转换为压缩稀疏列格式。
tocsr
([copy])将此数组/矩阵转换为压缩稀疏行格式。
todense
([order, out])返回此稀疏矩阵的密集表示形式。
todia
([copy])将此数组/矩阵转换为稀疏 DIAgonal 格式。
todok
([copy])将此数组/矩阵转换为键的字典格式。
tolil
([copy])将此数组/矩阵转换为列表的列表格式。
trace
([offset])返回稀疏数组/矩阵沿对角线的和。
transpose
([axes, copy])反转稀疏数组/矩阵的维度。
update
([E, ]**F)如果 E 存在且具有 .keys() 方法,则执行:for k in E: D[k] = E[k] 如果 E 存在且缺少 .keys() 方法,则执行:for k, v in E: D[k] = v 在这两种情况下,之后都执行:for k in F: D[k] = F[k]
值
()__getitem__