Skip to contents

Plot the group-influence network (the net-influence spine)

Source: R/plot_groups_influence_network.R
plot_groups_influence_network.Rd

Experimental. Draws the directed influence backbone from a sniff_groups_influence() object as a node-link graph: an arrow runs from the source (the cited, more foundational group) to the recipient (the citing group). By default the edges are the net flow $net (\(\nu_{ij} = C_{ij} - C_{ji}\)), the "who, on balance, leads whom" spine; nodes are coloured by role (source / broker / sink) and sized by citation activity.

Usage

plot_groups_influence_network(
  influence,
  weight = c("net", "gross", "surprise"),
  min_weight = 0,
  node_size = c("equal", "io", "balance"),
  colour_role = TRUE,
  edge_labels = TRUE,
  edge_digits = NULL,
  labels = TRUE,
  label_size = NULL,
  layout = "sugiyama",
  title = NULL
)

Arguments

influence

A sniff_groups_influence() object.

weight

Which edges and weights to draw: "net" (default, the net-flow spine $net, one arrow per connected pair), "gross" (every directed channel, weighted by citation count), or "surprise" (every directed channel, weighted by the size-null surprise).

min_weight

Drop edges whose weight is below this (default 0).

node_size

How to size the group nodes: "equal" (default), "io" (citations made plus received) or "balance" (the absolute balance \(|\beta|\)).

colour_role

Colour nodes by their source / broker / sink role (default TRUE).

edge_labels

Print the weight on each edge (default TRUE).

edge_digits

Decimal places for the edge weight labels; NULL (default) shows integers for "net"/"gross" and two decimals for the continuous "surprise" weight.

labels

Print the group label on each node (default TRUE).

label_size

Font size of the node labels; NULL (default) auto-sizes the nodes and the text so even the smallest node holds its group id.

layout

A ggraph/igraph layout name (default "sugiyama", the layered DAG layout).

title

Plot title; NULL (default) removes it.

Value

A ggplot object.

See also

sniff_groups_influence(), plot_groups_influence_matrix()

Other visualization: plot_groups_influence_matrix(), plot_groups_lineage_2d(), plot_groups_lineage_3d(), plot_groups_map(), plot_groups_map_animation(), plot_groups_map_interactive(), plot_groups_per_year(), plot_trajectory_confluence(), plot_trajectory_confluence_interactive(), plot_trajectory_confluence_matrix(), plot_trajectory_dag(), plot_trajectory_dag_interactive(), plot_trajectory_dispersion(), plot_trajectory_dynamics(), plot_trajectory_dynamics_interactive(), plot_trajectory_formation(), plot_trajectory_lines_2d(), plot_trajectory_lines_3d()

Examples

if (FALSE) { # \dontrun{
infl <- sniff_groups_influence(groups)
plot_groups_influence_network(infl)
plot_groups_influence_network(infl, weight = "gross", min_weight = 50)
} # }