Weave a new LinkMap from a MultiFactor

Generates a new LinkMap object by cross-referencing the elements of a given MultiFactor.

Arguments

x

a MultiFactor

.path

Either a formula or a character vector of length 2 with the names of the desired combination of feature types.

out.format

Character scalar. One of 'LinkMap', 'matrix'.

include, exclude, exact

Character vectors Should feature types be included or excluded from the available paths? Exact allows for exact path definition.

Value

a LinkMap or sparse Matrix.

Examples

# Generate a random MultiFactor
x <- randomMultiFactor()

# Weave new b2c LinkMap
weave(x, b ~ c)
#> A MultiFactor::LinkMap data.frame S7_object: 25 rows.
#>        b     c
#> 1  b_005 c_001
#> 2  b_009 c_001
#> 3  b_001 c_002
#> 4  b_005 c_003
#> 5  b_006 c_003
#> 6  b_007 c_003
#> 7  b_009 c_003
#> 8  b_010 c_003
#> 9  b_006 c_004
#> 10 b_001 c_005
#>  + 15 more rows. Use `print(n = ...)` to see more rows.
#> 
#> @ levels:   2 variables: 
#>  $ b : 10 Levels: b_001 b_002 ... b_010 
#>  $ c : 10 Levels: c_001 c_002 ... c_010 
weave(x, b ~ a, out.format = "matrix")
#> 10 x 10 sparse Matrix of class "ngCMatrix"
#>   [[ suppressing 10 column names ‘a_001’, ‘a_002’, ‘a_003’ ... ]]
#>        a
#> b                          
#>   b_001 . . . . . . . . . |
#>   b_002 . . . . . . . . . |
#>   b_003 | . . . . . . . . .
#>   b_004 | . | . . . . . | .
#>   b_005 | . . . . . | . . .
#>   b_006 | . . . . . | . | |
#>   b_007 . . | . | . | | . .
#>   b_008 . . | . | . . | | |
#>   b_009 | . | | . . . . . .
#>   b_010 . . . . . . . . | .