Skip to content

ggalign

1.2.0Package record

A 'ggplot2' Extension for Composable Visualization

0packages dependsuggested by 1
5.9Kdownloads / year
70.3%test coverage
11/13flavors OK

Overview

About

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.

Changes in 1.2.0
  • 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() to patch() for clearer and more consistent naming.
  • The Patch object is now exported for external use.
  • Refactored patch_titles to the new S7-based patch_title class (soft-deprecated the old version).
  • Renamed the original patch() to as_grob() for clearer.

From NEWS.md in the release

Install

Health

CRAN checks
2NOTE11OK
Check messages
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.

CRAN check page ↗

Slowest check: 10.9 min · r-oldrel-windows-x86_64
Status changes
  • 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
Advisories

none known

Documentation

In release 1.2.0
READMEYes · 657 wordsVignettesNoNEWSYes · 100% structured · mentions 1.2.0Citation fileNoWebsiteYes · pkgdown

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

5.9K
CRAN downloads in the past year
Rank #5,866 · ~16/day · ~495/mo
Daily download trend is not available in this view yet.
50630 days
1.4K90 days
5.9K1 year
Compare downloads with other packages →
Also on124 r2u6 autocran1.6K conda_forge

Repository

406Stars
18Forks
2Open issues
0Open PRs
9Releases
2,007Commits
4Commit identities
ggplotggplot-extensionggplot2heatmapheatmap-visualizationheatmapsdendrogramdendrogram-heatmap
2,007 commits · Last activity 2026-01-15 · +1.2% stars, 30d · Default branch at 1.2.0.9000, ahead of CRAN 1.2.0 (checked 2026-10-21)
Responsiveness
How these are sampled
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

2025-10-20 · 3522026-10-19 · 406
PracticesBeta

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.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (1)
Code of conduct
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-01-15 · The repository has a site deploy workflow

pkgdown site last built 2026-01-15

Coverage (2)
Coverage reporting (Codecov).covrignore
Show all practicesHide 3 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (2)
cran-comments.mdrevdep/
Lint, format, editor (1)
Air
How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies
13 external dependencies (excludes base and recommended)

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.

Depends (1)
Imports (12)
S7vctrsrlangcligrDevicesgridgtablescalesmethodsstatsutilslifecycle
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect
Suggested by 1
Suggests, most downloaded first

Datasets

People & History

People (3)
Author, Maintainer since 0.0.3 (2024)
Author · added in 0.1.0
Thesis advisor · added in 0.1.0
Releases (9)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • 1.2.0Latest
    record
    2025-10-18 · current release · diff ↗ ·
    removed 1 export
    alignpatch
    added 4 exports
    Patch, alignpatches, as_grob, patch_title
  • 1.1.0
    record
    2025-09-11 · diff ↗ ·
    removed 3 exports
    channelGrob, element_curve, element_polygon
    added 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.2
    record
    2025-05-14 · diff ↗ ·
    removed 1 export
    Align
    added 8 exports
    CraftAlign, magickGrob, scale_z_binned, scale_z_continuous, scale_z_date, scale_z_datetime, scale_z_discrete, scale_z_ordinal
  • R
    R 4.5.0 released · 2025-04-11
  • 1.0.1
    record
    2025-04-10 · diff ↗ ·
    added 1 export
    channelGrob
  • 1.0.0
    record
    2025-03-16 · diff ↗ ·
    removed 5 exports
    align_reorder, draw_key_draw, draw_key_draw2, geom_draw2, scale_draw_manual
    added 6 exports
    align_order2, coord_circle, draw_key_gshape, facet_sector, geom_gshape, scale_gshape_manual
  • 0.1.0
    record
    2025-02-06 · diff ↗ ·
    removed 9 exports
    align_gg, dendrogram_data, fortify_stack, free_gg, ggstack, plot_align, plot_data, plot_theme, theme_ggalign
    added 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.5
    record
    2024-11-14 · diff ↗ ·
    removed 2 exports
    is_ggstack, wrap
    added 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.4
    record
    2024-10-12 · diff ↗ ·
    removed 8 exports
    GeomDraw, geom_draw, is.ggheatmap, is.ggstack, layout_heatmap, layout_stack, patch_align, patch_gtable
    added 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.3
    record
    2024-09-15
  • R
    R 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")
Peng, Y., Wang, S., & Yu, G. (2025). ggalign: A 'ggplot2' Extension for Composable Visualization (Version 1.2.0) [Computer software]. https://doi.org/10.32614/CRAN.package.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.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for ggalign version 1.2.0 [Data set]. HJJB, LLC. Data release v2026-10-23. https://doi.org/10.5281/zenodo.21843040

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.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy