qlcMatrix (version 0.9.8)

Array: Sparse Arrays ("Tensors")

Description

Convenient function linking sparse Arrays from the package spam to the sparse Matrices from the package Matrix.

Usage

Array(A)
sparseArray(i, v = NULL, ...)
as.Matrix(M)

Value

Sparse Arrays use the class "simple_sparse_array" from spam

Arguments

A

An array to be turned into a sparse Array using as.simple_sparse_array. Can also be a dataframe, but see Details below about the treatment of data frames here.

i

Integer matrix of array indices passed to simple_sparse_array.

v

vector of values passed to simple_sparse_array. If NULL (by default), all specified indices (i.e. all rows in i) are given the value 1.

M

Matrix of type simple_triple_matrix from the package spam to be turned into a TsparseMatrix from the packages Matrix.

...

Further arguments passed to simple_sparse_array.

Author

Michael Cysouw

Details

Array turns an array into a sparse Array. There is a special behavior when a dataframe is supplied. Such a dataframe is treated as `long format`, i.e. the columns of the dataframe are treated as dimensions of the Array, and all rows of the dataframe are interpreted as entries. The coordinates are given by the ordering of the levels in the dataframe, and the dimnames are given by the levels.

sparseArray constructs sparse Arrays from a matrix of indices and a vector of values. dim and dimnames can be added as in simple_sparse_array

as.Matrix turns a simple_triplet_matrix into a dgTMatrix.

Examples

x <- matrix(c(1, 0, 0, 2), nrow = 2)
s <- as.simple_triplet_matrix(x)
str(s)

as.Matrix(s)
str(as.Matrix(s))