layout_tbl_graph_hive: Place nodes in a Hive Plot layout

In thomasp85/ggraph: An Implementation of Grammar of Graphics for Graphs and Networks

Place nodes in a Hive Plot layout

Description

Hive plots were invented by Martin Krzywinski as a perceptually uniform and scalable alternative to standard node-edge layouts. In hive plots nodes are positioned on axes radiating out from a center based on their own information e.g. membership of a class, size of neighborhood, etc. Edges are then drawn between nodes as bezier curves. As the placement of nodes is not governed by convoluted algorithms but directly reflects the qualities of the nodes itself the resulting plot can be easier to interpret as well as compare to other graphs.

Usage

layout_tbl_graph_hive(
  graph,
  axis,
  axis.pos = NULL,
  sort.by = NULL,
  divide.by = NULL,
  divide.order = NULL,
  normalize = TRUE,
  center.size = 0.1,
  divide.size = 0.05,
  use.numeric = FALSE,
  offset = pi/2,
  split.axes = "none",
  split.angle = pi/6,
  circular = FALSE
)

Arguments

graph	An tbl_graph object
axis	The node attribute to use for assigning nodes to axes
axis.pos	The relative distance to the prior axis. Default (NULL) places axes equidistant.
sort.by	The node attribute to use for placing nodes along their axis. Defaults (NULL) places nodes sequentially.
divide.by	An optional node attribute to subdivide each axis by.
divide.order	The order the axis subdivisions should appear in
normalize	Logical. Should axis lengths be equal or reflect the number of nodes in each axis. Defaults to TRUE.
center.size	The size of the blank center, that is, the start position of the axes.
divide.size	The distance between subdivided axis segments.
use.numeric	Logical, If the sort.by attribute is numeric, should these values be used directly in positioning the nodes along the axes. Defaults to FALSE which sorts the numeric values and positions them equidistant from each other.
offset	Change the overall rotation of the hive plot by changing the offset of the first axis.
split.axes	Should axes be split to show edges between nodes on the same axis? One of: 'none' Do not split axes and show in-between edges 'loops' Only split axes that contain in-between edges 'all' Split all axes
split.angle	The angular distance between the two axes resulting from a split.
circular	Ignored.

Details

In order to be able to draw all edges without edges crossing axes you should not assign nodes to axes based on a variable with more than three levels.

Value

A data.frame with the columns x, y, r, center_size, split, axis, section, angle, circular as well as any information stored as node variables in the tbl_graph object.

References

Krzywinski, M., Birol, I., Jones, SJM., and Marra, MA. (2012). Hive plots-rational approach to visualizing networks. Brief Bioinform 13 (5): 627-644. https://doi.org/10.1093/bib/bbr069

https://www.hiveplot.net/

See Also

Other layout_tbl_graph_*: layout_tbl_graph_auto(), layout_tbl_graph_backbone(), layout_tbl_graph_cactustree(), layout_tbl_graph_centrality(), layout_tbl_graph_circlepack(), layout_tbl_graph_dendrogram(), layout_tbl_graph_eigen(), layout_tbl_graph_fabric(), layout_tbl_graph_focus(), layout_tbl_graph_htree(), layout_tbl_graph_igraph(), layout_tbl_graph_linear(), layout_tbl_graph_manual(), layout_tbl_graph_matrix(), layout_tbl_graph_metro(), layout_tbl_graph_partition(), layout_tbl_graph_pmds(), layout_tbl_graph_sf(), layout_tbl_graph_stress(), layout_tbl_graph_treemap(), layout_tbl_graph_unrooted()

thomasp85/ggraph documentation built on March 11, 2024, 4:46 a.m.