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

Connect real intervals across Fusion panels
Source:R/fusion.R
fusion_ribbon.RdUses ordinary qaccver/saccver and qstart/qend/sstart/send columns. Optional
qpanel/spanel and q_instance/s_instance select exact panels and display
instances. Missing selectors are inferred only when a unique candidate
exists. Query/subject roles never depend on the placement of a panel.
Intervals are one-based inclusive, with ordered fronts spanning [min-1,max];
a one-position interval has nonzero width. Fully visible intervals are
required; split/focus the source data explicitly before composition.
Usage
R · Example code
fusion_ribbon(
data,
mapping = NULL,
qpanel = NULL,
spanel = NULL,
gradient = FALSE,
tip = c("none", "subject"),
allow_repeated = FALSE,
curvature = 0.3,
fill = NULL,
colour = NA,
alpha = 0.35,
linewidth = 0.25,
linetype = 1,
show.legend = NA,
route = c("direct", "avoid", "bundle"),
route_width = 0.8
)Arguments
- data
A relationship data frame, preserving original endpoints.
- mapping
Standard ggplot2 aesthetic mapping: fill, colour, alpha, linewidth and linetype. With pident and no explicit fill, Identity is mapped by default with 0/50/80/90/95/100 breaks. Composition uses ordinary scale_fill_* etc.; panel role scales remain local to each panel.
- qpanel, spanel
Optional fixed panel IDs. Do not also supply their columns.
- gradient
Opt in to query-to-subject sequence-colour interpolation. Cannot be combined with an explicit fill or fill mapping.
- tip
"none"or a decorative"subject"tip. Source fronts remain exported in full even when the tip is drawn.- allow_repeated
Explicitly allow repeated source_hsp_id display.
- curvature
Control distance relative to endpoint separation, in
[0,1]. Nearly tangential arrivals use coherent perpendicular endpoint normals to avoid artificial S bends; ordered source fronts are never rearranged.- fill, colour, alpha, linewidth, linetype
Fixed styles; explicit values take priority over mappings. The default fill without pident is steelblue.
- show.legend
Standard ggplot2 legend selection: NA follows mappings; TRUE/FALSE or a named logical vector controls guide participation.
- route
Default direct Bezier ribbons, or avoid for a measured obstacle route. Bundle requires an explicit route_group character column and shares a corridor for each group and ordered panel pair within the layer; every observation, source row, complete front and style remains independent. It does not aggregate evidence or imply biological flow. Avoid preserves complete interval fronts and uses a narrow polygonal corridor between them. Failure to find a clear route is explicit.
- route_width
Positive corridor width in mm for avoid/bundle (default .8). This is drawing width, not an alignment length or statistical weight.
Value
A component for ggchord_fusion().
Examples
R · Example code
data(seq_data_example)
data(ribbon_data_example)
p <- ggchord(seq_data_example) + geom_seq()
ggchord_fusion(p) +
fusion_panel(p + coord_collinear(), "detail") +
fusion_ribbon(ribbon_data_example, qpanel = "center", spanel = "detail")