plot_centrality: Plot Centrality

In cograph: Analysis and Visualization of Complex Networks

Plot Centrality

Description

Publication-quality visualization of one or more centrality measures. Accepts the data frame from centrality directly or any network input.

Usage

plot_centrality(
  x,
  measures = NULL,
  style = c("line", "bar", "lollipop", "dot"),
  orientation = c("horizontal", "vertical"),
  scale = c("raw", "normalized", "z", "rank"),
  order_by = NULL,
  top_n = NULL,
  highlight = 0L,
  cluster = NULL,
  palette = "cograph",
  ncol = NULL,
  title = NULL,
  subtitle = NULL,
  ...
)

Arguments

x	Output of centrality, or any network input (matrix, igraph, cograph_network, tna, netobject).
measures	Character vector of measure names. Default pulls the classical five (degree, strength, betweenness, closeness, eigenvector) when x is a network; default NULL keeps all columns when x is already a centrality data frame.
style	Character: "line" (default), "bar", "lollipop", or "dot".
orientation	Character: "horizontal" (default, nodes on y-axis) or "vertical" (nodes on x-axis).
scale	Character: "raw" (default, native units; in the "line" style this forces free y-axis per measure via faceting), "normalized" ([0, 1] within measure), "z" (standardized within measure), or "rank" (1..n, highest value = 1).
order_by	Character. For "bar"/"lollipop": which measure sorts nodes. Defaults to the first measure. Use "alpha" for alphabetical. For "line", this also controls node ordering unless "alpha" is requested.
top_n	Optional integer to keep only the top-N nodes (by order_by). Useful for large graphs.
highlight	Optional integer: highlight the top-N bars/lines per measure in full color; mute the rest. Default 0 (no highlighting).
cluster	Optional named vector or data-frame column mapping each node to a cluster/community. Colors nodes by cluster when supplied.
palette	Character or vector. "cograph" (default) uses cograph's teal-gold-leaf palette; "okabe" uses Okabe-Ito; "viridis" uses viridis; or supply a character vector of colors.
ncol	For faceted styles ("bar", "lollipop"): number of columns. Default NULL chooses sensibly based on measure count.
title	Plot title. Default NULL.
subtitle	Plot subtitle. Default NULL.
...	Passed to centrality when x is a network.

Details

Four styles are available:

"line"

Faceted line view with one panel per measure. Nodes are ordered along the requested orientation and connected within each measure.

"bar"

Horizontal bars, one facet per measure. Best for reading individual measure values.

"lollipop"

Like "bar" but with a dot at the tip. Softer visual weight; useful on dense grids.

"dot"

Dot-only variant of the lollipop style.

Value

A ggplot object.

Examples

adj <- matrix(c(0,1,1,0,0, 1,0,1,1,0, 1,1,0,1,1, 0,1,1,0,1, 0,0,1,1,0),
              5, 5)
rownames(adj) <- colnames(adj) <- LETTERS[1:5]
plot_centrality(adj)
plot_centrality(adj, style = "bar", highlight = 2)

cograph documentation built on May 31, 2026, 5:06 p.m.