transf: Transform Data from/to Matrix/List Formats

transfR Documentation

Transform Data from/to Matrix/List Formats

Description

Function to transform data from/to matrix/list formats or edge list representing a network.

Usage

transf(x, type = c("toarray", "tolist", "toarray2", "toedgel"), lbs = NULL, lb2lb, 
    sep, ord, sort, sym, add, adc, na.rm)

Arguments

x

an array or a list of pair relations

type

The type of transformation.

toarray from a list of pair relations to an array format

tolist from a matrix to a list of pair relations

toarray2 from a list of pair relations to a square array

toedgel from arrays to edge list

lbs

(optional) the labels in the transformation

lb2lb

(optional and logical) whether the transformation is label-to-label. Default TRUE for "toarray" and FALSE for "tolist"

sep

(optional) the pair separator for the pairwise relations

ord

(optional) the order of the resulted structure (for "toarray"; otherwise ignored)

sort

(optional and logical) sort the arrays in the output?

sym

(optional and logical) symmetrize the arrays? (for "toarray"; otherwise ignored)

add

(optional) add elements in the array's ‘domain’

adc

(optional) add elements in the array's ‘codomain’

na.rm

(optional) remove NAs?

Details

Option "tolist" is for transforming a matrix or an array to a list of pair elements. In case that the lb2lb is enabled in this type of transformation, then lbs must be provided, whereas the pair separator is optional. On the other hand "toarray" will produce a matrix from a list of pair elements, and in this case is advisable to specify the order of the structure. Three dimensional structures are supported in the transformations with all options.

Data frames are also accepted for the "tolist" option; however, in case that this information is given as a list of pair relations the output will be a square matrix.

When the transformation option is "edgel", the output is a data frame with the first two columns for the sending and receiving ties. For simple networks, these two columns are enough and for multiplex networks additional columns are for the types of tie, one for each (cf. function edgel).

Value

Depending on the input data, the result is either a list of pair relations or a matrix of relations.

Note

For high dimensional arrays, the rel.sys function privides additional information other than the list of pair relations of the entire structure.

Author(s)

Antonio Rivero Ostoic

See Also

edgel, bundles, reduc, rel.sys

Examples

## scan the multiplication table data
s <- matrix(data=c(1, 1, 1, 3, 3, 3, 3, 3, 3), nrow=3, ncol=3, byrow=TRUE)

## transform the matrix to a list format
transf(s, lb2lb = TRUE, lbs = c('n','m','u'))

mplex/multiplex documentation built on April 9, 2024, 3:12 a.m.