A 'ggplot2' Extension for Composable Visualization
Overview
A 'ggplot2' extension providing an integrative framework for composable visualization, enabling the creation of complex multi-plot layouts such as insets, circular arrangements, and multi-panel compositions. Built on the grammar of graphics, it offers tools to align, stack, and nest plots, simplifying the construction of richly annotated figures for high-dimensional data contexts—such as genomics, transcriptomics, and microbiome studies—by making it easy to link related plots, overlay clustering results, or highlight shared patterns.
- Fixed alignment of absolute panel dimensions when using
theme(panel.widths, panel.heights)in ggplot2 v4.0.0. - 'alignpatch-*' scripts have been fully refactored with S7 classes, with more informative and consistent naming.
- Improved
align_plots()to properly handle strips with different placements. - Renamed the original
alignpatch()topatch()for clearer and more consistent naming. - The
Patchobject is now exported for external use. - Refactored
patch_titlesto the new S7-basedpatch_titleclass (soft-deprecated the old version). - Renamed the original
patch()toas_grob()for clearer.
From NEWS.md in the release
Install
Health
NOTERd contentsr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc
Rd files without \usage: ‘layout-operator.Rd’ \arguments should not be documented without \usage.
- NOTE11 OK, 2 NOTENow
- NOTE12 OK, 1 NOTE2026-07-11
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK12 OK2026-04-25
- NOTE12 OK, 2 NOTE2026-03-10
Documentation
The repository also keeps web-only articles.
- Help pages
- 135 (21 internal)includes a package overview page
- Examples that run
- 100%55 run in a plain check (1 of them under a condition)
- Exported functions with examples
- 53%
- Documented parameters
- 90%
- Return-value docs
- 47%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 91%
- Median days to close, 50 most recently updated closed issues
- 2
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
13 development-tooling and community-health practices detected across 7 families in the upstream repository
Checks run against github.com/yunuuuu/ggalign on 2026-10-21.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-01-15 · The repository has a site deploy workflow
pkgdown site last built 2026-01-15
Show all practicesHide 3 practices
Dependencies
Installing ggalign adds 17 packages (7 with compiled code, 14 MB of source tarballs). Heaviest: ggplot2 6.0 MB, isoband 1.5 MB, farver 1.2 MB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 1.2.0Latest2025-10-18 · current release · diff ↗ ·
removed 1 export
alignpatchadded 4 exports
Patch, alignpatches, as_grob, patch_title - 1.1.02025-09-11 · diff ↗ ·
removed 3 exports
channelGrob, element_curve, element_polygonadded 18 exports
Scheme, Schemes, circle_genomic, element_vec_fields, genomic_density, genomic_dist, geom_magick, layout_tags, layout_theme, plot_add_scheme, plot_ideogram, quad_scope, scheme_inherit, scheme_init, scheme_update, stack_genomic, stack_genomich, stack_genomicv - 1.0.22025-05-14 · diff ↗ ·
removed 1 export
Alignadded 8 exports
CraftAlign, magickGrob, scale_z_binned, scale_z_continuous, scale_z_date, scale_z_datetime, scale_z_discrete, scale_z_ordinal - RR 4.5.0 released · 2025-04-11
- 1.0.1
- 1.0.02025-03-16 · diff ↗ ·
removed 5 exports
align_reorder, draw_key_draw, draw_key_draw2, geom_draw2, scale_draw_manualadded 6 exports
align_order2, coord_circle, draw_key_gshape, facet_sector, geom_gshape, scale_gshape_manual - 0.1.02025-02-06 · diff ↗ ·
removed 9 exports
align_gg, dendrogram_data, fortify_stack, free_gg, ggstack, plot_align, plot_data, plot_theme, theme_ggalignadded 68 exports
.link_draw, .mark_draw, align_hclust, align_phylo, circle_continuous, circle_discrete, circle_layout, circle_switch, continuous_limits, cross_link, cross_mark, cross_none, draw_key_draw, draw_key_draw2, element_curve, element_polygon, element_rep, element_rep_len, element_vec, element_vec_recycle, element_vec_rep, element_vec_rep_each, element_vec_slice, geom_draw, geom_draw2, geom_rect3d, geom_subrect, geom_subtile, geom_tile3d, ggalign_data_set and 38 more - 0.0.52024-11-14 · diff ↗ ·
removed 2 exports
is_ggstack, wrapadded 41 exports
active, anno_bottom, anno_left, anno_right, anno_top, fortify_data_frame, fortify_matrix, fortify_stack, free_gg, geom_pie, ggalign_attr, ggfree, ggoncoplot, ggside, ggwrap, is_heatmap_layout, is_layout, is_quad_layout, is_stack_layout, layer_order, plot_align, plot_data, plot_theme, quad_active, quad_alignb, quad_alignh, quad_alignv, quad_anno, quad_free, quad_init and 11 more - 0.0.42024-10-12 · diff ↗ ·
removed 8 exports
GeomDraw, geom_draw, is.ggheatmap, is.ggstack, layout_heatmap, layout_stack, patch_align, patch_gtableadded 12 exports
align_order, free_guide, free_vp, heatmap_layout, is_ggheatmap, is_ggstack, layout_annotation, layout_design, layout_title, order2, stack_layout, theme_ggalign - 0.0.32024-09-15
- RR 4.4.0 released · 2024-04-24
Package metadata
- First published
- 2024-09-15
- Total releases
- 9 / 2 yrs
- License
- MIT + file LICENSE OSI
- Download size
- 3.1 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("ggalign")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-23, which the citation names so these numbers can be found later. More on citing and the projects behind them.