ergm (version 4.7.1)

rlebdm: RLE-Compressed Boolean Dyad Matrix

Description

A simple class representing boolean (logical) square matrix run-length encoded in a column-major order.

Usage

rlebdm(x, n)
as.rlebdm(x, ...)
# S3 method for matrix
as.rlebdm(x, ...)
# S3 method for edgelist
as.rlebdm(x, ...)
# S3 method for network
as.rlebdm(x, ...)
# S3 method for rlebdm
as.matrix(x, ...)
# S3 method for rlebdm
dim(x)
# S3 method for rlebdm
print(x, compact = TRUE, ...)
# S3 method for rlebdm
Ops(e1, e2)
# S3 method for rlebdm
Math(x, ...)
# S3 method for rlebdm
compress(x, ...)
# S3 method for rlebdm
as.edgelist(x, prototype = NULL, ..., output = c("matrix", "tibble"))

Arguments

x

for rlebdm(), an rle() object or a vector that is converted to one; it will be coerced to logical() before processing; for as.rlebdm.matrix(), a matrix.

n

the dimensions of the square matrix represented.

...

additional arguments, currently unused.

compact

whether to print the matrix compactly (dots and stars) or to print it as a logical matrix.

e1, e2

arguments to the unary (e1) or the binary (e1 and e2) operators.

prototype

an optional network with network attributes that are transferred to the edgelist and will filter it (e.g., if the prototype network is given and does not allow self-loops, the edgelist will not have self-loops either,e ven if the dyad matrix has non-FALSE diagonal).

output

a string specifying whether the result should be a matrix or a tibble.

Methods (by generic)

• compress(rlebdm): Compress the rle data structure in the rlebdm by merging successive runs with identical values.

• as.edgelist(rlebdm): Convert an rlebdm object to an edgelist: a two-column integer matrix or tibble giving the cells with TRUE values.

Functions

• as.rlebdm(matrix): Convert a square matrix of mode coercible to logical to an rlebdm.

• as.rlebdm(edgelist): Convert an object of class edgelist to an rlebdm object whose cells in the edge list are set to TRUE and whose other cells are set to FALSE.

• as.rlebdm(network): Convert an object of class network to an rlebdm object whose cells corresponding to extant edges are set to TRUE and whose other cells are set to FALSE.

See Also

as.rlebdm.ergm_conlist()

as.edgelist()

Examples

# From a vector
rlebdm(rep(rep(c(0,1),each=3),14)[seq_len(81)], 9)

# From a constant
rlebdm(1, 3)

# Large matrix (overflowing .Machine$integer.max)
big <- rlebdm(1, 50000)
unclass(big) # Represented as two runs
stopifnot(length(big)==50000^2)