xSparseMatrix: Function to create a sparse matrix for an input file with...

View source: R/xSparseMatrix.r

xSparseMatrixR Documentation

Function to create a sparse matrix for an input file with three columns

Description

xSparseMatrix is supposed to create a sparse matrix for an input file with three columns.

Usage

xSparseMatrix(input.file, rows = NULL, columns = NULL, verbose = TRUE)

Arguments

input.file

an input file containing three columns: 1st column for rows, 2nd for columns, and 3rd for numeric values. Alternatively, the input.file can be a matrix or data frame, assuming that input file has been read. Note: the file should use the tab delimiter as the field separator between columns

rows

a vector specifying row names. By default, it is NULL

columns

a vector specifying column names. By default, it is NULL

verbose

logical to indicate whether the messages will be displayed in the screen. By default, it sets to TRUE for display

Value

an object of the dgCMatrix class (a sparse matrix)

Note

If rows (or columns) are not NULL, the rows (or columns) of resulting sparse matrix will be union of those from input.file and those from rows (or columns). None

See Also

xSparseMatrix

Examples

# create a sparse matrix of 4 X 2
input.file <- rbind(c('R1','C1',1), c('R2','C1',1), c('R2','C2',1),
c('R3','C2',1), c('R4','C1',1))
res <- xSparseMatrix(input.file)
res
# get a full matrix
as.matrix(res)

res <- xSparseMatrix(input.file, columns=c('C1','C2','C3'))
res

hfang-bristol/XGR documentation built on Feb. 4, 2023, 7:05 a.m.