Skip to contents

Plot the directed group-influence matrix (heatmap)

Source: R/plot_groups_influence_matrix.R
plot_groups_influence_matrix.Rd

Experimental. The directed counterpart of plot_trajectory_confluence_matrix(): a heatmap of the cross-citation channels from a sniff_groups_influence() object. Rows are the citing group ("is influenced by") and columns the cited group ("the influencer"), so a cell and its mirror across the diagonal are the two directions of one pair. Confluence is symmetric; influence is not, and that broken symmetry is the bidirectional relationship.

Usage

plot_groups_influence_matrix(
  influence,
  fill = c("surprise", "raw", "debt", "audience", "salton"),
  diagonal = c("mute", "show", "drop"),
  show_values = TRUE,
  label_size = 4,
  order_by = c("group", "balance"),
  axis_text_size = NULL,
  axis_title_size = NULL,
  x_angle = 0,
  legend_position = "right",
  bg = "white",
  title = NULL
)

Arguments

influence

A sniff_groups_influence() object.

fill

Which value to colour by: "surprise" (default, the flow against the size null, on a diverging scale centred at 1), "raw" (citation counts), "debt", "audience" or "salton".

diagonal

How to treat the intra-group cohesion cells: "mute" (default, drawn grey, off the colour scale, so the between-group channels keep the contrast), "show" (on the scale like any cell) or "drop" (not drawn).

show_values

Print the value inside each cell (default TRUE).

label_size

Font size of the in-cell values (default 4).

order_by

Group order on both axes: "group" (default, mixed_sort()) or "balance" (sources first, sinks last).

axis_text_size, axis_title_size

Font sizes of the tick labels and axis titles; NULL (default) keeps the theme defaults.

x_angle

Rotation in degrees of the column (cited-group) labels on the top axis. Default 0 (horizontal); 90 stacks the cNgN ids vertically so they stay legible on a small figure with many groups.

legend_position

Legend placement: "right" (default), "left", "top", "bottom" or "none".

bg

Panel/plot background colour (default "white").

title

Plot title; NULL (default) removes it.

Value

A ggplot object.

See also

sniff_groups_influence(), plot_groups_influence_network(), plot_trajectory_confluence_matrix()

Other visualization: plot_groups_influence_network(), 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_matrix(infl)
plot_groups_influence_matrix(infl, fill = "debt", diagonal = "drop")
} # }