R formatSparseM 格式化稀疏数值矩阵实用程序

说明

以灵活的方式格式化稀疏数值矩阵的实用程序。这些函数由format和print稀疏矩阵的方法，也可以应用于标准R矩阵。注意全部参数，但第一个参数是可选的。

formatSparseM() 是 formatSpMatrix 的主要 “workhorse”，即稀疏矩阵的 format 方法。

.formatSparseSimple() 是一个简单的辅助函数，还处理(短/空)列名构造。

用法

formatSparseM(x, zero.print = ".", align = c("fancy", "right"),
              m = as(x,"matrix"), asLogical=NULL, uniDiag=NULL,
              digits=NULL, cx, iN0, dn = dimnames(m))

.formatSparseSimple(m, asLogical=FALSE, digits=NULL,
		    col.names, note.dropping.colnames = TRUE,
                    dn=dimnames(m))

参数

x	一个R对象继承自类sparseMatrix.
zero.print	用于结构零的字符。默认的"."有时可能会被" "(空白)替换；使用 "0" 看起来几乎就像非稀疏矩阵的 print() ing。
align	指定 zero.print 代码应如何对齐的字符串，请参阅 formatSpMatrix 。
m	(可选)a(标准R)matrix版本x.
asLogical	矩阵是否应该格式化为逻辑矩阵(或者更确切地说是数字矩阵)；主要用于formatSparseM()。
uniDiag	逻辑指示稀疏单位三角形或unit-diagonal矩阵的对角线条目是否应格式化为"I"而不是"1"(强调1是“structural”)。
digits	用于打印的有效数字，请参阅print.default。
cx	(可选)字符矩阵； x 的格式化版本，仍使用 "0.00" 等字符串作为零。
iN0	(可选)整数向量，指定 x 的非零位置。
col.names , note.dropping.colnames	请参阅formatSpMatrix。
dn	使用dimnames；具有行名称和列名称(或 NULL )的列表(长度为 2)。

值

像 cx 这样的字符矩阵，其中的零已被替换为 zero.print(的填充版本)。由于这是一个密集矩阵，因此不要将这些函数用于非常大(非常)的稀疏矩阵！

例子

m <- suppressWarnings(matrix(c(0, 3.2, 0,0, 11,0,0,0,0,-7,0), 4,9))
fm <- formatSparseM(m)
noquote(fm)
## nice, but this is nicer {with "units" vertically aligned}:
print(fm, quote=FALSE, right=TRUE)
## and "the same" as :
Matrix(m)

## align = "right" is cheaper -->  the "." are not aligned:
noquote(f2 <- formatSparseM(m,align="r"))
stopifnot(f2 == fm   |   m == 0, dim(f2) == dim(m),
         (f2 == ".") == (m == 0))

作者

Martin Maechler

也可以看看

formatSpMatrix哪个调用formatSparseM()并且是format稀疏矩阵的方法。
printSpMatrix由(通常隐式调用)使用show和print稀疏矩阵的方法。