Advanced Forest Plot Using 'grid' Graphics
Overview
Allows the creation of forest plots with advanced features, such as multiple confidence intervals per row, customizable fonts for individual text elements, and flexible confidence interval drawing. It also supports mixing text with mathematical expressions. The package extends the application of forest plots beyond traditional meta-analyses, offering a more general version of the original 'rmeta' package’s forestplot() function. It relies heavily on the 'grid' package for rendering the plots.
- Added input validation: error if a mean lies outside its confidence limits or if a lower bound exceeds its upper bound. Prevents missing boxes and internal
Inf/logical errors when working with negative estimates. - New
fp_span()helper (and span attribute) allows a label to occupy multiple text columns. Useful for centering sub‑headers such as "Events / N" beneath several adjacent columns. - New
fp_extract_labeltext()helper simplifies label column extraction for both grouped and ungrouped data, with optional column renaming and NA replacement. - New selector-style post-processing helpers
fp_align_where(),fp_txt_where(), andfp_span_where()allow row/column/cell targeted alignment, text styling, and spanning directly ongforge_forestplotobjects.
Show all changes in 3.2.0Hide the rest of the changes in 3.2.0
- New
fp_set_summary()helper allows setting summary rows on existinggforge_forestplotobjects using selector-style predicates in a pipe flow. - Internal label handling now tolerates grid grobs and other non-atomic objects in
labeltext. Previously such values could trigger coercion errors during preparation; these are now treated as valid content. - New
fp_set_favors()helper allows setting the "favors" text on existinggforge_forestplotobjects in a pipe flow.
From NEWS.md in the release
Install
Health
NOTER code for possible problemsr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc, r-devel-windows-x86_64
Found calls to structure() using deprecated special names: forestplot/tests/test_visual_w_cochrane_mdata.R (.Names: 1) forestplot/tests/vtest_from_vignette.R (.Names: 1) '.Names' should be changed to 'names'.
- NOTE8 OK, 5 NOTENow
- NOTE11 OK, 2 NOTE2026-07-16
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-07
- OK14 OK2026-03-10
Documentation
- Help pages
- 54 (22 internal)includes a package overview page
- Examples that run
- 100%20 run in a plain check
- Exported functions with examples
- 76%
- Documented parameters
- 94%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 5
- 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
4 development-tooling and community-health practices detected across 3 families in the upstream repository
Checks run against github.com/gforge/forestplot on 2026-10-21.
Dependencies
Installing forestplot adds 3 packages (2 with compiled code, 297 KB of source tarballs). Heaviest: checkmate 247 KB, backports 29 KB, abind 21 KB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 3.2.0Latest2026-03-04 · current release · diff ↗ ·
added 8 exports
fp_align_where, fp_extract_labels, fp_extract_labeltext, fp_set_favors, fp_set_summary, fp_span, fp_span_where, fp_txt_where - 3.1.72025-06-12 · diff ↗
- RR 4.5.0 released · 2025-04-11
- 3.1.62024-11-19 · diff ↗
- 3.1.52024-10-11 · diff ↗
- RR 4.4.0 released · 2024-04-24
- 3.1.32023-08-26 · diff ↗
- RR 4.3.0 released · 2023-04-21
- 3.1.12022-12-06 · diff ↗
- 3.1.0
- 3.0.02022-09-29 · diff ↗ ·
added 13 exports
fp_add_header, fp_align_center, fp_align_left, fp_align_right, fp_append_row, fp_decorate_graph, fp_insert_row, fp_set_style, fp_set_zebra_style, fp_txt_bold, fp_txt_gp, fp_txt_italic, fp_txt_plain - RR 4.2.0 released · 2022-04-22
- 2.0.12021-09-03 · diff ↗
- 2.0.02021-08-10 · diff ↗
- RR 4.1.0 released · 2021-05-18
Show 19 earlier eventsHide 19 earlier events
- 1.10.12020-12-12 · diff ↗
- 1.10
- RR 4.0.0 released · 2020-04-24
- 1.92019-06-24 · diff ↗
- 1.82019-06-01 · diff ↗
- RR 3.6.0 released · 2019-04-26
- RR 3.5.0 released · 2018-04-23
- 1.7.22017-09-16 · diff ↗
- RR 3.4.0 released · 2017-04-21
- 1.72017-01-07 · diff ↗
- 1.6
- 1.5.12016-06-23 · diff ↗
- RR 3.3.0 released · 2016-05-03
- 1.42016-01-31 · diff ↗
- 1.32015-11-16 · diff ↗
- RR 3.2.0 released · 2015-04-16
- 1.12015-03-10 · diff ↗
- 1.02014-12-30
- RR 3.1.0 released · 2014-04-10
Package metadata
- First published
- 2014-12-30
- Total releases
- 22 / 12 yrs
- License
- GPL-2 OSI
- Minimum R
- ≥ 4.1.0
- Bundled data
- 3.1 KB / 3 files
- Download size
- 1.9 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("forestplot")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.