Plot Chord Diagram from a data frame
Plot Chord Diagram from a data frame
chordDiagramFromDataFrame(
df,
grid.col = NULL,
grid.border = NA,
transparency = 0.5,
col = NULL,
order = NULL,
directional = 0,
xmax = NULL,
direction.type = "diffHeight",
diffHeight = convert_height(2, "mm"),
link.target.prop = TRUE,
target.prop.height = mm_h(1),
reduce = 1e-5,
self.link = 2,
preAllocateTracks = NULL,
annotationTrack = c("name", "grid", "axis"),
annotationTrackHeight = convert_height(c(3, 2), "mm"),
link.border = NA,
link.lwd = par("lwd"),
link.lty = par("lty"),
link.auto = TRUE,
link.sort = FALSE,
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 = seq_len(nrow(df)),
link.overlap = FALSE,
scale = FALSE,
group = NULL,
big.gap = 10,
small.gap = 1,
plot = TRUE,
...)df |
A data frame with at least two columns. The first two columns specify the connections and the third column (optional)
contains numeric values which are mapped to the width of links as well as the colors if |
grid.col |
Grid colors which correspond to sectors. The length of the vector should be either 1 or the number of sectors.
It's preferred that |
grid.border |
border for grids. If it is |
transparency |
Transparency of link colors, 0 means no transparency and 1 means full transparency.
If transparency is already set in |
col |
Colors for links. It can be a vector which corresponds to connections in |
order |
Order of sectors. Default order is |
directional |
Whether links have directions. 1 means the direction is from the first column in |
xmax |
maximum value on x-axes, the value should be a named vector. |
direction.type |
type for representing directions. Can be one or two values in "diffHeight" and "arrows". If the value contains "diffHeight",
different heights of the links are used to represent the directions for which starting root has long height to give people feeling
that something is comming out. If the value contains "arrows", users can customize arrows with following arguments.
The value can be a vector which has same length as number of rows in |
diffHeight |
The difference of height between two 'roots' if |
link.target.prop |
If the Chord diagram is directional, for each source sector, whether to draw bars that shows the proportion of target sectors. |
target.prop.height |
The height of the bars when |
reduce |
if the ratio of the width of certain grid compared to the whole circle is less than this value, the grid is removed on the plot. Set it to value less than zero if you want to keep all tiny grid. |
self.link |
if there is a self link in one sector, 1 means the link will be degenerated as a 'mountain' and the width corresponds to the value for this connection. 2 means the width of the starting root and the ending root all have the same width that corresponds to the value for the connection. |
preAllocateTracks |
Pre-allocate empty tracks before drawing Chord diagram. It can be a single number indicating how many empty tracks needed to be created or a list containing settings for empty tracks. Please refer to vignette for details. |
annotationTrack |
Which annotation track should be plotted? By default, a track containing sector names and a track containing grid will be created. |
annotationTrackHeight |
Track height corresponding to values in |
link.border |
border for links, single scalar or a vector which has the same length as nrows of |
link.lwd |
width for link borders, single scalar or a vector which has the same length as nrows of |
link.lty |
style for link borders, single scalar or a vector which has the same length as nrows of |
link.auto |
Ignored. |
link.sort |
whether sort links on every sector based on the width of the links on it. If it is set to "overall", all links are sorted regardless whether they are from the first column or the second column. |
link.decreasing |
for |
link.arr.length |
pass to |
link.arr.width |
pass to |
link.arr.type |
pass to |
link.arr.col |
color or the single line link which is put in the center of the belt. The format of this argument is same as |
link.arr.lwd |
line width ofthe single line link which is put in the center of the belt. The format of this argument is same as |
link.arr.lty |
line type of the single line link which is put in the center of the belt. The format of this argument is same as |
link.largest.ontop |
controls the order of adding links, whether based on the absolute value? |
link.rank |
This is argument is removed. |
link.visible |
whether plot the link. The value is logical, if it is set to |
link.zindex |
order to add links to the circle, a large value means to add it later. |
link.overlap |
if it is a directional Chord Diagram, whether the links that come or end in a same sector overlap? |
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 |
Gaps between the sectors in the first column of |
small.gap |
Small gap between sectors. |
plot |
Internally used. |
... |
pass to |
The data frame can have a column named "rank" which is used to control the order of adding links to the diagram.
A data frame which contains positions of links, see explanation in chordDiagram.
# There is no example NULL
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.