NEWS

forestplot 3.2.0 (2026-03-04)

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(), and fp_span_where() allow row/column/cell targeted alignment, text styling, and spanning directly on gforge_forestplot objects.
New fp_set_summary() helper allows setting summary rows on existing gforge_forestplot objects 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 existing gforge_forestplot objects in a pipe flow.

Fixed missing grid parameter
Fixed zebra style issue when no header is present and also graph box fill defaults now defaults to NA to allow zebra style. Also fixed multiple sub-headers.
Fixed bad handling when providing ticks with xlog transformation

Added fp_add_lines() for superseding hrzl_lines argument and also adding the option of vertical lines
Fixed align bug and added align to fp_set_style
Fixed width calculation bug
Fixed multi-line NA bug

The forestplot() now returns an object with raw data that can be manipulated by subsequent functions prior to plotting. All visual output is now generated during the actual generation of the graph - this allows saving the plot and plotting it when explicitly requested. BREAKING - this may be a breaking feature although most of the old syntax should work without much need for adaptation.
New additive syntax with:
- Row manipulation: fp_insert_row, fp_add_header, and fp_append_row
- Style functions: fp_set_style, fp_set_zebra_style, and fp_decorate_graph
- Text styling: fp_txt_bold, fp_txt_italic, ...
- Align functions: fp_align_left, fp_align_center, fp_align_right
Fixed bug with how grouped data frames are processed and presented.
Expressions are now allowed in data.frame tidyverse input.
Moved to native R-pipe operator (|> instead of %>%)
Fixed case when all rows are summaries (Thanks Christian Röver)
Fixed automated ticks.
Fixed bug calculating graph width
Added graph decoration (fixes issue #11)

Changed function so that it returns a gforge_forestplot object instead of directly plotting. The print.gforge_forestplot calls the draw function that converts the object to the actual forestplot. Breaking if you have used the function within loops this will cause a break in the old behavior.
Implemented dplyr compatible API that allows using standard dplyr syntax
Fixed shapes_gp legend bug

Fixed issue #10 with non-log grid lines
Suppressing the "zero" line #8
Fixed bug when automatic lower/upper are to be identified and the data contains NA
Fixed bug reported related to legends on SO: https://stackoverflow.com/questions/43217570/forestplot-want-to-give-legend-for-each-4-colums

Fixed bug when merging gpar() with font & fontface options (thanks Katherine T. Mills)
Fixed input bug with 3-dim array
Improved auto detection of upper and lower intervals

Changed forestplot function to S3 style (thanks Christian Röver)
Fixed bug with alignment for summary elements
When any of the inputs is missing for a line the line is skipped (issue #5)
Added checkmate for argument validation
Added option of just specifying the rows that the CI should be applied to (issue #7)
Added fpDrawBarCI (thanks Christian Röver)
Fixed xlog bug
Added a colgap option
Bug fix for plots wider than the div (Thanks Michael Obeda for reporting)

Added a bug fix for when number of colors isn't equal to the dimension of the input causing the box not to be drawn
Fixed bug concerning vertical offset for clippers

Line-type can be specified
Line endings can now be marked by a T vertical, this default for all line types other than 1
The arrow height defaults to the same height as the vertices
Added a grid option
Improved documentation

Separation from the Gmisc-package
Name change - forestplot2 is now just forestplot in order to allow a deprecated call within the Gmisc package without generating a conflict
The fontfamily arguments are now embedded in the txt_gp that takes input from the fpTxtGp function. The fonts for the labels/summaries can be specified down to the cell level.
If provided a vector of length two for the zero argument you get an area for the zero-effect
There is a maximum colgap length for the box corresponding to the box height
confintNormalFn, confintSummaryFn, legendMarkerFn are now called fn.ci_norm, fn.ci_sum, fn.legend
Argument main in forestplot has changed to title