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稀疏矩陣的方法。