\donttest{}, including dependency loading, with a reason
comment. Complete runnable examples and platform guards remain; no
parser or plotting API changes.Further shorten Ribbon and Adaptive help examples. VCF examples copy three unchanged source records instead of parsing the complete demonstration file; BigWig examples show one selected read. Both readers retain optional dependency and platform guards and run as ordinary examples. Installed tutorials refer to local dataset help for provenance; complete website examples remain available.
Add ready-to-plot datasets for all seven flagship types and the 13 complete reference maps. Plotting pages load prepared inputs; a dedicated bilingual chapter documents sources, selections and rebuilding. Physical geometry and label placement remain computed at drawing time.
Add genome_comparison_example and
sequence_detail_example, with complete source tables,
documented flagship display subsets and reproducible generation rules.
Website plotting examples now use bundled inputs; file-import lessons
retain explicit reader calls. Shared styles and per-view code reduce
repeated preparation while preserving the existing flagship
appearance.
Help examples use smaller explicit subsets of real data,
restricted DNA feature discovery and reference primer binding sites.
Core plots remain runnable; additional complete layout examples are
marked \donttest{}. Decoder examples use
dependency/platform guards and small ordinary inputs.
DESCRIPTION now expands HSP (high-scoring segment pair). No plotting defaults or public interfaces change in this maintenance revision.
Fusion compositions rebuild their physical layout when recorded
graphics are replayed on a different device. This fixes cropped panels
and misplaced cross-panel ribbons/leaders in native reference output and
other recorded-plot workflows; direct ggsave() output
remains consistent at the target size.
geom_residue() now defaults to a continuous
alignment matrix with a 1:1 cell ratio, dark bold sans-serif glyphs and
chemistry-based DNA/RNA/AA fill scales. The earlier unconstrained
row-height backgrounds could become tall bars around small letters.
Default text grows uniformly to fit cells, with a 3 mm readability
floor; explicit sizes retain the tile/error overflow contract. User
mappings, fixed colours, scales and coordinates take priority. Character
legends are hidden by default; use show.legend = TRUE to
show them. scale_fill_residue() provides explicit alphabet
selection; use ggplot2::scale_fill_manual() for custom
colours. Palette provenance is recorded in the installed
NOTICE.
geom_residue(line_width = 50) wraps 100 columns into
lines 1-50 and 51-100, with shared breaks across sequences and labelled
original ranges. Original data, source positions and gaps remain intact.
Wrapped character plots can be registered for Fusion; split cross-line
focus selections into explicit source intervals.
magnify_ggchord(frame_region = ...) independently
adjusts the displayed source frame while retaining the real selected
interval, detail data and magnification ratio. Default source frames use
the selected source coordinates; frame height remains a separate
physical setting. Exports retain frame bounds and raw overrides
separately from the real selection.
Homepage Fusion Identity guides retain proportional numeric interval widths; the preview no longer forces even steps. Local zoom axes show original source coordinates and use slimmer source selection frames for clearer correspondence.
API reference pages evaluate their examples and include actual figure or text output in both languages, with runnable local-input examples for previously code-only topics. Missing optional decoders are reported explicitly.
The registered Opuntia magnification example uses a readable 30-column excerpt, short display labels and chemistry colours without altering source IDs. Character focus highlights now trace unfilled cell outlines: translucent focus bands no longer cover the letters or mute their residue colours.
Fusion’s sixth panel displays 60 verified coding bases from E’s lower-sequence second CDS (OQ646790.1 / cds-WGH15551.1, 11006-11065 bp). Source-window and nucleotide leaders retain exact registered intervals; full and homepage figures share the same source data. Magnification frames include native character axes so their corners do not collide with their own row labels.
README design attribution distinguishes documented influences from research comparisons, with an evidence audit instead of unsupported algorithm or integration claims. Current user-facing prose omits commercial product names.
Post-release documentation: website Markdown links resolve to tracked repository files and explicit source anchors; the site builder translates them to published page and asset URLs. Both language editions remain synchronized. Release notes include cumulative changes directly, without a link to a missing historical file.
Repository-wide link repair also supplies missing vignette images and source scripts, pins archived source links to their historical commits, and replaces unavailable local-only comparison images with explicit availability notices. Documentation checks cover tracked Markdown, HTML, Rd and Rmd targets/anchors; external HTTP failures and access restrictions are reviewed separately.
Radial ribbons now use solid outlines between cyclic neighbours and dashed outlines between non-neighbours; the first and last spokes are neighbours. Explicit fixed/mapped line types and user scales retain priority. Radial uses the same nonadjacent_linewidth default as Collinear; Chord and Sankey defaults are unchanged.
Radial flagship MT108731.1 and OR222515.1 are displayed outward. Nonadjacent connections use adjustable annular midpoint lift and separate occupied channels to clear intervening spokes, preserving original HSP and CDS coordinates and source identities.
ggchord_fusion(guides = "collect") collects native
child legends outside the composition and removes visually identical
duplicates, without changing child scales or source plots. Default keep
retains earlier behaviour.
Fusion flagship uses a shared outer legend, six source HSPs and twelve CDS in each overview, stronger A-B/A-C/C-D interval correspondences and larger panels. Full 32-HSP/266-CDS inputs remain unchanged. Detail panels display selected source annotations with flanking context. D retains forward full-length sequences; E is registered source-window magnification with paired highlights and two envelope leaders. D and E retain the same four selected source CDS within the zoom windows. Each source highlight band has its own exact outline, without a padded rectangle around multiple sequences. A is enlarged, B is wider, and sequence names, features and annotations are more readable. E’s compact sequence-and-label frame excludes its heading; the C-D ribbon avoids E. The heading sits closer to the sequence content.
magnify_ggchord(connector = "envelope") groups
selected windows by source/detail panel pair, joins real source
highlight edges to a detail sequence-and-label frame with two leaders,
and retains exact per-interval source outlines and data. The detail
frame is a display envelope, not a genomic interval. Default
per-interval leaders remain unchanged.
Full-size and homepage Fusion layouts allocate more height to Chord, with output-specific title sizes and more compact homepage legends. Scientific colours, source data and full-figure/tutorial destinations are retained.
README real-data examples are grouped by four modules; multi-sequence views use a compact two-column gallery, with links to full figures and tutorials.
Cross-panel obstacle routing measures native heading glyphs rather than treating unused space in the entire heading cell as blocked. Native title fonts, margins and justification are retained.
Cross-panel curves choose coherent endpoint normals for nearly
tangential arrivals, avoiding artificial S bends without sorting or
reversing real interval fronts.
magnify_ggchord(guides = "collect") forwards shared native
legend placement to its Fusion, retaining keep as the default.
Website prose now has one Han source with saved, reviewed English translations. Build checks reject stale translations or independently edited generated pages.
Multi-sequence Dotplots separate sequence/range headers from local coordinates, with outlined length-proportional comparison cells. Explicit position scales retain priority, and original HSP endpoints and axis mappings remain unchanged.
Website home now uses an introduction above a full-width four-module grid, with dedicated source-backed previews, concise capability descriptions and natural page height. Sequence alignment Dotplot replaces the HSP-only entry name; original technical HSP terminology and contracts remain unchanged.
Radial and Sankey flagship examples use view-specific export proportions, compact horizontal Identity guides and larger feature/name styling. Their original HSP endpoints and CDS inputs remain, with all original name candidates and Sequence guides restored. Circular homepage colours use the source name palette; the Fusion preview again derives from the four-panel flagship.
Collinear annotations search nearby positions before distant lanes. Radial, Sankey and vertical Collinear labels resolve collisions after projection using physical text dimensions, preserving manual placements and source records. Fixed-label visibility diagnostics now report their actual displayed text.
Website: restore Flexible parameter formats as a searchable capability, separate parameter-family matching/default rules, and add source-backed reorder/strand comparisons. Cumulative plotting examples retain links and labels across Coord changes; strict four-view comparisons precede independently selected flagships.
Website: unify section navigation, correct reference example destinations, place minimal Dotplot input first, and add input-based workflows, symptom-based diagnostics and shared preview/export dimensions. Improve code text, search, reference filtering and gallery labels in both languages.
CI: Unicode text bounds now use the existing Unicode-capable
fallback when the active device is base PDF/PostScript, restoring the
caller device afterwards. The layout-policy addition method accepts the
ggplot2 generic’s ... arguments.
Tests: retain two short data/plot files; remove redundant geometry, device and parameter checks. Core fill and empty-primer regressions select actual layers rather than assuming positions before automatic axis insertion.
Sankey projection preserves missing angle metadata in mixed text/leader records instead of failing during readable-angle normalization.
Automatic dashed/heavier ribbon outlines now apply only to non-adjacent Collinear rows (horizontal or vertical). Chord, Radial and Sankey use ordinary solid outlines by default. Fixed and mapped line types retain priority; source HSPs, selection and ribbon geometry are unchanged.
The documentation source now organizes usage into multi-sequence relationships, single-sequence circular maps, HSP Dotplots and Fusion composition. Shared minimal examples, source-aware detail examples, task search and gallery filters use explicit page metadata and section migrations. Original figure identifiers and sources are retained alongside new course PNGs.
Website installation guidance uses a general GitHub installation path with minimum requirements and commands to inspect the active environment. Projection, GFF3 unknown-strand handling, count versus supplied-value tracks, registered character details and Fusion scope are described consistently. Parameter atlas types use API context, distinguish missing formal defaults from required arguments, and document count bars’ zero-baseline restriction. Existing public aliases retain their reference routes.
Automatic sequence-axis lines and major/minor ticks now draw before the first gene, feature or primer layer, so marks no longer paint over feature arrows. Measured axis text remains in front. User layer order, source coordinates, tick positions and explicit scale-bar placement are preserved.
The same bounded straight/single-elbow exit check also covers exterior restriction-site leaders. Fixed cut positions, text entries, labels and source rows remain unchanged; a collided restriction fan is not exempt from text and leader checks merely because the feature callouts are already clear. Explicit straight and elbow styles retain their chosen routes.
Collided exterior feature callouts can jointly choose shorter straight or single-elbow exits while keeping their source roots and label entries fixed. A complete group must clear registered text and all other leaders before it replaces the original routes; an unsuccessful group retains its old layout and overlap display policy. Feature labels are not moved or removed.
Automatic circular endpoint strings can use either readable side of their unchanged tick and a bounded gap (up to 4 mm) when fixed feature exits would cross the string. Explicit breaks and axis offsets retain their positions. Axis diagnostics report the chosen side and tangential gap separately from radial clearance; no source label or endpoint string is removed.
Non-circular feature-label layers receive an explicit false value for the inside-to-outside style marker, fixing a linear-view aesthetic evaluation error. Empty label tables retain their complete drawing schema and use zero-length parameter vectors instead of assigning a scalar to zero rows. Existing nonempty circular drawing geometry remains unchanged.
Circular origin/end coordinate strings take priority over
intermediate ticks and adjustable leader-exit channels. Endpoint text is
retained; unresolved nearby placement is reported as
endpoint_unresolved rather than hiding the endpoint or
pushing it towards the centre. Explicit positions keep their placement.
External feature routes retain their straight or single-bend geometry
while now honouring the existing fade/clip/show text-overlap appearance
after perimeter coordination. Segment clipping drops numerical
zero-length fragments; contour audits distinguish exact closed-edge
contacts from points genuinely outside.
Feature segment-boundary marks are clipped to the actual arrow
contour, including tapered and compressed heads, instead of spanning the
nominal feature width. Isolated, centred internal names omit unnecessary
short attachments; shifted or competing names retain source leaders.
geom_feature_label_repel(label_segment_colour = "auto")
uses muted grey for leaders that start inside the sequence circle and
end at an exterior feature label; automatic line type makes those
attachments dashed. Labels that stay inside and restriction-site leaders
retain their previous style. Explicit colour/line type or a custom
segment theme takes priority.
Wrapped internal feature labels now draw each line along its own
concentric baseline, using the same glyph geometry for placement,
clipping and display. Automatic plasmid coordinate strings retain a
small physical gap from the backbone. Movable strings reach measured
clearance before overlap hiding, rather than disappearing based on their
pre-clearance positions. Crowded automatic strings stay near the
backbone; when overlap hiding is enabled, an unavailable nearby slot
hides only ordinary intermediate text and records
hidden_near_backbone instead of pushing the text far
towards the centre. Hidden axis records use an empty display string so
the renderer cannot print a literal NA; original values and
the hidden status remain in diagnostics.
Matched circular feature geometry and label owners now share one font-size measurement context before dependency layouts and obstacle collection. Adding independent primer layers no longer makes the same feature bands use different arrow widths or radial gaps. Multiple matching label layers retain their own text styles while the shared geometry uses their largest size. Automatic gutter estimates use a bounded share of the available inner radius. Axis clearance also reserves fixed feature-leader exits through the backbone; blocked automatic strings may use a bounded alternate lane.
Circular plasmid axis text uses a narrow measured channel next to
the backbone while explicit breaks and offsets keep their placement.
Stacked circular feature bands reserve space for labels that cannot fit
their arrows rather than keeping a large fixed gutter; inner label
tracks use compact physical clearances. Inner feature clusters try inner
slots before exterior fallback, which remains available when
external = TRUE.
geom_feature_label_repel(label_repeat = "bracket")
optionally shows one counted arc label and range bracket for consecutive
matching short features. Individual arrows and biological records remain
separate; visibility and fit diagnostics distinguish shared
representation from hidden labels. The default "individual"
style retains separate labels. Fixed feature label group IDs now survive
removal of hidden/shared children, preserving leader ownership instead
of dropping or misattaching those leaders.
Dense circular feature labels retain source-angle order rather than width-first placement. Candidate slots check both new leaders against existing glyphs and existing leaders against new glyphs, and reject crossing leaders without multi-bend detours. Compact repeated annotation clusters in outer feature bands can share the exterior queue when external labels are enabled; inner bands first try compact inner tracks. Final text-edge clipping now preserves the exterior queue’s already arranged simple leaders instead of reconnecting endpoints and undoing its order. Source rows and internal arc text remain unchanged.
Circular feature labels compare angular displacement with actual radial travel rather than forcing ordered neighbours onto the nearest shared track. Free inner tracks can keep long names closer to their own features. Circular restriction leaders also retain the perimeter queue’s direct or single-shoulder routes instead of searching multi-bend graph detours. Reference feature imports now retain named segment and translated flags from the original files. Segment boundaries are not independent features; their names remain available in the returned segment tables.
Closed circular features remain continuous across the genomic
origin, with arrowheads only at biological ends. Open/gapped views keep
their display split. Wrapped segment tables retain real gaps and
colours; only adjacent equally coloured runs join across the seam using
the source length. Compact arrows on gapped views retain heads only at
real ends. Feature labels measure the feature band’s circumference.
Internal arc glyphs must remain within their own feature; displaced
adjacent labels gain a short source attachment. Internal labels retain
curved track text. Feature-layout leaders now take direct routes instead
of multi-bend detours; glyph overlap still follows
label_segment_overlap. Leaders default to drawing below
data layers, with label_segment_layer = "above" restoring
their label layer’s order. Transparent fills keep their
transparency.
Progressive gallery ribbons use the default binned Identity scale again, with boundaries 0/50/80/90/95/100. Explicit continuous user scales remain supported; this corrects the example rather than changing scale defaults.
Label diagnostics include the closed capped_line
feature contours in their conservative polygon envelopes, including
transparent interiors. Own-source contacts remain separate. Stroke
thickness, path markers and occlusion remain outside this check; the
correction does not change annotation placement.
The progressive linear gallery examples share a measured 12 × 8 inch export canvas, with their original data, labels and guide settings. Gallery cards link separately to the related lesson and the shared plotting source.
Drawing now warns when bounded physical refinement does not
converge. Geometry measurements remain estimates, and
diagnose_ggchord() captures the warning alongside its
existing physical_layout check. The warning reports the
observed calibration failure; it does not establish that every possible
layout is infeasible.
Fixed ordinary label boxes and arc-glyph advances using PDF proxy metrics while a target graphics device was already active. Measured layout now uses that active device; headless measurement retains its fallback. Text spacing may shift slightly where old proxy widths disagreed with the renderer. Circular physical refinement may try one bounded scale extrapolation after two measured samples. It accepts that scale only after rebuilding and passing the existing measured convergence gate; a rejected trial leaves the ordinary sequence intact. Non-circular views share the same bounded ordinary budget, fixing profiles that needed another measured rebuild after the former short cap. Calibration remains separate from other layout constraints.
Fixed circular axis clearance accidentally treating center labels as backbone geometry through partial list-name matching. Diagnostics expose the actual clearance status and signed physical shift. Composite restriction-label rendering, route obstacles and perimeter packing share the target-device bold-name/plain-coordinate envelope and physical gap. Effective component theme styles enter layout before placement; axis placement precedes leader routing so rerouting cannot move its own text obstacles. Fixed leader roots also receive axis clearance, and collided internal callouts can detour around the resolved text. Batched route and perimeter crossing decisions preserve the existing strict-interior rules. Label-quality measurement reports physical convergence separately from panel measurement.
Fixed bounded scale/adaptive line
factors not reaching omitted fixed linewidth aesthetics in native
sequence, point-link, ribbon and alignment layers. Explicit and mapped
widths keep their own rules, identical layer types remain independent,
and fixed or plots without a policy keep their existing
styles. Diagnostics report the selected effective fixed widths.
Fixed crossed circular exterior callout leaders on cramped canvases by routing collided paths around measured text and other leaders. Real directed endpoints, label positions and source records stay unchanged; unresolved cases remain reported. Automatic combined seam text can try a bounded outer backbone lane when the inner channel cannot fit it. Explicit offsets remain fixed.
Fixed automatically positioned circular coordinate labels touching feature polygons. Only collided parallel strings with automatic breaks and text offsets receive bounded radial clearance; tick coordinates, source values, explicit breaks and explicit offsets stay fixed. The search also protects other text and retains unresolved cases for review.
Fixed default Sankey sequence names overlapping their starting coordinate labels after projection. Explicit justification remains unchanged. Circular axis glyphs now retain string identity in diagnostics, avoiding false reports of collisions between letters belonging to the same coordinate label.
Fixed empty native axis/title cells being treated as Fusion route obstacles. Zero-area furniture no longer creates false collisions or blocks otherwise feasible interval ribbons. Positive-area decorations remain protected.
Fixed circular exterior annotation leaders passing through origin-axis or inner feature text. Collided paths now receive bounded static-text detours while keeping their real root and final label attachment; unresolved routes remain reported. Removed unused zero-length leader placeholders, which could produce misleading contacts or accidental cap marks. Scientific inputs, label contents and uncollided paths remain unchanged.
Added measured label_quality evidence to
diagnose_ggchord(): registered text-object contacts,
annotation-leader crossings/through-text contacts, canvas bounds and
physical leader lengths. Registered feature polygon contacts distinguish
own-source placement, other-source contacts and unresolved associations;
skipped non-polygon parts remain explicit. Text measurement now follows
native justification, size units and component styles, including hidden
Track axes, without changing the plot.
Extended geom_track() with native source-space
smooth, density and ecdf
statistics. Model outputs retain estimation-group source rows rather
than becoming independent observations; ECDF requires finite
pad = FALSE. Track transforms map the resulting values
without silently refitting a model in transformed space. Fixed
line/path/step geometry to follow mapped y when separate ymin/ymax
fields are present, allowing a mean line over a CI ribbon.
Documented an optional BAM coverage workflow through GenomicAlignments and existing Track inputs, with explicit flag/deletion/reference-skip semantics. A source-backed Drosophila example and a clearly identified no-reference CRAM format round trip verify coordinate/value preservation without a new reader.
Added read_feature_relations() for offline feature
pairs and named/unnamed memberships. Exact unique feature IDs can map
supplied contiguous intervals; original scores, physical lines and
group/member order remain traceable. Memberships never create pair
links. Annotation strand does not imply an alignment direction, and
source lengths, Identity or support are not inferred. Pinned plant
examples include original permission, hashes and subset rules.
Added read_signature_matches() for existing AA
signature TSV and cached InterPro/Pfam entry JSON, retaining full source
lengths, accession case, repeated model matches and native score types.
JSON locations reuse Feature segments without filling gaps or splitting
one match into observations. Missing feature-instance IDs remain
missing; member-library scores are not converted into a common
confidence. Cached source examples include CC0 attribution, hashes and
explicit TSV re-encoding without a new analysis run.
Fixed explicit virtual-environment Python paths in
read_genbank(): resolving the executable symlink could
incorrectly select the system environment. Optional parser bridges now
share the same internal process/JSON/message boundary while retaining
their existing public signatures and decoders.
Added read_delta() to read existing NUCMER/PROMER
results through an optional user-selected show-coords executable,
without running an aligner. Native output is matched to original
directional source coordinates and full lengths before physical rows,
error fields and signed gap scripts are attached. Reported Identity
retains native precision; PROMER AA identity remains distinct from its
bp source coordinates. No aligned characters, BLAST column counts or
read support are invented.
Added optional Biopython bridges read_maf() and
read_chain() for existing genomic alignments. MAF retains
exact symbols, gaps and directional source positions per file/block;
chain retains separate aligned intervals across gaps without inventing
characters or Identity. Complete source text, full declared lengths,
coordinate matrices and decoder metadata stay traceable. Chain
query/target name collisions require explicit source-ID declarations; no
assembly identity is guessed or automatically renamed.
Added optional read_vcf() using VariantAnnotation,
with a pysam/HTSlib bridge for modern BCF and explicit
StructuralVariantAnnotation decoding. Original multiallelic records,
INFO, sample genotypes, IDs and headers stay traceable. Reference-allele
features and structural uncertainty intervals are distinct; missing
mates/support/Identity/full lengths are not invented. Reciprocal pairs
produce one link; unpaired and out-of-bounds evidence stays in the
report. No optional decoder is installed or run during
plotting.
Added read_bedgraph() and optional
read_bigwig() for quantitative signal intervals, preserving
source coordinates, values and import provenance. BigWig uses
rtracklayer on supported platforms (not Windows), retains the header
length dictionary, and clips to the explicit query union. Gaps remain
absent rather than zero; no observation counts, coverage or units are
inferred. Tiny real pUC19 GC signals include reproducible generation and
source hashes.
BED-family readers now preserve literal sequence IDs
track and browser, fixing data loss caused by
treating every such row as a display header.
Fixed false self-intersection errors for inward Tracks on closed circular backbones. The duplicated seam now shares a periodic tangent; genuinely folded bands still fail. This geometric correction does not infer biological circularity, alter source intervals or disable collision detection.
Fixed artificial ribbon breaks in ordinary child margins under explicit overlap. Composition connections traverse the complete child container, still honour later covering containers and draw below native foregrounds. Margins no longer act as undeclared masks; source fronts and observations remain unchanged. Same-device single-paint checks cover these margin regions.
Composition labs(title/subtitle/caption/tag) and
native plot Theme furniture now draw and reserve actual space, fixing
previously accepted but invisible settings. Backgrounds and margins use
native gtable measurement; child axes remain local. Exports retain the
outer content frame, labels and envelopes, including nested
compositions. Fixed boxes are rechecked after this budget; enlarge the
canvas or revise explicit margins if necessary.
Fixed inherited clipping in nested composition connections. The
internal grid viewport code for disabling clips had been used as
inheritance, allowing translucent connections to repaint across disjoint
overlap clips. Native clip = "inherit" now preserves the
ancestor region; same-device single-paint calibration verifies both
decorated and nested paths without fixing raw RGB values across
colour-managed devices.
fusion_panel(side = "auto") places any number of
panels that fit a bounded clockwise perimeter search in the measured
composition area. Explicit boxes, named/angle allocations and supplied
sizes stay fixed. Only unlocked default containers adapt; placement does
not shrink fonts, rotate children or drop panels. Impossible packing
fails explicitly. Exports record physical angles, container adaptation
and the placement strategy. Magnification lists can repeat named
"auto" sides while retaining explicit detail-panel
selections.
Fusion accepts native cross-panel Guides at different outside positions. Adaptive compositions jointly measure Guide candidates and panel allocations, preserving explicit positions, direction, grid, fonts and absolute boxes. Default Identity rulers remeasure label spacing when changing orientation. Fixed mode keeps existing placements; impossible constraints fail explicitly. Metadata includes final per-side Guide sizes/bounds and candidate/lock reports.
Explicit theme(legend.position = "none") is
respected by the joint Guide engine, including composition carriers,
rather than being treated as an unmeasurable visible Guide.
Fusion ribbons support explicit measured obstacle routes and
shared display corridors (route = "avoid" /
"bundle"). Original source rows, complete interval fronts
and physical departure normals remain intact. Bundling uses explicit
route_group values and never aggregates scientific
observations.
Magnification can route decorative leaders around the same
measured obstacles. Exports include route statuses, collisions, obstacle
envelopes, shared corridor membership and decorative
leader_paths. Native font/guide metrics are rebuilt at
target size; impossible routes and obstructing ancestor overlays fail
explicitly. Default direct drawing is unchanged and reports
collisions.
Aligned-character adapters accept an explicit
circular = TRUE declaration, using a declared full source
length or full source string. Forward/reverse positions wrap without
revisiting a source position; gaps and verification remain exact.
Default linear adaptation is unchanged.
Magnification accepts explicit region$wrap = TRUE
for origin-crossing selections. Matching full source lengths and the
same exact source/detail instances are required. Exports preserve the
original row and distinguish the two drawn pieces; the source seam does
not gain extra boundary leaders.
Registered sequence-axis spacing/orientation settings for
standard theme() configuration. Existing
theme_ggchord() shortcuts remain compatible and use the
same settings; supplying both spellings in one call fails
explicitly.
Track numerical axes now use global
ggchord.track.axis.line/text/title elements and physical
text/title offsets. Font metrics used to reserve plot space follow their
resolved styles. This fixes hard-coded axis colours/fonts, including
unreadable non-data decoration under the Dark preset.
A track’s value scale accepts native
guide_axis(theme = ...) for local axis line/text/title
styling, angle and overlap checks. Other options fail explicitly.
Same-ID overlays still share a band/domain/axis; different IDs retain
independent numerical and colour scales. Theme changes do not alter data
or statistics.
Fusion registers Sankey/Radial backbone frames and supports eight named sides, physical placement angles, absolute/relative boxes and nested compositions. Magnification accepts explicit source/detail boxes and full nested leaf paths. Containers are never treated as genomic coordinate domains. Ambiguous mirrored instances still require explicit selection.
Explicit overlap is opt-in; later panels cover earlier panels through disjoint native grid clips, preserving translucent connection appearance. Every target size is remeasured. Exports retain requested/resolved placement, per-composition original focus tables, covering order and explicit evidence/display counts. Repeated source HSP IDs across nesting require opt-in on all participating layers.
register_ggchord_alignment() for explicit
source/column registration of independent Cartesian
geom_residue() plots. Fusion and
magnify_ggchord() accept these detail panels, remeasure
them at target size, and check registered cells against the actual
rendered positions/labels after edits. Exact endpoint cells retain
reverse orientation, gaps and source units; no HSP interpolation
supplies base-level evidence. Spliced/origin regions must be split
explicitly.translate_ggchord_cds() using optional
Biostrings, the existing spliced CDS map and complete forward DNA/RNA
strings. Known genetic codes and explicit literal/start initiation and
ambiguous-codon policies govern translation. Stops remain visible;
partial trimming, genomic strands and the three source
positions/rows/segments of each codon are retained, including exon
junctions. Missing sources/codes and unsupported translation exceptions
fail explicitly.magnify_ggchord() accepts a named list of up to four
independent Collinear detail plots. Each region selects its target
through detail_panel; named side and optional
named detail_size settings define the allocations.
Single-plot calls retain their existing defaults.adapt_ggchord() policies:
fixed retains reference physical theme/guide sizes,
scale bounds default theme text, line and spacing changes,
and adaptive also selects a joint arrangement of native
guides using actual device measurements. Plots without a policy retain
their existing behaviour.ggsave(), preview and diagnostics share
the policy path; Fusion applies it within each opted-in panel before
rebuilding endpoints. diagnose_ggchord() reports effective
styles, locks, chosen guide grids and physical bounds. Layout-only
exports identify the policy and the need for a target device. Outer
Fusion allocations, facets, arbitrary grobs and a new global label
solver are outside this contract. No existing API is removed.magnify_ggchord() now accepts multiple source intervals
in one explicit detail panel. Each row resolves its own source/detail
instance; derived region, front and leader tables use
region_row to refer to input rows. Original selection
metadata remains unchanged in focus_region_data.group by
discrete styles. Explicit grouping now takes priority, matching native
ggplot2 statistics. Bin source_rows now uses native bin
membership, retaining outer-boundary observations and numerical edge
tolerance through padding, dropping and data positions; computed count
values are unchanged by this provenance fix.source_hsp_id duplicate checks. Backbone views now check
observations actually retained after selection; explicitly repeated
observations require allow_repeated = TRUE on every
participating layer. Filtered observations do not trigger duplicates.
Instance routing exports also mark whether each route was retained.magnify_ggchord() partially matching ordinary
metadata columns such as instance_note to optional instance
selectors. Only exact instance and
detail_instance fields select copies; ambiguous selections
still fail.Added magnify_ggchord() for an explicit source
interval and an independently built Collinear detail plot, using a
Circular/Chord source and the shared Fusion renderer. Target-size
highlights and decorative boundary leaders follow real source windows,
display instances and native position scales.
Fusion exports now separate focus_regions, focus_fronts and leaders from biological connections/relationship_data. Detail data/statistics remain explicit; there is no automatic layer copying, origin wrapping, character panel registration or nested-inset inference.
Fixed the shared circular perimeter layout overriding an explicit
geom_restriction_site(leader = "straight") request with a
one-bend route. Explicit direct routes now remain direct after label
placement; default radial and explicit elbow routing retain their
existing semantics.
Added missing namespace imports and nonstandard-evaluation declarations reported by the main-branch CI. No package-wide check is claimed for this local development fix.
as_ggchord_alignment() and
read_aligned_fasta() for existing DNA/RNA/AA aligned
characters. They preserve gap columns, case and provenance, with exact
nullable source positions and explicitly declared origins/strands.
Optional full forward strings verify the supplied source coordinates and
characters, including negative-strand nucleotide complementation.map_alignment_position() for exact source/column
lookup in a selected alignment row or filtered window. Gaps and
unavailable positions remain distinct; no interpolation or missing
alignment evidence is manufactured.geom_residue() for local character cells in
ordinary Cartesian ggplots. Actual glyph and cell dimensions are
measured at drawing time; insufficient space uses explicit tile/error
policies rather than shrinking fonts. Standard mapping, styles and user
scales remain independent.read_fasta_lengths(keep_sequence = TRUE) optionally
retains actual FASTA characters and case alongside lengths and
provenance. It does not infer an alphabet or alignment. The default
length-only output is unchanged.
Fixed focus_ggchord_data() retaining full sequence
strings after shortening a locus. Optional sequence strings
now follow the same crop, including repeated focusing, with length and
integer-boundary validation. Character order is preserved; focusing does
not imply reverse complementation.
Added read_bedpe() as the first Semantic Enrichment
adapter. It reads paired zero-based intervals into canonical q/s
endpoints, preserves anchor order, raw fields, arbitrary score strings,
extra fields and file provenance, and follows paired-object
negative-strand conventions. No identity, alignment length or read
support is inferred. Incomplete anchors fail by default;
unmapped = "keep" retains them explicitly for auditing
before filtering.
Fixed vertical and radial projection failing on missing text angles retained in layered feature layouts. Unknown angles stay missing while finite angles retain readable orientation.
ggchord_fusion(), fusion_panel() and
fusion_ribbon() for static compositions with a
Circular/Chord center and up to four horizontal/vertical Collinear
panels. Cross-panel ribbons use real ordered interval fronts, one-based
inclusive boundaries and explicit panel/instance routing.export_ggchord_fusion() with source
relationships, namespaced instances, measured panel rectangles,
local/global fronts, paths and diagnostics in mm. Standard
ggsave() and view_ggchord() rebuild on the
actual target device. Endpoint projection respects native position-scale
transforms before Coord.coord_dotplot() and
geom_alignment_segment() for HSP-level views of existing
seq_data and ribbon_data, without a backbone
layer. Both axes have independent sequence selections, order and display
orientation; offsets, gaps, separators and native bp/aa units preserve
all four endpoints.axis_layout and a connection report for axis-selection and
unknown-direction omissions.
map_ggchord_position(..., axis = "x"/"y") supports both
directions and focused source origins; inverse positions in display gaps
return NA.link_* mappings and scales,
including the six default Identity ticks. Explicit scales and native
axis themes take priority. Unknown direction is omitted with a warning;
contradictory direction and endpoint metadata is rejected. Repeated
declared HSP IDs require explicit allow_repeated = TRUE;
unidentified duplicate/self rows remain distinct.coord_radial_synteny() with proportional outward
spokes and cyclic adjacency, including observed last-to-first HSPs. A
two-spoke layout retains each source HSP once; one spoke is rejected.
Named instances and between reuse the existing explicit
routing and repeated-source authorization.radial_frames, full
radial_endpoints and native direction/unit metadata. Radial
inverse mapping accepts an x/y table on the selected backbone,
preserving focused source origins and instance identity.Added ggchord(feature_data = ...) as the unified
annotation input and matching validation support. Generic feature layers
inherit all annotations; gene layers select explicitly classified
gene/CDS records. Unknown and bidirectional strands remain available to
generic layers. Explicit layer data takes priority; use disjoint subsets
when combining gene and feature layers.
Retained gene_data, including its third positional
argument and untyped directional tables, with one migration message at
construction. Rendering does not repeat this message. No removal version
is scheduled. Providing both non-NULL annotation inputs is an
error.
Layout exports now include constructor
source_registry, annotation layer_sources, and
annotation_duplicates sidecars. Existing geometry
source_row retains its layer-input meaning. Explicit layer
data/functions have layer-local identity; source equality is not guessed
from values.
Inherited catalogue features retain their supplied annotation colours, just like explicit feature-layer data. User mappings and scales remain authoritative.
Fixed user metadata named source_row overwriting
computed geometry identity. The original metadata remains available in
exported resolved inputs.
Added source-local geom_track() with fourteen
geometries, identity/count/bin/ summary statistics and native data
positions. Physical bands use track; the legacy
position = position_track() spelling remains accepted.
bar now counts observations; replace previous numerical
bars with geom_track_col().
Added named/repeated display instances, explicit
between routes and HSP identity reports for
Chord/Collinear. Statistical observations are computed before display
replication. Ambiguous routes fail instead of duplicating HSPs.
Added vertical Collinear and mirrored two-column
coord_sankey(). Sankey retains reciprocal input rows,
filters same-entity links by default and reports
query-left/subject-right instances. Shared branches are not supported in
this first mirrored layout.
Added opt-in length_mode = "equal", with original
lengths and projection factors in exports; a misleading shared absolute
scale bar is rejected.
Default sequence ticks now retain positions 1 and length and adapt intermediate positions to physical space. Scientific endpoints take precedence over nearby rounded intermediate labels during overlap pruning. Circular seams combine the endpoint label. Flagship examples now use this one-based default instead of overriding it with zero-based tick vectors.
Default ribbons retain Identity fills. Opt into endpoint
sequence-colour interpolation with gradient = TRUE, or an
optional subject taper. Explicit fill/mapping/scales take priority;
tip = "none" keeps full ribbon fronts. Explicit pident uses
a fixed 0–100 domain and unequal 0/50/80/90/95/100 colour intervals and
guide lengths. Other automatically managed numeric pident mappings share
the same domain and six ticks; explicitly supplied scales retain
priority.
Unified Feature input is also accepted by prepare, clean, focus and segment workflows. Existing positional gene inputs are retained.
Fixed generic legend key sizes collapsing the full Identity ruler: automatic guides measure boundary labels and reserve enough physical length. Explicit per-role guide sizes remain authoritative.
Circular parallel axis labels now follow the arc character by character; horizontal/numeric orientations and linear layouts retain straight text.
Restored compact, layered origin fans where measured side-word widths and canvas space permit. Tight canvases retain measured perimeter queues instead of forcing the wide fan to collapse. Long enzyme names wrap where necessary; spacious canvases retain their original single-line labels.
Circular outer labels now share one measured perimeter queue at every count; the former 30-label/primer switch is removed.
Completed the bilingual tutorial audit with focused circular backbone, label, primer, restriction-site, scale, ribbon-statistic and workflow lessons. Task and API indexes link all 130 exports and 1,474 formal parameters to current contracts and teaching evidence. Integrated cases explain provenance, selection, export dimensions and inference limits; the plasmid catalogue remains optional reference material.
Documented actual stable/development version differences and layer/coordinate compatibility, and reran the teaching examples and documentation PNGs.
Fixed the default continuous point-link colour bar so it accepts
the dedicated link_colour aesthetic. Explicit user guide
settings remain authoritative.
Fixed rendering of geom_seq(seq_style = "band") by
removing an unsupported argument forwarded to the polygon
renderer.
Expanded bilingual parameter lessons with source-backed gene arrow outlines, explicitly illustrative shared-endpoint branches, curved versus straight point links, and GC tile band-width comparisons. README acknowledgements describe the open-source projects and public tools that informed the design.
Added bilingual lessons on collinear alignment, anchors and display orientation, a real GC tile-track example, task-based parameter lookup and coordinate compatibility guidance. Installation instructions distinguish the local development tutorial from the CRAN 0.16.6 documentation.
coord_circular() keeps rotation = 0
with the sequence origin at 12 o’clock and coordinates increasing
clockwise. Rotation is counterclockwise from this circular baseline; use
rotation = -90 for a 3-o’clock origin. To preserve an
explicit angle from v0.16.6, subtract 90 degrees. The current
development default appearance and the chord rotation contract are
unchanged.
Circular axis ticks are longer and heavier by default, including the plasmid preset. Tick roots remain attached to the same axis baseline; explicit lengths and line styles retain priority.
The collinear showcase uses the same default Identity scale as the chord showcase. Wide teaching data-frame outputs no longer split into column groups.
geom_link_ribbon(nonadjacent_linewidth = 0.4)
controls the outline width of non-adjacent collinear rows independently
of linewidth. Zero uses the layer’s ordinary width for all
ribbons. Explicit linewidth mappings retain control of the mapped
widths.
Added four complete source-backed protein records and six observed unordered BLASTp comparisons as bundled teaching tables.
The default chord rotation is 0 degrees. Set
coord_chord(rotation = 45) to request a 45-degree
display.
Native protein plots accept sequence_unit = "aa"
with complete protein lengths, BLASTp links and generic interval
features. Layout exports, centre length labels and scale bars retain the
sequence unit. Mixed bp/aa native plots and nucleotide-only layers on
proteins are rejected.
read_fasta_lengths(sequence_unit = "aa") explicitly
declares protein lengths. Omitting the argument retains its existing
output columns.
Circular ticks share their axis baseline and point away from the backbone. The default circular axis and plasmid theme attach ticks to the inner backbone edge. Explicit signed gaps move the complete axis together.
Explicit aes(ribbon_fill = pident) retains the
default Identity scale and guide, matching the implicit mapping. User
scales take precedence.
Dense axes retain regularly spaced labels when possible, and ticks are longer by default. Gene arrows use the chord showcase’s red and blue for forward and reverse strands, including when input annotations carry their own feature colours. Explicit axis and fill settings take precedence.
Non-adjacent collinear ribbons have a heavier default dashed
outline. Set nonadjacent_linewidth = 0 to inherit the
ordinary fixed width; explicit linewidth mappings retain
control.
Single-line circular backbones retain axis ticks and labels without a second concentric baseline.
Axis labels now hide overlaps by default, while retaining tick
geometry. Circular ticks and text respect the physical gap inside the
backbone. Set
theme_ggchord(axis.text.check.overlap = FALSE) to keep all
labels.
Automatic strand legends for gene arrows include both strand directions, including plots whose gene layer only observes one strand.
The default collinear scale bar has no horizontal inset, aligning
with the left sequence envelope and the zero tick on left-aligned
forward rows. Use offset = grid::unit(c(2, 6), "mm") to
retain the previous inset.
Added independent bilingual first lessons for chord, collinear and circular views with bundled records. The site separates courses, data import, plotting techniques, advanced workflows and complete cases. The offline tutorials cover installation and first plots.
The four-genome chord showcase samples CDS separately by sequence and source strand without a length cutoff. The plot retains the original annotation coordinates and strand placement.
Embed the introductory vignette figures so they load when CRAN serves the HTML separately from the package files.
Post-release CRAN preparation reduces offline tutorial image duplication, fixes installed image links and a long help-example line, and uses smaller real inputs in slow help examples. Public plotting behaviour is unchanged.
Added progressive chord, collinear and plasmid learning paths, beginning with table schemas and import, then building independent layers before the full showcases. All 13 unique bundled plasmid references have current feature maps.
Gene legends retain arrow glyphs when the gene shortcut replaces the generic feature geom. Explicit legend title/text sizes in a plot theme now reach the automatically generated guides instead of falling back to compact defaults.
Collinear repel labels try nearby horizontal placements when vertical leaders are blocked by earlier labels, retaining the existing collision checks. Labels can still be hidden when no permitted placement is found.
Replaced README and website entry figures with three complete,
reproducible showcases: mixed-curvature four-genome chord comparison,
dense pETDuet-1 annotation and four-genome collinearity with centred
rows, routed cross-row links and strand-separated CDS. Website figures
now share explicit, coordinated scientific colours and a common 0–100%
identity scale. Documentation panels are transparent over a uniform
#FFFCF5 plot background.
Reorganized documentation around chord, collinear and plasmid tasks. Added a Home link, larger navigation, a visible language dropdown, a left page outline and right site guide, with separate compact-screen disclosures.
Corrected untranslated Han reference-index categories and language-dependent dropdown anchors. Expanded current examples with purrr and tidyr as optional documentation dependencies; package runtime imports are unchanged.
Optional-column checks in validation and focusing now accept tibble inputs without spurious missing-column warnings. Required-column validation and data results are unchanged.
Current website, README, tutorials, help examples and teaching
scripts now prefer dplyr verbs and the native |> pipe
for table preparation, with explicit optional example dependencies.
Removed unrelated preparation from specialist help examples and a
duplicated coordinate scale from a documentation plot; biological record
values and selections are retained.
The standalone GFF3 conversion example now uses explicit package imports, anchored file matching and product extraction that also accepts a final attribute without a trailing semicolon. Original inputs are not rewritten.
Refreshed the curated documentation spelling wordlist and added
an explicit tools/check-spelling.R review command. It does
not add a package test or automatic CI step; remaining candidates still
require contextual review.
Fixed circular primer callouts with side = "inside"
being moved outside by the shared exterior allocator. Inner labels now
retain their existing layout and register their actual inner boxes. The
outside default, public signatures and sparse mixed exterior root
ordering are retained.
Corrected inside restriction-label registry rows being marked as exterior resources. Their existing inner geometry is retained and their measured boxes now carry the inner side, without acquiring exterior slots.
Completed current-source RC contract coverage and documented retained flexible parameter forms, support evidence and finite visual/build benchmarks. No new deprecation or migration is introduced. Explicit inside callouts can still be crowded across feature layers; the audit does not certify global zero overlap.
Sparse circular maps containing primers and restriction labels now use the shared root-ordered exterior allocator, preventing mixed-class leader crossings even below the former 30-site density threshold. The documentation plasmid workflow uses its dedicated theme and default feature fitting.
Restored the roxygen export declaration for
geom_feature_label_repel(), corrected the CDS
link-projection example to use feature IDs, and completed argument
documentation for the selected ggplot2 re-exports.
Includes cumulative implementation and migration changes from the unreleased 0.16.0–0.16.4 development phases listed below.
Enlarged the home-page artwork to 320 px on desktop and 220 px on mobile, and README/tutorial entry artwork to 200 px, retaining the lossless source.
Reorganized the documentation around first-use learning, complete workflows, task guides and reference lookup. The first-plot lesson now covers installation, minimal tables, interpretation and saving. Task pages prepare their own objects; desktop chapter navigation and compact page outlines support long articles. Redesigned the reading grid, typography, contrast and plot gallery.
Reworked plot selection and encoding: local source-coordinate CDS comparisons, distinct sequence/feature categories, reported identity gradients, wider GC tracks and larger annotation text. Documented the evidence behind each choice.
Added complete Han website reference prose for all current Rd topics, bound to canonical source hashes; stale or missing translations prevent site generation. Code, signatures and original identifiers remain unchanged.
Reworked documentation examples around bundled or attributed real records, explicit minimum input columns, standard BLAST 12-column tables, PAF and BLASTp CDS projection. GC comes from actual DNA and homology membership from checked coding-sequence identity. Native amino-acid axes remain a separate proposal; existing readers/adapters and flexible parameter forms are retained.
Added three full home-page plot types, larger documentation exports, explicit semantic categorical and continuous example palettes and an accessible image viewer with actual-size mode. These styles are declared in examples rather than changing package defaults.
Four-column gene tables now retain the default strand fill
mapping and honour user gene scales without an optional
anno column. Annotation absence no longer drops the mapping
and paints genes with a fallback colour.
Empty primer search results now compose with primer geometry and label layers without failing on scalar assignment to a zero-row table. Nonempty styles and public signatures are unchanged.
Updated the package title and entry documentation to cover chord, single circular sequence and collinear views. Rewrote paired English/Han README and tutorial sources around the 0.16.4 candidate API, with shared runnable code, terminology, migration, FAQ and a reproducible gallery.
Rebuilt the documentation website on native pkgdown / Bootstrap 5 templates, with paired English/Han navigation, same-page language switching (including anchors and mobile), complete Rd reference, local full-text search, code disclosure, executable-text copy controls and light/dark themes. Expanded real-record and pUC19 workflows, formats/adapters, links/statistics, feature stacking, labels, multiple tracks, projection/homology, scales/guides and result consumption. Source CI and a manual preview/deployment workflow keep generated output separate from main. Website cutover uses GitHub Pages Actions after explicit deployment authorization.
Documentation figures now share explicit ggsave dimensions and an asset/hash manifest across languages. Retired unreferenced source figures were removed after checking references; frozen website assets remain intact.
Added the user-designed ggchord artwork to the home page, README and tutorial entry points, with full-resolution lossless PNG/WebP and an explicitly resized navigation thumbnail. No redraw, palette reduction or loss of RGBA pixels.
Enabled Markdown parsing for existing roxygen comments so code names and help links render correctly in Rd. Public signatures, supported defaults, geometry and return fields remain unchanged from the candidate baseline.
Consolidated the existing 130 exports into a candidate API
baseline with current defaults, reviewed units/NULL/NA semantics,
coordinate support, result contracts and migration records. Added
ggchord_api_contract help. Existing public signatures,
spelling aliases, reexports and documented return fields are retained.
This is not v1.0.0 or release validation.
Automatic gene/feature label layers now reject manual
label_rotation, radial/circumferential offsets, orientation
and overlap controls that were previously accepted through
... and ignored. Use the corresponding
geom_gene_label() or geom_feature_label()
layer for manual placement, or label_layout for automatic
geometry. Supported formals and defaults are unchanged.
Migration errors for old gene_label_* names now
identify the correct gene/feature fixed-label layer. The old
"aligned" request points directly to
label_layout = "auto"; unknown legacy prefixes no longer
suggest nonexistent replacement arguments.
Added the ggchord_layout_contract help topic
describing retained output fields, units, provenance, measurement status
and cache ownership. Prefer export_ggchord_layout() for
layer-aware tables; the complete-layout getter remains supported with
its documented members.
Missing feature-label text no longer triggers empty-box collision warnings; visible geometry and label placement are unchanged.
Layout stages now declare their inputs and results explicitly instead of evaluating quoted stages in a shared function frame. Representative public geometry remains unchanged, including historical coordinate anchor rules.
Fixed an order-dependent empty export after building a plot. Layer IDs are now assigned consistently on build-local copies, including repeated use of the same layer object. Rendering no longer writes derived IDs, restriction offsets or circular styles into source layer objects or trains source scales.
Static previews now render a private plot copy, preserving the original layout cache. Cached layout estimates are invalidated on device/context changes for ordinary labels as well as physical tracks.
ggchord_data_contract help topic
covering reading, adaptation, validation, explicit cleaning,
preparation, coordinate projection and search limitations. Existing
public function names and cleaning defaults are retained..length_estimated, with source
lengths/identities in report list-columns. Pair IDs always remain
grouping keys, and default merging retains crossing block orders
separately. Envelope spans and weighted identities are display
summaries, not newly computed alignment statistics.file and files, read each normalized path once
in first-occurrence order, and reject malformed paths. Text input is
explicitly UTF-8; invalid encoding and inconsistent tabular field counts
fail clearly. BLAST/GFF3 preserve literal identifiers such as
001 and NA; BLAST/GFF3/FASTA now retain
physical .source_line. GenBank parsing opens UTF-8 files
explicitly in the selected optional parser.shape, and both
gene/feature widths use width. Removed fixed
feature_shape, feature_width and
gene_width arguments now report their replacements. The
mapped aesthetic remains aes(feature_shape = ...).label_* names; ribbon endpoint settings use
link_gap and link_ctrl_point, matching point
links. Old names report migration errors in this version.gene_offset and feature_offset;
use position = position_strand(offset = ...). The former
v1.0.0 removal date is superseded. Explicit strand-named Position
offsets are signed; negate the old minus-strand magnitude when migrating
that format.geom_gene() is now a directed-arrow shortcut over the
feature constructor, retaining strict known strands, its independent
gene_fill role and default appearance. Gene and feature
labels share internal constructors....; all five presets retain
their defaults.stage()
expressions and namespaced
after_stat()/after_scale() calls. Fixed visual
styles bypass unused mappings during input checks and automatic scale
inference.leader = "straight" now draws direct
connectors, and "elbow" draws one-bend connectors. These
explicit selections previously used the radial router. Default
"radial" geometry is unchanged; the redundant
"trunk" alias is removed with a migration error directing
users to "radial". Label slots and source rows are shared
by the three routing styles.colour/color now sets the backbone’s
seq_colour aesthetic.coord_chord(rotation = ...) documentation to
counterclockwise rotation from the positive x axis. Geometry and
defaults are unchanged.primer_id
with different sequences, instead of silently losing one sequence and
assigning its aliases to another binding. Multiple names for the same ID
and sequence remain valid.scale_ribbon_alpha_continuous() now uses ggplot2’s
default output range when range = NULL, instead of creating
an unusable palette. Explicit non-NULL ranges retain their existing
behavior.breaks = NULL and
minor_breaks = NULL remain empty instead of falling back to
automatic ticks. An axis with no ticks still retains its backbone
decoration.ribbon_ctrl_point = NULL: chord layouts
retain their historical origin control c(0, 0); collinear
layouts derive controls from endpoints. Ribbon geometry and defaults are
unchanged.geom_gene(aes(gene_fill = label), ...) can use a
source label column again. Computed coordinate, text and
style fields on the protection list still take precedence over matching
input columns.start/end columns through their numeric labels
instead of silently drawing factor level codes as genomic positions.
Existing numeric and numeric-text inputs retain their behavior; source
input objects are not modified.clean_ggchord_data() now rejects non-NULL
ribbon_data and gene_data that are not data
frames, rather than silently treating them as absent. Supply a data
frame/tibble, use the explicit adapters for supported interval objects,
or pass NULL when the optional table is intentionally
absent.unknown_id = "drop",
"error" or "keep" policy, just like other IDs
absent from the sequence reference. Reports retain original values and
row numbers. "keep" does not invent IDs or clean
coordinates without a reference length; sequence-reference IDs must
still be non-missing, non-empty and unique. Preparation adapters retain
their stricter inputs; clean malformed IDs explicitly before passing
tables to preparation.geom_feature_plasmid(shape = ...) now accepts the
documented concise shape alias when feature_shape is
omitted. Explicitly supplying both shape arguments still produces the
existing conflict error; defaults and user-supplied scales keep their
behavior.prepare_ggchord_data() for explicit conversion,
named feature/link collections and optional preparation steps. Defaults
preserve rows and coordinates; reports retain validation,
import/conversion provenance, stage reports and original ribbon source
rows. Optional genome membership stays metadata, with globally unique
contig IDs. Layout optimization returns a suggestion rather than
changing the plot. Preparation cleaning preserves directional endpoints
by default; explicit endpoint sorting conflicts with later
direction-dependent ribbon steps. Standalone cleaning defaults remain
unchanged. Nondirectional features use named feature tables rather than
the constructor’s directional gene table.read_bed() for BED3–12, including BED12 segments,
and read_paf() for PAF mappings. Both explicitly convert
zero-based half-open intervals to one-based inclusive coordinates and
retain original fields and file provenance. PAF identity is a ratio of
reported match/block counts, which may be approximate, and mapping
quality 255 is marked unavailable. Zero-width BED records and
unsupported BED extensions produce explicit errors instead of guessed
intervals.read_gff3() now retains decoded feature IDs and
multiple parent IDs, including repeated IDs for discontinuous features.
Use the new unstranded = "keep" with generic feature layers
to retain nondirectional records. The legacy default "plus"
is unchanged. All readers now retain file and per-file row counts in
import provenance, carried through adapters.find_ggchord_loci() to select explicit feature
IDs and extend their windows upstream/downstream according to strand. It
reports clipping and source rows, and composes with the existing
independent-window focus helper.validate_ggchord_hierarchy() for explicit
genome/contig primary and foreign keys, and
link_ggchord_clusters() for supplied cluster membership and
comparison pairs. Multicopy comparisons are omitted with a report by
default; explicit Cartesian expansion is bounded before allocation.
Homology anchors retain segments and source rows without inventing
alignment scores.build_ggchord_cds(),
project_ggchord_features() and
project_ggchord_links() for explicit spliced CDS maps,
bidirectional domain-coordinate projection and confirmed ungapped
protein links. Phase, strand, partial codons and declared segment order
govern projection. Genetic codes remain supplied metadata; no
translation or alignment is run. Disjoint domains retain their gaps on
round trips; projected protein statistics are source metadata rather
than nucleotide identity or alignment length.read_genbank() for local GenBank/GBFF records
through an explicitly selected Python environment with optional
Biopython and R jsonlite. Record IDs, joined locations, qualifiers,
uncertain boundaries and raw metadata are retained; unsupported
locations stop or remain explicitly unplaced. No environment is
installed or modified. as_ggchord_seq() also accepts
optional Biostrings sequence objects, requiring explicit IDs for unnamed
input and preserving nucleotide/amino-acid units rather than converting
widths.segment_ggchord_data() and explicit
coord_collinear(segments = ..., segment_gap = ...) for
separate windows on one display row and local reversals. Gaps have break
marks and no invented source coordinates. Interval links are split or
dropped at omitted regions, point links retain their sources, and
exported window transforms support reversible position mapping. Ribbon
adjacency follows display rows. Unsupported same-row connections produce
a selection report or actionable error. These settings are opt-in;
ordinary coordinate defaults retain their behavior.position_track()
and geom_track_tile(), geom_track_line() and
geom_track_bar(). Named tracks share numerical domains
across sequences, windows and layers; independent scoped
value/fill/colour scales preserve user scales and fixed styles.
Baselines, negative values, transforms, missing samples, clipping and
closed circular lines have explicit semantics. Bands use local normals
in all three coordinates and reject layouts that fold or collide with
other backbones or bands. Values are never implicitly averaged,
resampled or aggregated.focus_ggchord_track() for quantitative source
windows. It retains source lineage, trims intervals explicitly and never
invents edge samples or connects separate windows across omitted
regions. Exported track geometry, band registries and row diagnostics
retain domains and omission reasons.label_fit = "shrink" or
gene_label_fit = "shrink" with a minimum size. Full source
text, requested and final sizes and fallback reasons are exported.
Labels that cannot fit at the lower bound use the existing
external/hiding strategy. Default fitting and text sizes are
unchanged.scale_seq_position_continuous(sequences = ...) selects
sequence/window axes. Added geom_seq_scale() for an
independent shared bp reference in linear displays, including segmented
and reversed windows. Display gaps do not become genomic distances.
Track numerical axes remain separate from genomic position axes.diagnose_ggchord() for one target device
and canvas size. It reports panel measurements, canvas bounds, small
text/lines, guide sizes, existing layout diagnostics and optional
colour-vision hints. Unsupported evidence, including font
embedding/fallback and transparency in other applications, is explicitly
unchecked. Reports never certify all formats or change plot styles;
saving continues to use standard ggsave().clean_ggchord_data() dropping valid one-base
inclusive gene and ribbon intervals. Entirely out-of-range intervals are
still reported and dropped when clipping, while a retained one-base
overlap survives.sequence_unit values instead of labelling amino-acid or
generic character widths as bp. Sequence adapters still retain these
widths and units for preparation; protein features require an explicit
CDS projection before genomic plotting.Added coord_collinear() for horizontal
multi-sequence comparisons using the existing sequence, gene, feature,
region, ribbon and point-link layers. All sequences share one bp scale.
Sequence order, reversed orientation, role-specific visual scales and
focused input tables retain their meanings. Position offsets become
upward/downward distances; feature-stack lanes stay separate from
physical sequence rows. Axes and labels use linear strategies.
Gene/feature labels share obstacles across layers;
label_diagnostics records placement and hiding decisions.
Labels moved off a feature use readable dark text rather than retaining
a light internal contrast colour. Adding a linear label layer preserves
each gene/feature layer’s own Position and stacking. Omitted label
Positions share matching geometry lanes even when feature categories and
label text differ; explicit label Positions affect only label anchors.
Automatic feature labels retain the requested side, and newly displaced
leaders retain explicit line types.
In linear coordinates, geom_seq(seq_gap = ...) sets
consecutive backbone spacing as a proportion of the longest backbone
width (default 0.3). Explicit sequence radius, curvature, ring
mappings/scales and sequence-label radius now produce an actionable
conflict when combined with coord_collinear(). Remove those
circular settings before switching coordinates. Circular-only primer,
restriction-site and centre-label layers require
coord_circular(); generic linear annotations use
geom_feature() and its label layers. The circular
feature-label restriction external = FALSE also requires
removal or coord_circular() when switching to linear label
rows.
Linear ribbon and point-link endpoints face their destination
track and inspect feature obstacles on that side. Default controls come
from their endpoints; explicit controls use linear layout units.
Cross-track links may cross intervening backbones. Layout exports
identify the coordinate as "collinear" and include
sequence_layout with real backbone y, horizontal ranges,
orientation and units per bp, without circular radii or track IDs. See
examples/collinear.R for a runnable teaching
example.
Linear position scales now respect breaks = NULL,
minor_breaks = NULL and labels = NULL,
allowing ticks or their text to be explicitly hidden. Axes also render
correctly with all ticks or tick labels disabled, retaining the axis
line without evaluating absent component columns.
Private text measurement now uses a Unicode-capable graphics
backend for non-ASCII annotations such as lacZα, avoiding
conversion errors from single-byte base PDF encodings. Requests known to
contain only ASCII retain their existing measurement path. Preview title
and legend measurement also prefers the Unicode backend when available,
which may slightly change font metrics. Cleanup restores the caller’s
device after nested measurements and is safe to call more than
once.
Fixed two-line circular centre labels disappearing outside the plot on devices with a reversed native y axis, including SVG and some screen/PDF devices. The sequence name and length retain their intended order and spacing.
Plots derived from a shared base now own independent layout caches. Layout exports retain each plot’s ribbon rows without first rendering it, while adding a sibling plot preserves the base plot’s existing cached layout.
Added coordinate-owned display alignment:
coord_collinear(align = ...) supports left, centre and
right alignment, while anchor aligns explicitly selected
positions or intervals. orientation = "auto" uses
directional interval-link support, controlled by
min_support. It preserves sequence order and exports
support, conflicting evidence and unresolved cases; it is a display
heuristic rather than a biological strand inference. Explicit
geom_seq(seq_orientation = ...) conflicts with automatic
orientation. These settings compose with the usual +
grammar; no sync() step is needed.
Linear ribbons now connect adjacent displayed sequences by
default. geom_link_ribbon(adjacent_only = FALSE) retains
non-adjacent ribbons, and
pairs = data.frame(qaccver = ..., saccver = ...) selects
explicit unordered comparisons. The exported
connection_report identifies each retained or omitted
source row and its reason. Chord coordinates retain all comparisons by
default. Ribbon outlines are solid for adjacent displayed sequences and
dashed for non-adjacent sequences. Adjacency follows the final display
order; chord neighbours also include the first/last pair. Explicit fixed
styles and data mappings with their user scales retain precedence.
Ribbon line-type mappings also respect inherit.aes = TRUE,
including valid constant mappings, without changing an automatic or
differently mapped ribbon layer.
Fixed narrow linear channels whose default ribbon or point-link
endpoints could extend past the opposite backbone. Automatic baseline
gaps now fit the available channel; an impossible fixed gap or feature
clearance produces an actionable spacing error. Duplicate IDs in
seq_order are rejected while sequence subsets remain
supported.
focus_ggchord_data() now clips and relocates
composite feature segments, derived runs and cleavage-arrow positions
consistently, including repeated focus operations. Source coordinates
and truncated ends are retained for sequences, features and links.
Clipped alignment endpoints remain a linear display projection;
estimated lengths and retained source identity values are marked rather
than represented as a newly computed alignment.
Linear short arrows now compress their heads inside the true interval instead of applying the circular minimum display width. Truncated heads are suppressed at the cropped genomic end, and exports identify display bounds, deliberate symbol extensions and truncation. Circular arrow rendering keeps its existing geometry.
Added geom_seq_break() for cropped linear sequence
ends and
scale_seq_position_continuous(coordinates = "source") for
original genomic axis coordinates after focus.
map_ggchord_position() converts relative or source bp to
layout x/y, and layout x back to bp, for ordinary ggplot2 annotations.
Linear layout exports retain the corresponding reversible translation,
orientation, bp scale and source origin.
Linear label inheritance now matches unique
feature_id values, allowing filtered or reordered label
tables to retain their source feature’s lane. Conflicting IDs/intervals
are diagnosed; explicit label Positions remain independent. Multiple
matching entity layers require an explicit label Position or unambiguous
IDs. Labels that fit inside a feature are considered before wrapping
text for adjacent positions. Shared placement checks leaders against
other text, features, backbones and leaders, with unresolved routes
recorded as hidden labels in label_diagnostics rather than
drawn through occupied geometry.
Added as_ggchord_seq(),
as_ggchord_feature() and as_ggchord_link() for
ordinary tables and optional Bioconductor inputs, addressing GitHub
issue #2. Supported Seqinfo, GRanges and
GInteractions objects can also be supplied directly to the
appropriate constructor/layer input. Conversion retains metadata, source
rows and query/subject identities, uses known full sequence lengths, and
does not invent identity scores or biological direction for
unknown-strand intervals. Unknown strands use neutral feature geometry;
directed gene arrows require explicit known strand information. Optional
packages are loaded only for their supplied objects. Conversion
provenance is available in exported conversion_reports. See
examples/bioc-inputs.R.
| Previous intent | Explicit current form |
|---|---|
| Include non-adjacent linear ribbons | geom_link_ribbon(adjacent_only = FALSE) |
| Force solid outlines for every ribbon | geom_link_ribbon(linetype = "solid") |
| Force dashed outlines for every ribbon | geom_link_ribbon(linetype = "dashed") |
| Restore both former ribbon choices | geom_link_ribbon(adjacent_only = FALSE, linetype = "solid") |
| Display original genomic axis labels after focus | scale_seq_position_continuous(coordinates = "source") |
| Align or orient linear sequences | Add
coord_collinear(anchor = ..., align = "center", orientation = "auto");
remove explicit seq_orientation when using automatic
direction |
These are explicit defaults and new opt-in controls in v0.14.0; no legacy entry point is deprecated or scheduled for removal in that release.
The v0.13.0 development work continues in v0.13.1; v0.13.0 was not
published. The experimental global exterior-label solver was withdrawn
after view_ggchord() comparisons showed severe visual
regressions; the current sparse-map rendering keeps the v0.13.0
perimeter layout.
Fixed a rendering error when
geom_feature_label_repel() uses "callout",
"radial" or "auto" instead of the default
"feature" layout. The English and 汉语 vignettes now
explain how to select a Unicode-capable PDF device when labels contain
characters unsupported by the base device.
Automatic circular previews now adapt the physical backbone diameter to the printed width of displayed restriction labels, then solve labels again at that size. Measurement and output use the same physical coordinate scale. Dense exterior annotations enter their fan from one shared departure circle, preserving their real feature, primer and cut roots with a short radial segment. Ordered least-squares packing keeps congestion local; sparse upper left sites and compact lower right runs no longer span an entire side or bottom queue. Upper cut clusters follow their real angular gaps, with feature and primer labels joining the same interval. Two ordered fan arms replace an unnecessarily tall single staircase where possible. Layout padding now matches the final annotation registry instead of adding a second large row margin; complete glyph and leader constraints remain. Composite restriction metrics include the actual font family and line height. Primer name/range occupancy now matches the rendered horizontal composite. Displaced exterior feature labels with a missing leader participate in the shared layout with their own source data and styles. External feature callout colours retain more of their source hue instead of being uniformly washed out. The focused preview audit now checks the exact frozen layout and individual curved glyphs. Inner labels share measured local arc length on their nearest legal track; both new and existing leaders are checked against actual glyph envelopes and one another. Bounded retries give initially hidden tasks an earlier placement opportunity, first together and then at most five single-task alternatives; a result is accepted only when every previously visible label remains visible and additional labels fit all constraints. The same two-way line/text check now covers sparse outer callouts. Centre titles use their resolved component fonts and a physical reading gap, so shrinking the backbone no longer collapses the name and sequence-length lines.
Reproduced the reported pETDuet-1 rendering from the original
5,420 bp sequence, 54 displayed restriction cuts and five reference
primers. For crowded single-sequence circular maps, exterior
restriction, feature and primer labels now share measured local tangent
space. A crowded upper arc can place labels on several nearby rows while
checking complete text boxes, crossing leaders and leaders passing
through other labels. Longer composite enzyme names use a wider ordered
perimeter when the short fan has no clear placement. The solver measures
horizontal primer text and feature callout padding, preserves actual cut
and feature anchors, and uses a short radial shoulder when a callout
begins inside the backbone. Explicit inside-site layouts and
multi-sequence maps retain their previous layout path. Automatic
view_ggchord() sizing no longer jumps to a very wide canvas
solely because the input restriction table exceeds a row-count
threshold. Its circular panel scale was reduced modestly after full-size
reference comparison, while retaining default automatic sizing; the
preview also fills its export canvas with the plot background colour
when one is set. The plasmid theme retains its existing warm-white
background.
Added a CoordCircular-owned annotation registry as
the common final layout fact for circular maps. Position lanes are now
exported separately from globally unique physical inner tracks: track 0
records the visible sequence backbone, while variable-width feature
bands, curved-text tracks, inner leader corridors and the axis reserve
record their radius and radial boundaries. Restriction sites, external
feature labels and primer labels retain their own visual semantics in
one shared exterior registry. Sparse restriction labels keep horizontal
text on measured circular anchor tracks; their complete text boxes
participate in collision detection but are not forced inside Cartesian
top/right/bottom/left rails. Feature and primer callouts then use the
resolved restriction boxes as fixed obstacles and spill only to
consecutive local circular bands. export_ggchord_layout()
exposes annotation class, dominant/actual band, spill reason and
leader-crossing count together with the registry, and copies the
resolved inner-track or circular exterior-allocation fields onto
affected geometry rows. Adaptive plot bounds now include external
feature and primer callout text, so these labels remain visible after
the shared outer-track solver moves them. Primer callout leaders now
inherit the primer colour instead of the generic grey feature-leader
theme. Circular feature bands now size inter-arrow gutters from measured
label demand instead of widening every gap, and displaced inner labels
prefer the nearest valid track with a small local adjustment before
moving deeper. Labels from an outer feature band cannot use the next
feature band or any deeper text track; those gutters are widened
instead. Compact runs of repeated short features on the outermost band
now enter the external allocator as a complete cluster instead of
splitting between crowded inner labels and isolated outer callouts.
External feature and primer callouts are now placed across layers in
their real circular root order, independent of the order in which the
layers were added. When a dense mixed fan has no free exterior slot,
fallback now ranks the measured candidate positions by text overlap and
leader crossings instead of inadvertently keeping the final position
scanned. A wider circular candidate search can resolve nearby mixed
callout crossings without a Cartesian rail; an unresolved spill reason
is exported when no noncrossing placement exists. Registry joins now
guarantee scalar track identities even when a device-specific fallback
omits a local resource, fixing circular layout export failures on dense
short-feature maps. On sparse maps, restriction labels retain their
backbone roots and genomic order while feature and primer callouts use
the remaining measured exterior slots.
Added a reproducible bundled sequencing-primer catalogue
generated from the reviewed Addgene workbook: 137 distinct
oligonucleotides and all 163 source alias rows are retained separately.
primer_catalog() exposes either view, while
find_primer_bindings() searches each distinct sequence once
on both strands, reports circular-origin matches and uniqueness, and
preserves every biological alias. Exact matching is the default; longest
exact 3-prime annealing and the seven authoritative reference-plasmid
annotations are explicit modes. Reference .dna primer
coordinates are converted from zero-based storage to one-based inclusive
ranges. geom_primer() now draws an independent purple
directional arc between the two lines of a double backbone by default;
the new geom_primer_label_repel() draws unboxed purple
labels and leaders and can include the binding range. Its leader starts
at the directional arc’s arrow tip (the primer 3-prime end). The default
primer colour follows the visual reference (#A020F0).
Primers no longer consume an inner feature lane.
Increased the plasmid feature-label size and darkened its
internal leaders so feature names remain legible beside restriction-site
annotations. Labels placed on a feature and labels moved to an inner
track both follow their selected radius glyph by glyph. The nearest
inner track is tried first; deeper tracks are used only when the local
curved envelopes collide. Feature-leader line styling is now independent
of the mapped text colour, fixing leaders that were present in layout
data but rendered with an NA colour and therefore
disappeared from the image. All feature shapes now preserve one nominal
radial body width, including very short directional intervals; only the
along-sequence body and head lengths contract. The plasmid preset keeps
the regular band only slightly taller than its enlarged text. Long
arrows retain clear heads and shoulders; compact and promoter arrows
constrain their head dimensions so very short features keep a visible
stem instead of becoming chunky pentagons.
Added capped_line, an unfilled interval with short
terminal caps, for source records with line-only/noColor
display semantics such as introns. Directionality is now resolved before
shape-specific single-head fallbacks, so +/- promoters and
other directional features keep symmetric heads. Curved feature text
chooses its reading direction once per complete string, preventing
individual characters from flipping midway around a label.
find_restriction_sites() now accepts
methylation = "auto", "none", or
"dam_dcm" and returns methylation_status,
blocked_by, display_warning, and provenance
fields. Source-backed blocked sites are shown with a grey label/leader
and an appended asterisk; unknown contexts are not guessed. The pSB1C3
reference now reproduces the Dcm-blocked PflMI * state
without a plasmid-name rendering branch.
Refined the pBluescript II SK(+) circular-map layout against the
supplied visual reference. Restriction labels retain horizontal text on
close circular anchor tracks; dense local MCS labels are packed in
genomic order and only genuine bbox conflicts spill to adjacent outer
tracks, while the short upper-left group stays close to its natural
sites. Feature labels now exhaust internal feature gutters and deeper
label tracks before becoming external, with short leaders whenever an
intervening physical track separates a feature and its label. Compact,
promoter and primer arrows use the same annular-arrow factory and radial
body width as other directional features. Extremely short arrows are
widened symmetrically around their real midpoint for display, retaining
a body, shoulders and a head without changing their genomic start/end or
leader anchor. Contiguous source-segment joins again produce dotted
internal marks; cleavage coordinates at the same join are merged instead
of overdrawn. Short dotted/dashed segment boundaries are emitted as
explicit broken geometry so graphics devices cannot silently render them
solid. Plasmid axis ticks now start at the visible inner backbone
boundary and extend towards the centre. Parallel labels follow the
inner-ring tangent beside their tick, with the leading text edge
separated from the radial line instead of the string being centred
across it. Automatic plasmid steps now use the smallest
1/2/2.5/5 × 10^k interval producing at most ten major
ticks; the origin seam is not labelled twice. Major ticks and label
clearance are longer. Restriction-site ticks likewise begin at the
visible outer edge rather than the sequence centreline.
With no explicit dimensions, view_ggchord() keeps
the 12.39 by 9.71 inch canvas for coord_chord() and now
derives both dimensions for coord_circular() from its
measured annotation envelope while preserving a readable physical
backbone diameter. Explicit output dimensions still take priority, and
height = NULL retains one-dimensional content fitting.
Circular previews use the measured envelope rather than a count-derived
width jump.
Circular feature bands now use non-uniform radial spacing: the transition from the backbone-near band to the nested cluster reserves a two-line main text corridor, each deeper pair of feature bands reserves at least one label track, and the deepest band owns shared label-only tracks. Feature labels select a radius before deriving their position and tangent. The exported physical track index counts the backbone as track 0 and interleaves feature and text tracks by radius; labels crossing intervening tracks use a leader clipped to the curved glyph envelope.
Circular feature-track labels now use a genuinely curved baseline. After a track radius is selected, the renderer measures individual glyph advances, distributes the characters along that circle, and derives a separate local tangent angle for every character. Collision detection and leader clipping use the union of those same per-character envelopes rather than a straight whole-string box; this applies both inside a feature and on a neighbouring inner label track. The original row remains metadata and is not drawn.
Added coord_circular() as an independent coordinate
contract for one circular sequence. It supports a closed circle
(gap = 0), a degree-based opening, genomic-origin rotation,
clockwise/counterclockwise direction, position scales, label-aware
fitting, manual limits and clipping. Ribbon and link layers fail clearly
because they do not belong to this coordinate.
Breaking Position change. Before v0.13,
geom_gene() implicitly used strand-separated placement with
gene_offset = 0.1. Since v0.13, geom_gene()
defaults to position = "identity". To reproduce the former
default, use geom_gene(position = "strand"). For
plasmid-style shared-band placement, use
geom_gene(position = "plasmid").
Added position_strand() and
position_plasmid(). Signed offsets use the sequence-local
outward normal: position_strand(offset = 0.1) exactly
reproduces the former default (+ strand outside,
- strand inside), while named +/-
values are already signed and are not flipped again.
position_plasmid(offset = -0.1) puts both strands on the
same inner band and leaves arrow direction controlled by
strand.
Feature Positions accept the standard ggplot2 identity spellings
position = "identity",
position = position_identity(), and
position = PositionIdentity. The latter two ggplot2 objects
are re-exported for use after library(ggchord).
position_feature_stack() now accepts
base_position = "identity", "strand",
"plasmid", or the corresponding Position object. Its
no-argument preset uses wider 0.10-unit lanes for dense plasmid
annotations. Layout export now records position_name,
base_offset, lane, lane_offset,
and normal_offset for gene and feature polygons.
Explicit gene_offset and feature_offset
remain temporarily accepted, translate through the former flexible
accver/strand resolver, and emit a migration warning. Combining a legacy
offset with a non-identity Position is an error. Use
position = position_strand(offset = ...); removal of these
deprecated arguments is planned for v1.0.0.
Refactored geom_gene() into a gene-specific
convenience layer over the same neutral feature geometry pipeline as
geom_feature(shape = "arrow"). Circular splitting, local
tangent/normal calculations, arrow heads and short-feature fallback are
implemented once. Gene data roles, gene fill scales, strand guide and
key glyph remain independent public behavior.
geom_feature() and geom_gene() now
share arrow_head_length, arrow_head_width,
arrow_head_style = "shouldered" | "flush" | "triangle", and
short_feature = "auto" | "wedge" | "block". Features
crossing the circular origin retain one source identity and split into
drawable arc pieces without losing strand direction.
Added geom_feature_plasmid() as a compact
circular-map preset over the generic feature engine. Multi-segment
records remain one biological feature during stacking and labelling;
visible segment runs share one track and one label, preserve gaps and
per-segment colours, and draw arrowheads only at the biological feature
ends. Contiguous segment joins use dotted internal dividers, an explicit
non-solid line_style can override the join style, and
source cleavage arrows add or merge biological cut marks. Its default
position assigns overlapping intervals to generic collision slots:
explicit display_priority/prioritized_display
comes first, then the longest intervals are allocated first and each
subsequent interval takes the nearest collision-free lane.
Non-overlapping neighbours may share a lane, but continuity never
carries a cassette beyond its covering parent. Feature type, name, and
colour no longer choose a radial lane, and
find_common_features() no longer emits semantic
preferred_lane hints. The feature-shape vocabulary includes
compact_arrow, promoter_arrow,
primer_arrow, and marker. The three
directional arrow variants share one outline and width algorithm.
Default common-feature geometry now follows the feature’s own
nondirectional/forward/reverse/bidirectional value rather than its
biological type. Extremely short directional intervals retain a
restrained direction mark whose head and thickness contract with
available display length; zero-length point features draw a radial tick
rather than a minimum-width polygon. Small glyphs receive a lighter
outline unless linewidth is explicit. Lane collision checks use the true
rendered interval rather than a type-specific fabricated span. The
plasmid preset now uses the visual reference’s semantic feature colours
and type-aware default shape hints while retaining user scale and
explicit geometry priority. The minimum display span for very short
directional features is substantially smaller: a few-base feature now
appears as a compressed arrow with contracted head and thickness,
instead of being enlarged to roughly a full feature-band width. Short
bidirectional features likewise retain two compact heads rather than
falling back to a nondirectional block.
geom_seq() adds
seq_style = "single" | "double" | "band",
seq_backbone_gap, and seq_backbone_width for
circular backbones. Under coord_circular(), the implicit
chord-direction arrow and redundant one-sequence legend are omitted;
explicit arrow and show.legend values still
take priority.
Added geom_feature_label() and
geom_feature_label_repel(). They retain a feature-specific
public vocabulary while reusing the existing device-aware text
measurement, wrapping, ellipsis, collision, leader routing and frame
fitting engine. The default label_layout = "feature"
compares measured text width with usable feature arc length, uses
tangent text inside intervals that can contain it, and places
compact-feature text nearby. Nearby collisions are nudged
deterministically and only materially displaced labels receive a light
leader; explicit radial/auto/callout layouts remain available. The
feature mode now exports
feature_label_mode = "inside" | "adjacent" | "external",
measures the final font family, face, size and line height, and checks
oriented label boxes against other labels, rendered feature polygons,
the centre reserve and the circular backbone. It searches feature-band
gutters and deeper internal label tracks before unresolved labels become
horizontal external callouts; setting external = FALSE
hides them instead of pushing them indefinitely towards the centre.
Label-aware coordinate fitting includes their measured boxes. Feature
thickness responds to final label size within bounded limits, never to
unbounded label length. Inside text automatically uses black or white
from the final fill luminance unless its colour is explicitly supplied.
External feature labels use rounded pastel callouts derived from their
resolved fill. Dense short-feature clusters stop after their nearest
useful internal label track and use the external fallback instead of
consuming the centre. Restriction-site polar placement remains
independent and is never rewritten into shared Cartesian side rails by
the presence of a feature callout. A coordinate-owned exterior occupancy
pass now registers both layers’ final boxes and moves a colliding
feature callout to the nearest free radial or tangential slot without
changing either layer’s visual semantics.
Added find_restriction_sites() as a calculation-only
API. It preserves one row per pattern match, stable pattern identity,
multiple motifs per enzyme, overlapping/IUPAC/reverse-complement
matches, circular-origin matches, negative and out-of-motif cleavage
offsets, Type IIS, 1/2/4-cut records and unknown cleavage
(ncuts = 0). Custom motifs may be a data frame or named
character vector. Overlapping fixed anchors inside degenerate IUPAC
motifs are now enumerated without consumption, fixing missed sites such
as EcoO109I in pBluescript II SK(+). REBASE source motif casing is
retained for auditability and lower-case reverse-cleavage definitions
are oriented before calculating display positions.
Added filter_restriction_sites() for display subsets
(all, unique, unique_dual,
six_plus, unique_6plus,
commercial, and reference) and intersecting
enzyme, motif-length, site-count, window and commercial filters.
Filtering never rewrites biological coordinates. parent_set
additionally selects all enzymes, all commercial enzymes, or a stable
nonredundant commercial subset; equivalence groups and preferred
representatives come from the bundled REBASE embossre.equ
source. For the thirteen exact plasmid references,
set = "reference" reuses the enzyme-set name and any custom
enzyme list saved in the source .dna record. This fixes
reference renders such as PX458 (BbsI + EcoRI) and pTRIPZ
(Unique Cutters + BamHI) that were previously forced
through the unrelated unique_6plus preset. A file-saved
None profile deliberately returns no sites.
geom_restriction_site() draws ticks, labels and
independent radial leaders in one deterministic layer. Real site anchors
are separated from final label positions. Enzyme-facing text edges begin
on a close circular contour in genomic order; remaining boundary
collisions move only to the nearest local exterior track. Sparse
callouts retain their natural angles, while dense lateral clusters
switch deterministically to a compact ordered fan with uniform measured
spacing rather than a rigid Cartesian text wall. Natural sparse callouts
use a direct connector; displaced callouts normally use a radial stub
and fan connector. If that connector would enter the sequence circle, it
follows a sampled safe exterior arc before approaching the label, so
wide-device fans cannot cut through the plasmid interior. Enzymes
sharing one cleavage coordinate are combined into one stable callout
while all contributing rows remain in source_rows. Each
connector ends on the enzyme-bearing left or right edge of the measured
label box: right-travelling lines meet its left edge and left-travelling
lines meet its right edge. Near-vertical leaders use the nearest corner
on that same side rather than switching to the top/bottom edge. Mirrored
text order keeps the enzyme at the connected side. The former
leader = "trunk" spelling remains only as a compatibility
alias and no longer creates a shared trunk. Dense-fan leaders retain
individual site anchors, use a short radial root, and then fan out in
genomic order from a narrow bundle. Default composite labels are
rendered as two coordinated grobs. Only unique cutters use bold enzyme
names; repeated cutters and coordinates use regular weight. Adjacent but
distinct bp sites are never merged.
Added geom_seq_center_label(),
theme_ggchord_plasmid(),
scale_feature_fill_plasmid(), and
scale_feature_shape_plasmid(). Manual feature scales take
priority over presets regardless of addition order. The plasmid theme
places coordinate ticks and labels inside the backbone. The automatic
circular-origin tick is longer and does not repeat a 0
label.
Added reproducible one-row sequence fixtures for all thirteen
reference plasmids under examples/plasmid/, generated from
the FASTA sequences without biological modification. Their
accver and display label now consistently use
the full file stem, and deterministic plasmid_example_*
names cover every reference plasmid. Added a bundled normalized
common-feature database with provenance metadata and dynamic exact DNA
and six-frame protein matching. In mode = "auto", records
now follow their stored detection mode: exactProteinMatch
uses exact protein followed by near-exact DNA, while other records use
exact DNA. Audited SnapGene 8.2.3 data are now the current source
release: 1,454 features, 1,970 segments, 5,216 qualifier values, 548
hyperlink occurrences and a 903,397 bp backing sequence. The normalized
database stores source-local IDs separately from stable ggchord IDs,
keeps standard and gap segments as the authoritative structure, derives
DNA from 1-based inclusive coordinates plus the backing sequence, and
derives protein from typed translation qualifiers.
Qualifier links retain occurrence order and anchor text without URL
deduplication. Version provenance records additions, modifications, type
reclassifications, the Csy4 Site name normalization and the
tPA signal/propeptide split; legacy wide-table DNA, protein and
q_* columns are no longer authoritative storage. Protein
detection eligibility is independent of feature type, including the new
sig_peptide exact-protein records. The removed legacy
workbook is represented by a compact, immutable migration provenance
snapshot, so regenerating the database does not restore or depend on the
obsolete wide-table source. Separately, audited annotations embedded in
thirteen reference .dna files provide an exact
known-sequence layer for pBR322, pUC19, pBluescript II SK(+), pSB1C3,
pET-28a(+), pETDuet-1, pcDNA3.1(+), pTRE-Tight-BI, pSpCas9(BB)-2A-GFP
(PX458), pDONR221, pCAMBIA1300, pEarleyGate 201, and pTRIPZ. The
generated database currently contains 201 biological features and 218
segments, plus seven true primer binding-site records from pSB1C3 and
pETDuet-1 in a separate internal reference table rather than the Feature
table. It records each source SHA-256 and record count. The former
plasmid_example_pUC19c object remains as a pre-release
compatibility alias of plasmid_example_pUC19. Complete
REBASE 609 pattern data are embedded for working-directory-independent
restriction-site search and remain reproducible from
VERSION plus the three embossa_*.txt source
files and misc/embossre.equ. Other files in the extracted
examples/rebase/misc/ directory remain supplemental
verification sources; runtime searches do not depend on that
directory.
Removed the v0.12 seq_id data/mapping compatibility
entry. Rename it to accver before calling ggchord
functions.
Removed ggchord::geom_ribbon() after its v0.12
deprecation. Use geom_link_ribbon(); existing ribbon
aesthetics, scales, themes, and layout export component names are
unchanged.
geom_link_ribbon() now defaults to
link_avoid = "uniform", using one obstacle-aware clearance
across each endpoint. Local "smooth" avoidance and fixed
"none" spacing remain explicit choices; an explicit
ribbon_gap still takes priority.
Added geom_link_ribbon() as the canonical interval
link geometry. Ribbon aesthetics, scales, themes and exported layout
components keep their names.
ggchord::geom_ribbon() now emits a deprecation
warning directing callers to geom_link_ribbon(); removal is
planned for v0.13.0. Ribbon statistics use the canonical constructor
without triggering the compatibility warning.
Single-sequence tables now use accver. Legacy
seq_id columns/mappings warn in v0.12 and will be removed
in v0.13; supplying both is an error. Packaged example data have been
regenerated from unchanged source files.
Ribbon drawing requires only the six endpoint columns.
length and pident are optional; requested
filters/statistics still require their inputs. Missing identity uses a
fixed fill without an Identity guide.
Gene annotations and feature categories may be omitted. Coordinates, accessions, sequence lengths and feature strands remain required.
Added point links (geom_link_line()), independent
link scales and legend.link.*, and re-exported
grid::unit() and grid::arrow().
Entity obstacle providers now use rendered shapes. Local
clearance is opt-in through link_avoid = "smooth" or
"uniform"; the default is "none".
link_branch = "query" or "subject"
optionally shares equal endpoints with equal mapped styles. Trunks
retain source membership in layout exports.
Removed geom_ribbon_highlight(). Use an additional
geom_link_ribbon(data = subset, fill = ...) layer
instead.
Fixed feature-shape legend mappings and increased gene-arrow key height.
Shared-link fallback now preserves vertex-wise staged aesthetics instead of replacing each unshared path with its first vertex style.
Shared ribbon branches now honor explicit edge control points, including layout rotation, while preserving the shared junction tangent.
Split the constructor/build, automatic-scale, frame-fitting, sequence, ribbon, gene/region, axis, and label calculations into focused internal source modules without changing the public API or layout output.
Clarified why direct printing in a small RStudio Plots pane can
differ from export-size rendering, and recommends
view_ggchord() for composition with an explicit matching
ggsave() size for final files.
Archived previous-release design records in
design-roadmap/DESIGN-HISTORY.md.
geom_gene_label_repel() now defaults to
gene_label_layout = "radial": horizontal names follow each
sequence’s offset contour, with normal leaders and short normal
departures for displaced labels. "auto" combines side
columns with radial placement elsewhere, replacing the removed
"aligned".
Sequence curvature is continuous through zero and one and accepts signed values without silent clipping; opposite signs mirror the bow across the endpoint chord. Very large bows can make tracks intersect geometrically.
Static previews use a wider default and fit their height to
content when height = NULL; explicit output sizes remain
respected.
Radial packing explores a wider, ordered fan before adding an outer contour, and balances the extra clearance of opposite top/bottom sectors.
Content-fitted previews now export the measured gtable directly, avoiding height-dependent relayout oscillation and excessive outer legend whitespace. Default plot margins retain a small physical safety inset.
"auto"."aligned" requests now point directly to
"auto". Acceptance checks verify that auto actually
combines side columns with radial labels.tools/validate-release.R provides reproducible
common-geometry, label, output, benchmark and executable-vignette
checks, writing only temporary artifacts. Extreme parameter stress tests
are deferred.New stat_ribbon_bundle() and
stat_ribbon_density() expose
after_stat(bundle_n),
after_stat(bundle_weight), and
after_stat(density) while leaving
geom_ribbon() conservative.
New focus_ggchord_data() synchronizes sequence,
gene/feature, and ribbon cropping across one or more loci.
position_feature_stack() assigns the minimum deterministic
radial lanes, while seq_ring and
scale_seq_ring_manual() provide explicit multi-ring
radii.
geom_gene_label_repel() adds
gene_label_segment_overlap = "fade" | "clip" | "show" and
gene_label_segment_overlap_alpha. Covered leader portions
now default to a faint continuous line instead of a hard gap; clipping
and full display remain explicit per-layer choices.
geom_gene_label_repel() gains
gene_label_fit and gene_label_max_lines.
Initially crowded annotations can be wrapped, shortened with an
ellipsis, handled automatically, or left unchanged; explicit
gene_label_wrap remains the fixed-width override.
geom_gene_label(gene_label_side = "auto") now aligns
horizontal text from its displacement relative to the local sequence
curve rather than the plot origin, fixing inward labels in several
quadrants. Single-strand gene plots also generate a Strand guide with
the correct number and direction of keys.
The packaged gene example is rebuilt deterministically from the
unchanged source table with eight well-spaced, visibly varied features
per sequence and balanced display strands. source_strand
retains the source annotation direction, and the complete rule is
recorded in data-raw/generate_example_data.R.
The packaged ribbon example is rebuilt from the unchanged BLAST files with a 300-base minimum and at most three spatially distributed alignments per dense sequence pair. Sparse pairs remain intact, reducing the fixture from 31 to 13 ribbons without fabricating alignments.
Every public geom and stat now returns one standard
LayerInstance. geom_gene_label_repel() uses a
composite Geom/gTree implementation instead of returning child-layer
lists. The custom +.ggchord list-flattening path has been
removed.
Public layers consistently expose mapping,
data, position, show.legend,
inherit.aes, and .... A layer
data argument may be a data frame or a function receiving
that layer’s default input table.
prepare_ggchord_plot() is now the single
orchestration path for geometry, scales and coordinates.
ggplot_build.ggchord() delegates to it before the standard
ggplot2 build, keeping printing, ggsave() and
view_ggchord() consistent.
coord_chord() now constructs a real
CoordChord ggproto. Global most-recent-layout state has
been removed; get_chord_layout() requires an explicit
ggchord plot.
Role aesthetics use tidy evaluation once per build and preserve
source columns. Geometry roles reject
after_stat()/after_scale(), while visual
mappings continue to support staged aesthetics. User scales always win;
missing visual scales are inferred as continuous or discrete, and
incompatible mappings fail clearly.
theme_ggchord(),
theme_ggchord_minimal(),
theme_ggchord_publication(), and
theme_ggchord_dark() are now complete, theme-like
appearance interfaces with dotted arguments. text supplies
the parent typography and child sizes inherit through
rel(); the redundant base_size,
base_family, underscore element arguments, and
theme_ggchord_elements() have been removed.
Sequence axes are displayed automatically and configured with
axis.* theme arguments. geom_axis() has been
removed. Axis gaps, major/minor tick lengths and text offsets use
physical grid::unit() values; breaks, labels, limits and
transforms remain in
scale_seq_position_continuous().
Sequence, ribbon, gene, feature and region guides can
independently inherit or override position, direction, background, key
dimensions, text, title, margin and spacing through
legend.<role>.*. Ribbon colourbar ticks and its axis
line are independently themeable. Explicit scale/guides()
settings still take precedence, and feature guides no longer inherit
gene placement.
The default Identity colourbar is placed at the left edge of the
panel; compact sequence, strand, feature and region guides use the right
edge. view_ggchord() defaults to an 11-inch-wide
content-fitted preview. Explicit common or role guide positions and
explicit preview dimensions still win.
British colour spelling is canonical. seq_color,
ribbon_color, colors,
scale_*_color_*() and the new
guide_ggchord_colorbar() are complete US aliases; supplying
both spellings in one call now fails explicitly.
Layout-only operations no longer open an implicit
Rplots.pdf device while converting physical units. This
also fixes a following ggsave() or
view_ggchord() occasionally closing the wrong graphics
device.
Selected ggplot2 helpers such as theme(),
ggtitle(), labs() and guides()
remain exact re-exports. ggchord does not wrap them or expose unrelated
Cartesian geoms, facets, coordinates, scales, or complete
themes.
v0.11.0 removes the previous soft-compatibility layer. Removed arguments fail immediately with a migration message instead of warning or being ignored.
| Removed entry | Replacement |
|---|---|
ggchord(title/rotation/panel_margin/show_legend) |
labs() / coord_chord() /
theme() |
show_legend |
show.legend |
| geom legend position/key arguments | guides() + guide_ggchord_*() |
| geom colours, order, limits, breaks and names | role-specific scale_*() |
ribbon *_by, direction and visual-value arguments |
aes(ribbon_* = ...) + scales |
ribbon_alpha and ribbon outline names |
alpha, colour, linewidth,
linetype |
| feature type/category/label column strings | aes(feature_type/feature_fill/feature_label = ...) |
geom_seq(seq_labels/seq_colors) |
geom_seq_label(labels = ...) / sequence scale |
geom_axis() and its style/layout arguments |
automatic axis + theme_ggchord(axis.*); breaks/labels
use the position scale |
geom_seq_region(regions/region_* style) |
data, fill, colour,
alpha |
Vignette code examples are migrated to the current API and checked separately from document rendering. Existing figures and the public site are retained for a separate documentation rebuild after this release.
Dense alignments can now be simplified explicitly with
bundle_ggchord_ribbons(), while
optimize_ggchord_layout() searches for a deterministic
sequence order and orientation with fewer weighted crossings.
geom_ribbon() remains conservative: one input row still
draws one ribbon unless the user requests preprocessing.
geom_feature() supports independent
"arrow", "block", "chevron", and
"lollipop" geometries with
scale_feature_shape_manual(). Shapes and legend keys follow
each sequence’s local tangent/normal frame; lollipop heads remain
circular on curved sequences.
New export_ggchord_layout() provides stable layer
geometry with layer_id, source_row, mapped
input columns, and coordinate-space metadata. New
view_ggchord() previews the real dimensions produced by
ggsave() without introducing a second saving API or an
interactive dependency.
The default ribbon_gap = NULL resolves clearance per
endpoint. Ribbons move closer to geom_seq() where no gene
or feature polygon is present and retain clearance where a physical
obstacle overlaps the genomic interval. Text and leader lines are not
treated as ribbon obstacles.
Ribbon boundaries use a darker neutral outline, and unrequested ribbon or gene polygons are no longer computed. Dense-data reports preserve source-row mappings, alignment direction, weights, and approximation diagnostics.
geom_gene_label() is the single fixed/manual label
layer and now supports horizontal, radial, or tangent text; inside,
outside, or automatic side selection; and hide, nudge, or allow overlap
policies. Automatic leader-line placement remains in
geom_gene_label_repel().
Coordinate fitting uses independent tight x/y ranges. Text measurement, collision boxes, leader clipping, and limits share a device-aware physical scale, preventing small exports from being measured as a six-inch canvas. The transparent default legend background no longer masks labels extending into compact plot margins.
Default sequence, ribbon, gene, label, axis, and background
styles were recalibrated for a restrained publication-oriented
hierarchy. Strand legend keys use the same tapered silhouettes and
directions as geom_gene().
Identity, sequence, strand, and feature guides scale keys, colourbars, typography, and margins relative to the output device, with bounded scaling for extreme sizes. Explicit guide dimensions remain authoritative.
Namespace imports are deliberately narrow. Internal ggplot2,
grid, and grDevices calls are qualified, while ggchord selectively
re-exports only helpers directly useful for chord plots:
aes(), after_stat(),
after_scale(), annotate(),
labs(), ggtitle(), guides(),
theme(), the four theme element constructors,
margin(), rel(), ggsave(),
last_plot(), waiver(), and
expansion(). Cartesian geoms, facets, coordinates, generic
scales, and complete theme presets remain in ggplot2 so IDE completion
stays focused.
theme_ggchord() and its variants no longer repeat
Cartesian-axis, panel-grid, background, or margin settings already
inherited unchanged.
Sequence grouping has been removed:
geom_seq_group_label(),
scale_group_colour_manual() /
scale_group_color_manual(), and every
seq_group* argument or aesthetic now produce a clear
migration error.
No separate geom_gene_label_manual() is introduced.
Use geom_gene_label() for fixed/manual placement and
geom_gene_label_repel() for automatic layouts.
Plotly conversion remains removed. v0.10.0 focuses on deterministic static ggplot2 output; interactive rendering will be reconsidered only after the static API is stable.
The v0.9.0 public API was audited across constructors, geoms, role-specific scales, themes, guides, coordinates, data utilities and import helpers. Layer-local data/mappings, same-type layer isolation, old/new scale conflicts and plot-owned layout retrieval were rechecked against the final v0.9.0 interface.
The obsolete, unused ggchord_label_pad() internal
helper and its generated help page were removed. Adaptive limits remain
the single implementation used to fit rendered label boxes.
ggchord() now reuses the structured validator for
its always-on safety checks instead of maintaining a second validation
rule set. Validation also stops advanced coordinate and duplicate
calculations when malformed numeric columns make those calculations
unsafe, returning a complete report rather than a secondary type
error.
The experimental Plotly conversion method and dependency have been removed. v0.9.0 focuses on deterministic ggplot2 output; a future interactive design will be considered separately after the static API is stable.
Default discrete colours now use a colour-vision-friendly palette (with a qualitative HCL fallback for larger sets). Strand colours, sequence and gene outlines, ribbon separation, highlight colour and legend key glyphs were recalibrated for clearer screen, PDF and greyscale output. These defaults remain fully replaceable through the role-specific scales and geom styles.
clean_ggchord_data(unknown_id = "keep") now retains
unknown gene rows without attempting coordinate checks against a missing
sequence length. Sorting reversed ribbon intervals records their
original same/reverse direction so drawing does not silently change
alignment orientation.
Ribbon filtering reports every removal reason for a row;
deduplicate_ggchord_ribbons(keep = "first") now means the
first input row; and merge_ggchord_ribbons() no longer
leaves stale values in disagreeing auxiliary columns. Use
extra_columns = "first" to request the previous first-row
behaviour explicitly.
BLAST outfmt 7 imports now parse and validate
# Fields: instead of assuming a fixed 17-column layout.
GFF3 parsing stops at ##FASTA. All three import helpers can
add .source_file with
source_file = TRUE.
Unknown ribbon and gene sequence IDs now have the same severe validation level. Skipped duplicate checks for exceptionally large pair groups are reported rather than omitted silently. Feature categories, region outlines, curved-region side selection and highlight argument validation were fixed.
Every ggchord layer now receives a stable layer_id
and its own geometry registry entry. Multiple gene, feature, region,
ribbon, highlight, axis or label layers no longer reuse the last layer’s
data and parameters.
Layer data and role mappings such as
aes(seq_id = chromosome, start = from) are evaluated
against that layer’s input. Original columns are joined back to expanded
geometry through source_row, so ordinary visual mappings
remain available during the ggplot2 build.
get_chord_layout(plot, build = TRUE) retrieves the
layout owned by a specific plot. Calling get_chord_layout()
without a plot still works for compatibility but is deprecated because
“most recently built plot” is ambiguous when plots are built in an
interleaved order.
Sequence reference paths are cached within one build and reused by independent same-type layers. The cache is local to that build and cannot leak geometry between plots.
Sequence, group, ribbon, gene, feature and region layers now use
independent role aesthetics: seq_colour,
group_colour, ribbon_fill,
ribbon_alpha, ribbon_colour,
ribbon_linetype, gene_fill,
feature_fill and region_fill. Their public
scale_*() constructors can coexist in one plot without
replacing another layer’s fill or colour scale.
scale_seq_position_continuous() controls genomic
major/minor breaks and labels. It is trained independently against each
sequence length.
scale_group_color_manual() and
scale_ribbon_color_manual() are available as
American-English aliases of their colour counterparts,
matching ggplot2’s spelling convention.
Old scale-like geom arguments remain functional during v0.9.0 and emit one migration warning per session. Supplying both an old argument and the new role scale is an error rather than silently choosing one. Principal migrations are:
| Old geom argument | New interface |
|---|---|
seq_colors, seq_group_colors |
scale_seq_colour_manual(),
scale_group_colour_manual() |
ribbon_colors, colour limits/breaks/name |
scale_ribbon_fill_*() |
ribbon_*_by |
the corresponding aes(ribbon_* = ...) |
ribbon_alpha_range |
scale_ribbon_alpha_continuous(range = ...) |
| ribbon outline/linetype/direction visual values | ribbon colour/linetype/alpha scales |
gene_colors, gene_order |
scale_gene_fill_manual() |
feature_colors, feature_order |
scale_feature_fill_manual() |
| axis major/minor counts and labels | scale_seq_position_continuous() |
coord_chord() now owns global rotation, aspect
ratio, clipping and view fitting. fit = "labels" measures
annotation boxes, fit = "geometry" fits only geometric
marks, and fit = "manual" requires explicit limits.
User-supplied limits take priority, and replacing it with another
ggplot2 coordinate system is no longer silently undone during the
build.
theme_ggchord(),
theme_ggchord_minimal(), theme_ggchord_dark()
and theme_ggchord_publication() provide a small set of
composable themes. Dedicated theme elements are registered for axes,
sequence/group labels, gene labels and leader segments; data-driven
colours remain scales.
guide_ggchord_legend() and
guide_ggchord_colourbar() are thin wrappers around ggplot2
guides with compact chord-diagram defaults. Existing
ggchord() arguments title,
rotation, panel_margin and
show_legend remain functional in v0.9.0 but point users to
labs(), coord_chord() and theme()
respectively.
Gene, sequence and axis text sizes are now fixed layer values
rather than a shared size scale, so adding one label layer
cannot rescale another. Registered axis, sequence-label, gene-label and
leader-line theme elements are resolved before the standard ggplot2
build; an explicit geom style still takes priority.
geom_axis() routes shared styles only to compatible
child geoms and accepts separate line_params,
tick_params and text_params. Its former
show_legend argument is removed because axis annotations
never participate in a legend.
geom_seq_group_label() provides an independent
group-label layer, while the labels created implicitly by
geom_seq() remain available for compatibility. Group values
now train scale_group_colour_manual() instead of treating
already-resolved colour strings as categories.
geom_seq_label(labels = ...) separates displayed
sequence text from scale labels; seq_labels remains a
deprecated alias. Label arguments passed to geom_gene() now
fail clearly instead of being warned about and then leaked into
geom_polygon(). Geom-level legend positions and colourbar
dimensions remain functional during v0.9.0 but direct users to
guides().
geom_gene_label_repel() now uses the deterministic
gene_label_layout = "aligned" | "radial" | "arc" interface.
"aligned" remains the default and arranges horizontal
labels on orderly cardinal rails. "radial" uses the nearest
collision-free local offset track while keeping text horizontal.
"arc" rotates readable text along the sequence tangent and
draws a short leader only when a label has moved away from its first
track.
All modes now use each sequence’s real curve and local normal,
including custom seq_radius, seq_curvature,
seq_gap, mixed seq_orientation, rotation and
explicit rings. They share fixed-obstacle avoidance, cross-sequence
collision handling, order-preserving leader routing and device-aware
clipping. Rotated labels use oriented-rectangle collision and clipping,
preventing spurious whitespace and oversized breaks in leaders.
The layout ideas adapt orderly multi-sequence callout figures and the external/inside feature-label approaches offered by SnapGene and Geneious. ggchord uses generic API names and integrates the ideas into its own geometry system. See the SnapGene feature-label documentation and Geneious label options.
geom_gene_label_repel() now has the following focused
interface:
geom_gene_label_repel(
mapping = NULL, data = NULL,
gene_label_layout = "aligned",
gene_label_size = NULL, gene_label_wrap = NULL,
gene_label_side = "outside", max_overlaps = Inf,
gene_label_segment_linetype = "auto",
show_legend = FALSE, ...
)Removed arguments fail immediately rather than being silently ignored:
| Removed argument(s) | Migration |
|---|---|
gene_label_rotation,
gene_label_radial_offset,
gene_label_circum_offset,
gene_label_circum_limit |
Use geom_gene_label() for manual rotation or
offsets. |
box_padding, point_padding,
min_segment_length, force,
seed |
Select an automatic gene_label_layout; collision and
line settings are managed by the mode. |
gene_label_orientation,
gene_label_segment |
Use gene_label_layout = "aligned",
"radial", or "arc". |
This was the v0.9.0 interface. v0.10.0 subsequently strengthens the
existing fixed-position geom_gene_label() instead of
introducing a separate manual geom; see the development section
above.
geom_seq_label() now places sequence names on the
arc by default (seq_label_radius = 1) and rotates them
along the arc while keeping them readable;
seq_label_orientation = "horizontal" draws every label
horizontally, extending away from the chord centre.
geom_gene_label() now sits right beside the gene
arrows by default (gene_label_radial_offset = 0.04) and
gains gene_label_wrap for wrapping long annotations into
narrower, less overlapping labels.
geom_gene_label_repel() now defaults to
gene_label_orientation = "horizontal",
gene_label_segment = "elbow" (an L-shaped leader line that
adapts to each label’s position and text width) and
gene_label_side = "outside", so labels stay readable and
out of the ribbon area. A deterministic final de-overlap pass measures
the exact rendered text boxes and treats the sequence, group and axis
labels as hard rectangular obstacles; max_overlaps hides
labels that still collide after repulsion (ggrepel-style
decluttering).
The label text-box projection is now shared by the repulsion solver, the obstacle boxes and the coordinate limits, so all three agree on where text will actually be drawn.
geom_seq() gains sequence-grouping support via
seq_group, seq_group_gap,
seq_group_labels, seq_group_label_radius and
seq_group_colors. Groups can come from a
seq_group column in seq_data or be supplied as
a single value, a named/positional vector, or a list.
An extra inter-group gap (seq_group_gap) is inserted
only at boundaries between different groups, and optional group labels
are drawn at the angular midpoint of each group, at a customisable
radius.
Group labels are rendered horizontally and use their own internal
zcolour identity scale, so they never interfere with the
Seq ID colour legend. geom_seq() stays backward compatible
and still returns a single layer; group labels are appended lazily at
build time.
geom_ribbon() can now map any numeric column to a
continuous fill via ribbon_color_by (for example
"bitscore" instead of pident), with
ribbon_color_limits, ribbon_color_breaks and
ribbon_color_name to control the colourbar.
ribbon_alpha_by / ribbon_alpha_range
scale ribbon transparency continuously from a numeric column.
ribbon_outline_by /
ribbon_outline_colors and ribbon_linetype_by /
ribbon_linetypes map discrete columns to outline colour and
linetype using internal aesthetics, without disturbing the Seq ID or
Identity(%) legends.
ribbon_direction (one of "none",
"alpha", "outline" or "linetype")
visually distinguishes same- vs reverse-orientation alignments, with
ribbon_direction_colors,
ribbon_direction_linetypes and
ribbon_direction_alpha for fine control.
legend_key_width / legend_key_height
control the size of the Identity(%) colourbar key.
New geom_seq_region() draws rectangular bands along
sequence arcs to mark loci, repeats, CRISPR arrays or other user-defined
intervals. It accepts seq_id, start and
end (plus optional label,
category and color) and exposes
region_fill, region_color,
region_alpha, region_width,
region_offset and region_side.
New geom_ribbon_highlight() emphasizes selected
ribbons without changing the underlying Identity(%) legend. Selection
uses safe, explicit filters (ribbon_ids, query/subject IDs,
pident/length ranges, or a predicate function) and reuses the computed
ribbon geometry.
New geom_feature() is a thin, backwards-compatible
convenience layer for CDS, tRNA, rRNA, repeat, CRISPR, promoter and
custom feature tables; it prepares a gene-compatible table and reuses
geom_gene()’s geometry and scales, with
feature_colors, feature_width,
feature_offset and feature_order for
styling.
geom_seq_region(), geom_ribbon_highlight(),
geom_feature()) and expanded the documentation for the
updated geom_seq(), geom_ribbon(),
geom_seq_label() and geom_gene_label_repel()
parameters.New exported function validate_ggchord_data()
returns a structured ggchord_validation object: a
valid flag, errors (severe problems),
warnings (drawable but noteworthy issues), per-category
summary counts, a data_summary
(sequences/ribbons/genes, unknown IDs, out-of-range rows, …), the
original row numbers of every problem (invalid_rows) and
the automatically fixable issues (cleanable).
print() and summary() methods are provided;
strict = TRUE stops on severe problems.
New exported function clean_ggchord_data() applies
explicit, conservative policies (unknown_id,
out_of_range, reversed_interval,
invalid_pident, empty_annotation) and returns
the cleaned tables plus a full report of every change (original row
number, reason, original/new values, action). The input objects are
never modified and nothing is dropped silently.
ggchord() gains a
validate = c("warn", "error", "none") argument. The default
"warn" emits a single summary warning (never one warning
per row) and caches the full report on the plot
(p$ggchord$validation); "error" stops on
severe problems; "none" keeps a fast path. Valid input
renders exactly as before.
read_blast() parses BLAST -outfmt 6/7
tabular output (12 or 17 columns, auto-detected) into
ribbon_data format, preserving evalue,
bitscore, qcovs, qlen,
slen, sstrand and stitle when
present.
read_gff3() parses GFF3 files into
gene_data format, selecting feature_types
(default CDS), extracting anno from attribute
keys (product, Name, …), decoding
percent-encoding, and mapping unstranded features to + (or
dropping them).
read_fasta_lengths() reads FASTA headers and
sequence lengths into seq_data format, with optional
header_delim splitting.
filter_ggchord_ribbons() filters ribbons by sequence
IDs, pident, length, E-value, bitscore, query/subject coverage,
undirected sequence pairs and self-links, with optional sorting; missing
columns produce clear errors.
deduplicate_ggchord_ribbons() removes exact,
coordinate-near or highly overlapping duplicate blocks
(by = "exact" | "coordinates" | "overlap") keeping the best
pident, longest, or first representative.
merge_ggchord_ribbons() merges adjacent/overlapping
blocks of the same sequence pair with length-weighted pident. Merging is
deliberately conservative: blocks with inconsistent spans, large pident
differences or different orientations are left unmerged.
All ribbon utilities keep extra columns and the original column
order, attach the original row numbers as the source_rows
attribute, and return a report of what was removed/merged and
why.
validate integration, data import, ribbon
filtering/deduplication/merging and a lightweight visual-regression
suite (deterministic layout fingerprints plus an opt-in PNG md5 baseline
behind GGCHORD_VISUAL_REGRESSION=1).(No user-facing changes; internal bug fixes.)
Plot objects are now fully self-contained: data and parameters
are stored on the plot itself instead of in a package-wide environment.
Multiple plots can be created and built independently in the same
session, and plots survive saveRDS() /
readRDS().
The layout is now computed by ggplot_build() rather
than by a custom print() method. As a result
print(), ggsave(), ggplot_build()
and other standard ggplot2 workflows all work directly on ggchord plots,
and rendering no longer modifies the user’s plot object.
New layer geom_seq_label(): places sequence labels
at the midpoint of each sequence arc with control over radial offset
(seq_label_radius), rotation
(seq_label_rotation) and font size
(seq_label_size).
New ribbon color scheme "subject": colors ribbons by
the subject sequence (saccver), complementing the existing
"query" scheme.
The layout accessor get_chord_layout() is now
exported, making the computed geometry available for custom layers and
annotations.
Themes, scales and other ggplot2 objects can now be added with
+ (e.g.
p + theme(legend.position = "bottom")), and user-supplied
colour/fill scales are respected instead of being overwritten.
ggchord() now warns about suspicious input data:
reversed or out-of-range alignment/gene coordinates, pident
outside [0, 100], and sequence IDs that are not present in
seq_data.
geom_gene_label_repel() gains
gene_label_side = "auto" | "inside" | "outside". With
"outside", labels that would sit inside the chord (where
they can overlap the ribbons) are mirrored to the outside of their
sequence arc, keeping the same radial distance from the arc.
New gene_label_segment_linetype argument controls
the leader-line linetype. The default "auto" draws solid
lines, except for labels that were moved to the other side of their arc
(gene_label_side), which are drawn dashed. Any other valid
ggplot2 linetype (e.g. "dotted" or a numeric dash pattern)
is applied to all leader lines.
Elbow leader lines no longer force fixed segment lengths: the stub scales with each label’s text width and the horizontal space available between the gene and the label, so labels can be placed more flexibly without degenerate (near-zero) stubs.
geom_seq_label() now documents and follows the
intended seq_label_radius semantics: 1 sits on
the arc, > 1 places the label outside (away from the
chord center) and < 1 inside. Previously the multiplier
was applied in the opposite direction (the default 1.15 put
labels inside the chord).
New geom_seq_label() options:
seq_label_orientation = "arc" | "horizontal" (horizontal
labels extend away from the chord center), seq_label_hjust
/ seq_label_vjust for per-sequence justification, and
check_overlap to skip labels that would overlap.
The default theme no longer draws grid lines
(panel.grid is blank) and legend keys are transparent (they
blend into the plot background instead of a fixed white
rectangle).
findInterval), speeding up layout computation for
large plots.ggplot2 (>= 4.0.0) and
R (>= 4.1.0) to match the implementation (the package
relies on ggplot2 4.x internals).R CMD check workflow (macOS,
Windows, Linux).fill_ggnewscale_1 aesthetic
name in favour of fill_ribbon.Tests no longer write to a hard-coded /tmp path:
they use tempfile(), so the test suite passes on Windows
and leaves no stray files behind for R CMD check (fixes the
CRAN incoming-check failure).
The Identity(%) colourbar no longer collapses into a
thin/invisible line when the legend is placed at the top/bottom or the
legend box is horizontal (legend.box = "horizontal"). It
now follows the theme’s legend position: a vertical bar filling the
available height at the left/right, and a fixed-size horizontal bar at
the top/bottom.
Legend keys are transparent and do not inherit
panel.background (ggplot2 4.x lets unset legend keys follow
the panel background, so the key fill is set explicitly to stay
transparent).
Sequence (and gene) labels no longer end up upside down when a
global rotation >= 90 is used: the readability flip is
now re-applied after the layout rotation instead of only before
it.
The repulsion spring now pulls labels toward their own starting
position rather than the leader-line anchor, which keeps labels moved
with gene_label_side = "outside" on the outside while their
leader line still starts at the gene.
With gene_label_side, every label is kept on the
requested side of its arc (previously only the labels moved by the side
switch were re-checked, so a crowded repulsion layout could push other
labels across the arc).
The built-in gene_data_example annotations no longer
contain URL-encoded %2C artifacts (e.g. “ribonucleotide
reductase%2C large subunit” is now “ribonucleotide reductase large
subunit”).
Each legend can now be positioned independently via the
legend_position argument of geom_seq(),
geom_ribbon() and geom_gene() (e.g.
geom_ribbon(legend_position = "bottom")). Legends without
an explicit position stay together at
theme(legend.position = ...).
Parameter specification is now more flexible and human-friendly.
Sequence parameters accept a single value, vectors, vectors/lists named
by sequence ID, lists named by sequence order ("1",
"2", …) and unnamed lists; gene parameters additionally
accept per-strand (+/-) specifications in any
of those forms
(e.g. gene_label_rotation = c("+" = -15, "-" = -45) or
list(c("+" = -15, "-" = -45), ...)), including length-one
lists that recycle.
geom_ribbon():
ribbon_outline_color (default "black"),
ribbon_outline_width (default 0.05) and
ribbon_outline_linetype (default 1,
solid).ggnewscale dependency. The ribbon and gene
fill scales are now kept independent via an internal renamed-fill
aesthetic, so no external package is required for plots with both ribbon
and gene layers.RColorBrewer dependency. The default Set1
categorical palette is now built into the package, so the rendered
default colors are unchanged.geom_ribbon() and geom_gene() were
present (previously produced wrong ribbon colors and a “Scale for fill
is already present” message).ribbon_alpha rendering at the wrong opacity
(e.g. 0.35 was drawn as ~0.55); the alpha value is now
applied exactly as specified.geom_axis(show_axis = FALSE) failing with “object
‘label’ not found”.axis_label_orientation rejecting mixed vectors
such as c("horizontal", 45, ...).brewer.pal() when fewer than 3
sequences or gene annotations are used (two-sequence plots now render
cleanly).geom_gene() was added before
geom_ribbon() (“Continuous value supplied to a discrete
scale”).geom_axis() where the axis
path was misclassified as a sequence arc.+.ggchord and
ggplot_build.ggchord() as proper S3 methods and aligned the
ggplot_build.ggchord() signature with the generic.geom_seq(), geom_ribbon(),
geom_gene(), geom_axis(),
coord_chord(), +.ggchord() and others).examples/plots/, generalized
the package description beyond BLAST, and documented the ribbon outline
parameters.ggchord() + geom_* API.ggchord() into the individual geom_* layers;
ggchord() now only validates data and sets global style
(title, rotation, panel_margin,
show_legend, debug).print() time, collecting parameters from all layers during
rendering.print.ggchord() method: merge parameters,
compute the layout, inject data into layers, then render.ggchord() + geom_seq() + geom_ribbon() + geom_gene() + geom_axis().+.ggchord method that flattens layer lists
automatically.coord_chord() coordinate system.