Chapters and reference
Complete canonical API text; task articles explain the workflows. Usage guide

Compose independent genomic panels
Source:R/fusion.R
ggchord_fusion.RdA Fusion is a static composition, not a coordinate system. Add independent
fusion_panel() objects and independent fusion_ribbon() layers. Ordinary
ggplot2::ggsave() rebuilds panels and interval fronts at the target size.
Source plots and their scales remain independent. Composition scales and
themes apply to cross-panel links, their separate Guides and native outer
plot furniture. Use labs(title/subtitle/caption/tag) and standard plot Theme
elements for composition headings, captions, backgrounds and margins. Child
axes and styles remain local; the composition has no Cartesian data axes.
Arguments
- center
A ggchord genomic plot (Circular, Chord, Collinear, Sankey or Radial), or another Fusion. Nested biological endpoints use full panel paths.
- center_size
Optional width and height as fractions of the composition content area, excluding native outer plot decorations and cross-panel Guides. NULL allocates available space.
- layout
"fixed"uses fixed panel allocations;"adaptive"also adjusts the central allocation to the physical aspect ratio and jointly measures native cross-panel Guide candidates against panel allocations. Unlocked Guide positions/direction/rows may adapt; explicit native settings and absolute boxes stay fixed. Multiple outside Guide positions are allowed. Both rebuild labels and guides at actual panel sizes without shrinking explicit fonts. Impossible space constraints fail rather than dropping keys.- allow_overlap
Explicitly allow container overlap. Default FALSE fails on overlap. When TRUE, later panels paint over earlier panels. Connections use disjoint native grid clips to avoid accumulating translucent fills. Ordinary child margins do not break links; later containers still cover earlier content. This is deliberate placement, not global collision avoidance.
- center_box
Optional centre allocation: xmin, xmax, ymin, ymax as four fractions of the composition content area excluding outer decorations and Guides, or four absolute grid units. Use instead of center_size. See fusion_panel().
- guides
"keep"(default) leaves child plot legends local."collect"moves their native outside legends to the composition edge and removes visually identical duplicates. Scales are not combined or retrained across panels: use matching limits, breaks and guide styles for shared semantics. Different legends are retained separately, even with identical titles. Childlegend.position = "none"stays hidden; inside legends cannot be collected. Nested cross-panel legends stay local to their composition. Collected boxes wrap to available device width.
Value
A Fusion object, printable and accepted by ggplot2::ggsave().
Examples
R · Example code
library(dplyr)
data(seq_data_example)
seqs <- seq_data_example |> select(accver, length) |> slice_head(n = 2)
center <- ggchord(seqs) + geom_seq() + coord_chord()
detail <- ggchord(seqs) + geom_seq() + coord_collinear(seq_axis = "vertical")
ggchord_fusion(center, guides = "collect") +
fusion_panel(detail, id = "detail", side = "right") +
ggplot2::labs(title = "Independent genomic views",
caption = "Source: bundled sequence records")