chordDiagram: Plot Chord Diagram

In circlize: Circular Visualization

Plot Chord Diagram

Description

Plot Chord Diagram

Usage

chordDiagram(
    x,
    grid.col = NULL,
    grid.border = NA,
    transparency = 0.5,
    col = NULL,
    row.col = NULL,
    column.col = NULL,
    order = NULL,
    directional = 0,
    xmax = NULL,
    symmetric = FALSE,
    keep.diagonal = FALSE,
    direction.type = "diffHeight",
    diffHeight = mm_h(2),
    link.target.prop = TRUE,
    target.prop.height = mm_h(1),
    reduce = 1e-5,
    self.link = 2,
    preAllocateTracks = NULL,
    annotationTrack = c("name", "grid", "axis"),
    annotationTrackHeight = mm_h(c(3, 2)),
    link.border = NA,
    link.lwd = par("lwd"),
    link.lty = par("lty"),
    link.auto = TRUE,
    link.sort = "default",
    link.decreasing = TRUE,
    link.arr.length = ifelse(link.arr.type == "big.arrow", 0.02, 0.4),
    link.arr.width = link.arr.length/2,
    link.arr.type = "triangle",
    link.arr.lty = par("lty"),
    link.arr.lwd = par("lwd"),
    link.arr.col = par("col"),
    link.largest.ontop = FALSE,
    link.visible = TRUE,
    link.rank = NULL,
    link.zindex = NULL,
    link.overlap = FALSE,
    scale = FALSE,
    group = NULL,
    big.gap = 10,
    small.gap = 1,
    ...)

Arguments

x	a matrix or a data frame. The function will pass all argument to chordDiagramFromMatrix or chordDiagramFromDataFrame depending on the type of x, also format of other arguments depends of the type of x. If it is in the form of a matrix, it should be an adjacency matrix. If it is in the form of a data frame, it should be an adjacency list.
grid.col	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
grid.border	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
transparency	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
col	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
row.col	pass to chordDiagramFromMatrix
column.col	pass to chordDiagramFromMatrix
order	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
directional	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
xmax	maximum value on x-axes, the value should be a named vector.
symmetric	pass to chordDiagramFromMatrix
keep.diagonal	pass to chordDiagramFromMatrix
direction.type	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
diffHeight	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.target.prop	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
target.prop.height	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
reduce	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
self.link	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
preAllocateTracks	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
annotationTrack	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
annotationTrackHeight	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.border	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.lwd	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.lty	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.auto	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.sort	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.decreasing	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.arr.length	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.arr.width	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.arr.type	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.arr.lty	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.arr.lwd	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.arr.col	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.largest.ontop	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.visible	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
link.rank	This is argument is removed.
link.zindex	order to add links to the circle, a large value means to add it later.
link.overlap	pass to chordDiagramFromMatrix or chordDiagramFromDataFrame
scale	scale each sector to same width
group	It contains the group labels and the sector names are used as the names in the vector.
big.gap	Gap between the two sets of sectors. If the input is a matrix, the two sets are row sectors and column sectors. If the input is a data frame, the two sets correspond to the first column and the second column. It only works when there is no intersection between the two sets.
small.gap	Small gap between sectors.
...	pass to circos.link.

Details

Chord diagram is a way to visualize numeric tables ( http://circos.ca/intro/tabular_visualization/ ), especially useful when the table represents information of directional relations. This function visualize tables in a circular way.

This function is flexible and contains some settings that may be a little difficult to understand. Please refer to vignette for better explanation.

Value

A data frame which contains positions of links, columns are:

rn

sector name corresponding to rows in the adjacency matrix or the first column in the adjacency list

cn

sector name corresponding to columns in the adjacency matrix or the second column in the adjacency list

value

value for the interaction or relation

o1

order of the link on the "from" sector

o2

order of the link on the "to" sector

x1

and position of the link on the "from" sector, the interval for the link on the "from" sector is c(x1-abs(value), x1)

x2

and position of the link on the "to" sector, the interval for the link on the "from" sector is c(x2-abs(value), x2)

See Also

https://jokergoo.github.io/circlize_book/book/the-chorddiagram-function.html

Examples

set.seed(999)
mat = matrix(sample(18, 18), 3, 6)
rownames(mat) = paste0("S", 1:3)
colnames(mat) = paste0("E", 1:6)

df = data.frame(from = rep(rownames(mat), times = ncol(mat)),
    to = rep(colnames(mat), each = nrow(mat)),
    value = as.vector(mat),
    stringsAsFactors = FALSE)

chordDiagram(mat)
chordDiagram(df)
circos.clear()

circlize documentation built on May 29, 2024, 1:59 a.m.