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.
Changes for 3.1.7
Fixed box issue when first row is not a header (issue #70)
Changes for 3.1.6
Fixed grouped_df for dplyr dataframes (issue #69)
Changes for 3.1.5
Fixed xticks bug with log transformation (issue #67)
Changes for 3.1.4
Fixed lineheight bug (issue #64)
Changes for 3.1.3
Fixed bug for horizontal legends (issue #59)
Changes for 3.1.2
Fixed bug width single row forestplots (issue #57)
Changes for 3.1.1
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
Changes for 3.1.0
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
Changes for 3.0.0
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
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)
Changes for 2.0.1
Fixed missing lwd.zero (issue #42)
Fixed ignored clip argument when zero was
outside the clip area.
zero-line is now properly ignored when NA
Changes for 2.0
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
Changes for 1.10
Minor improvement for error message when plotting lines
Bugfix for multicolumn expressions (issue #30, thanks André
Gillibert)
Added shapes_gp parameter (issue #32, thanks André
Gillibert)
Changes for 1.9
Fixed bug for factor label argument
Changes for 1.8
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
Changes for 1.7
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
Changes for 1.6
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)
Changes for 1.5
Changed new_page to default to TRUE
Removed warnings for compatibility
Fixed so that squared multiline tables should now follow color
behavior
Changes for 1.4
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
Changes for 1.3
Fixed bug when specifying graphwidth
Added ability to tailor the tick text
Added vertices example to vignette
Changes for 1.2
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
Changes for 1.1
Multiple lines can now have NA values
Added ability to position the graph
Added ability to generate horizontal lines
Minor documentation changes
Changes for 1.0
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