Skip to contents
Chapters and reference

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

Uses 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")

Search documentation

↑ ↓ select · Enter open · Esc close; or browse by task. API and functions