Skip to contents

Calls motifs(x, named_nodes = TRUE, ...). By default (strict = TRUE) the result has one row per node triple and labelled pattern: the shape and the direction of every arrow are fixed, so a cycle and its reverse are different rows. At individual level, observed counts the units in which the triple shows exactly that pattern, so one triple can occupy several rows. strict = FALSE pools the patterns of each MAN type into one row. One MAN type can also appear in many rows, each with its own z and p. Per-triple significance is plotted by plot(., type = "significance") and plot(., type = "triads"). The per-type plots ("types", "patterns") omit significance for instance results.

Usage

subgraphs(...)

Arguments

...

Arguments forwarded to motifs(), which documents them (x, actor, window, window_type, pattern, include, exclude, significance, n_perm, cores, min_count, edge_method, edge_threshold, min_transitions, top, seed, family, p_adjust, strict, count_repeats). named_nodes is fixed to TRUE and must not be supplied.

Value

A cograph_motif_result object with named_nodes = TRUE, described in motifs(), or NULL with a message when no triple passes the filters. Its results table has the columns triad, node1, node2, node3, type, observed, pattern, pattern_n and pattern_code, and with significance = TRUE also expected, z, p, p_adj and sig. Its type_summary counts the node triples of each MAN type.

Details

The "triads" diagram draws the labelled pattern of each row (its pattern column) with node1 at the top, node2 bottom left and node3 bottom right, so the arrows show who sends to whom. With strict = FALSE it draws the most frequent pattern of the row, and when the row pools other patterns the caption gives how many units match the drawing, for example "n=21 (13 as drawn)".

Examples

subgraphs(regulation_net, significance = FALSE, min_count = 1)
#> Showing triangle patterns (count >= 1). For all MAN types use pattern = 'all'.
#> Motif Subgraphs 
#> Level: aggregate | States: 10 | Pattern: triangle 
#> Min count: >= 1 
#> 
#> Type distribution:
#> 
#> 120C 030T 120D 120U 
#>    3    2    1    1 
#> 
#> Top 7 results:
#>                        triad   node1    node2   node3 type observed
#>  Monitor - Evaluate - Create Monitor Evaluate  Create 120C     1.26
#>     Monitor - Create - Share Monitor   Create   Share 120C     1.26
#>       Plan - Monitor - Share    Plan  Monitor   Share 120U     1.19
#>     Plan - Evaluate - Create    Plan Evaluate  Create 030T     1.08
#>  Explore - Reflect - Discuss Explore  Reflect Discuss 120D     1.05
#>      Monitor - Adapt - Share Monitor    Adapt   Share 030T     1.04
#>        Plan - Create - Share    Plan   Create   Share 120C     1.00
#>                                                      pattern pattern_n
#>  Evaluate -> Monitor, Monitor <-> Create, Create -> Evaluate         1
#>        Monitor <-> Create, Share -> Monitor, Create -> Share         1
#>            Plan -> Monitor, Plan <-> Share, Share -> Monitor         1
#>         Plan -> Evaluate, Plan -> Create, Create -> Evaluate         1
#>  Explore <-> Reflect, Discuss -> Explore, Discuss -> Reflect         1
#>           Monitor -> Adapt, Share -> Monitor, Share -> Adapt         1
#>              Plan -> Create, Plan <-> Share, Create -> Share         1