Changelog
Source:NEWS.md
ggpmisc 0.6.0
 Add ellipsis parameter (
...
) touse_label()
so that in addition to a character vector of label names passed to parameterlabels
, separate strings for each name are now also accepted.  Support decreasingpower order of polynomial terms in the labels generated by
stat_poly_eq()
,stat_quant_eq()
andstat_ma_eq()
(not in the input!).  In
stat_quant_eq()
return newqtl.label
for quantiles, separately fromgrp.label
, which now works only based on a pseudo aesthetic, as instat_poly_eq()
andstat_ma_eq()
. This is a soft code breaking change affecting the rendering of model equation labels in some plots.  Define function
check_poly_formula()
and use it instat_poly_eq()
andstat_quant_eq()
to validate that the usersupplied model formula is a polynomial with terms in order of increasing powers, except whenoutput.type = "numeric"
. If not validated,NA
is returned as formatted character string for the equation label.  Statistics
stat_poly_eq()
,stat_ma_eq()
,stat_quant_eq()
,stat_correlation()
, andstat_multcomp()
were in part reimplemented, introducing small visual changes in the formatting of labels, including changes in the default number of digits in very few cases.  Export the new utility functions now used internally for formatting parameter estimates into character strings in
stat_poly_eq()
,stat_ma_eq()
,stat_quant_eq()
,stat_correlation()
, andstat_multcomp()
.  Implement R options
ggpmisc.small.p
,ggpmisc.small.r
andggpmisc.decreasing.poly.eq
. Obey R option “verbose” by displaying additional informative messages.  Allow userdefined fit methods passed as argument to
stat_poly_eq()
,stat_poly_line()
,stat_ma_eq()
,stat_ma_line()
,stat_quant_eq()
,stat_quant_line()
, andstat_quant_band()
to return an atomicNA
or a length zero object to skip labelling or plotting related to the attempted model fit.  The redundant, and for a long time deprecated formal parameters
label.x.npc
andlabel.y.npc
have been removed. This is a code breaking change, preceded by a long deprecation period. To update broken code, simply replacelabel.y.npc
bylabel.y
andlabel.x.npc
bylabel.x
in the call still passing the same arguments.
ggpmisc 0.5.6
CRAN release: 20240507
 Rename parameter
trans
ofscale_y_Pvalue()
intotransform
to track deprecation in ‘ggplot2’ 3.5.0.  Revise
stat_multcomp()
to flexibly include in labels, both when using “bars” and “letters”, the abbreviated name of the method used to adjust Pvalues (suggested by markbneal, Mark Neal).  Revise
stat_multcomp()
to flexibly include only when using “letters” an additional label with the critical Pvalue and the method used to adjust the empirical Pvalues (suggested by markbneal, Mark Neal).  Revise
stat_multcomp()
to support arbitrary sets of pairwise contrasts.  Rename parameters of
stat_multcomp()
:adjusted.type
top.adjust.method
, andconstrast.type
tocontrasts
.  Change defaults used for
p.adjust.method
so that they depend on the argument passed tocontrasts
.  Accept in
stat_correlation()
,stat_poly_eq()
,stat_ma_eq()
, andstat_multcomp()
,p.digits = Inf
as a request to use scientific notation forp.value.label
(suggested by wbvguo, Wenbin Guo).  Fix bug in
stat_multcomp()
: wrongly encoded letters in Tukey contrasts in case of grouping factors with more than nine levels.  Fix bug in
stat_multcomp()
: warning issued bymvtnorm::pmvnorm()
because of convergence failure in Tukey contrasts in case of grouping factors with more than approximately 5 to 7 levels. Convergence failure also meant slightly different Pvalues returned in different runs in these cases.  Fix bug in
stat_multcomp()
: offplot letter labels with Tukey contrasts in some plots with more than five groups.
ggpmisc 0.5.5
CRAN release: 20231115
 Fix decoding of
orientation
from formula to allow function calls on the rhs of formulas, e.g.,I(y  10) ~ x
orI(x  10) ~ y
.  Export function
find_peaks()
which was previously internal.  Move transcriptomics example data objects to package ‘ggpp’.
 Fix scrambled table in the vignette (reported by markbneal, Mark Neal).
ggpmisc 0.5.4
 Add
stat_multcomp()
that computes adjusted pvalues and constructs labels to annotate plots with results from multiple comparisons based on “Tukey” or “Dunnet” contrasts.  Fix bug affecting position of labels, e.g., when observations are not plotted: use scale range instead of data range.
 Confidence intervals for r in
stat_correlation()
are no longer computed by default for methods other than Pearson, as when using bootstrap the computation can be timeconsuming and occasionally fail. Previous default can be restored by passing0.95
as argument tor.conf.level
.
ggpmisc 0.5.3
CRAN release: 20230624
 Fix bug in
stat_ma_line()
: error triggered when returned values from computation of confidence band are missing. (Reported by rakelrpf as issue #36.)  Fix bug in
stat_quant_eq()
:rho.label
showed the numeric value of AIC instead of rho.  Fix incompatibility of
stat_poly_eq()
(and other statistics) with package ‘gganimate’ (Bug reported by EvoLandEco as issue #38).  Improve handling of singular fits in model fitting in
stat_poly_eq()
,stat_ma_eq()
andstat_quant_eq()
(Use case from EvoLandEco in issue #38.).  Add parameter
n.min
to all statistics that fit a model or compute correlations. Default value is the previously hardcoded value, except in one case where the previously hardcoded value was wrong.  Add
stat_fit_fitted()
.
ggpmisc 0.5.2
CRAN release: 20221217
 Fix bug caused by the use of
base::isa()
which is not supported for"formula"
in R < 4.1.0 (reported by Johnny Le).  Fix bug in
stat_peaks()
andstat_valleys()
that made peak and valley labels for datetime variables mapped to x to be always formatted in the local system’s timezone instead of in the timezone of the x scale of the ggplot.  Fix bug in
stat_poly_eq()
,stat_ma_eq()
,stat_quant_eq()
, andstat_correlation()
that caused some labels not to obey R optionOutDec
. (Problem described at Stackoverflow.)
ggpmisc 0.5.1
CRAN release: 20221015
 Revise approach used to extract the formula from the fitted model object. Use
formula()
method on fitted model but fallback onto the ‘formula’ argument in case of error or returnNA
if everything fails, without triggering an error condition.  Always include variables
fm.tb.type
,fm.class
,fm.method
,fm.formula
, andfm.formula.chr
in the data returned bystat_fit_tb()
, and renamemf_tb
intofm.tb
for naming consistency.  Always include variable
fm.formula
in the data returned by all other textualannotation statistics based on model fitting.  Include variables
fm.class
,fm.method
, andfm.formula.chr
in addition tofm.formula
in the data returned by line plotting statistics based on model fitting when passed argumentfm.values = TRUE
.  Add
scale_colour_logFC()
,scale_color_logFC()
andscale_fill_logFC()
.  Revise
scale_colour_outcome()
andscale_fill_outcome()
adding flexibility to thevalue
names and allowing a workaround for nonfunctionaldrop
in manual scales due to a bug present in ‘ggplot2’ (only in versions 3.3.4, 3.3.5, 3.3.6).  Revise User Guide.
 Update for compatibility with upcoming ‘ggplot2’ 3.4.0 (tested with v3.4.0rc).
ggpmisc 0.5.0
CRAN release: 20220812
 Differently to the use in the R literature
mf
has been used in this package, instead offm
, to signify fitted model. This has changed in this version as formal parametermf.values
has been renamedfm.values
and variablemf_tb
in values returned by statistics renamedfm.value
. Although these are code breaking changes, they are likely to cause difficulties only in isolated cases as defaults rarely need to be overridden.  Add function
use_label()
that greatly simplifies assembling and mapping combined labels from the values returned bystat_poly_eq()
,stat_ma_eq()
,stat_quant_eq()
andstat_correlation()
.  Add variables
fm.tb.type
,fm.class
,fm.method
, andfm.formula.chr
to the data returned bystat_fit_tb()
, and renamemf_tb
intofm.tb
for naming consistency.  Add variables
fm.class
,fm.method
, andfm.formula.chr
to the data returned by all other textualannotation statistics statistics based on model fitting.  Add confidence intervals for R (Pearson’s OLS correlation), τ (Kendall’s rank correlation) and ρ (Spearman’s rank correlation) to the values and labels returned by
stat_correlation()
. In the case ofmethod = "pearson"
assuming Normal distribution or estimated by bootstrap. Formethod = "kendall"
andmethod = "spearman"
only bootstrap estimates. These are implemented using package ‘confintr’.  Add confidence interval for R^{2} to the values and labels returned by
stat_poly_eq()
(implemented using package ‘confintr’).  Add θ (theta) to the values and labels returned by
stat_ma_eq()
.  Add
method.label
to the data returned bystat_correlation()
,stat_poly_eq()
,stat_ma_eq()
andstat_quant_eq()
.  Add experimental functions
keep_tidy()
,keep_glance()
andkeep_augment()
as wrappers on methodstidy()
,glance()
andaugment()
from package ‘broom’. These new functions make it possible to keep a trace of the origin of the “broomtidied” outputs.  Update documentation and User Guide.
ggpmisc 0.4.7
CRAN release: 20220615
 Fix bug in the handling of the
weight
aesthetic instat_poly_eq()
,stat_poly_line()
,stat_quant_eq()
andstat_quant_line()
.  The model formula is in calls to
stat_poly_eq()
andstat_quant_eq()
now retrieved from the returned fitted model object before constructing the equation label. This makes it possible model selection within the function passed as argument tomethod
. (Inspired by an answer read in Stackoverflow.)  Statistics now search for a matching function when an arbitrary name is supplied as a character string argument to parameter
method
.  The character string passed as argument to parameter
method
is now parsed so that it can contain both the name of a model fit function and the argument to be passed to this function’s ownmethod
parameter. (Backward compatibility is maintained.)  The stats that create equation labels now include a variable
method
in the returneddata
containing a character string with the method used in the model fit.
ggpmisc 0.4.6
CRAN release: 20220410
This update fixes a significant bug. Although the problem, when triggered, is obvious by looking at the plot, please, update.
 Fix bug in
stat_peaks()
andstat_valleys()
. They could return wrong values for peaks and valleys if the rows indata
in the ggplot object were not sorted by the value of x for all arguments tospan
different from null.
ggpmisc 0.4.5
CRAN release: 20211211
This is a minor update for compatibility with ‘ggpp’ (>= 0.4.3) and fixing a wrong version number for ‘gginnards’ in DESCRIPTION.
ggpmisc 0.4.4
CRAN release: 20211031
An issue raised in GitHub and a question in StackOverflow asked for the possibility of changing how fitted lines are plotted based on the goodness of the fit. In addition an old question in StackOverflow highlighted the need of more intuitive support for annotations based on stats::cor.test()
. We implemented these requested enhancements and continued adding support for flipping of statistics through parameter orientation
as implemented in ‘ggplot2’ since version 3.3.0.
Update
stat_poly_line()
to optionally add columnsn
,p.value
,r.squared
,adj.r.squared
andmethod
to the returned data frame. This statistic no longer supports fitting of splines with methods such asloess
. This could potentially break user code, in which case the solution is to usestat_smooth()
.Update
stat_ma_line()
to optionally add columnsn
,p.value
,r.squared
andmethod
to the returned data frame. (As only a slope can be fitted,adj.r.squared
is irrelevant.)Update
stat_quant_line()
andstat_quant_band()
to optionally addn
andmethod
columns to the returned data frame. (No exact equivalent ofr.squared
exists for quantile regression.)Update
stat_fit_residuals()
to optionally return weighted residuals.Update
stat_peaks()
andstat_valleys()
to allow flipping with new parameterorientation
.New function
stat_correlation()
to annotate plots with correlation estimates, their Pvalue, a test statistic and n computed withstats::cor.test()
. Numeric values are included in the returned data frame to facilitate conditional display.
ggpmisc 0.4.3
CRAN release: 20210903
Add statistics stat_ma_line()
and stat_ma_eq()
implementing model II regression based on package ‘lmodel2’ (major axis, standard major axis, and ranged major axis regression). Methods coef()
, confint()
and predict()
for fit objects returned by lmodel2::lmodel2()
are also implemented and exported.
Removed setting of fill to light blue in stat_quant_band()
as there is no safe way of overriding the geom’s default.
ggpmisc 0.4.22
Fix major bug in stat_poly_eq()
and stat_quant_eq()
affecting only some R builds, reported and reproduced for Linux. (Reported by Flavio LozanoIsla, T. BruceLee and Lewis Hooper, debugged with the help of Mark B. Neal.) Reported to affect versions 0.4.0, 0.4.1, 0.4.2 and 0.4.21.
ggpmisc 0.4.21
CRAN release: 20210815
Fix a bug remaining in 0.4.2, that could result in after_stat()
not being found. (Reported by Prof. Brian Ripley and Michael Steinbaugh.)
ggpmisc 0.4.2
CRAN release: 20210804
Changes to Depends, Imports and Suggests, to solve errors and/or to avoid dependencies that are not needed. As a consequence package ‘broom’ is no longer automatically installed as a dependency of ‘ggpmisc’ and if used, will need to be explicitly installed by the user. Several examples are now run only if the necessary packages have been installed (Prof. Brian Ripley, Uwe Ligges and members of the CRAN’s team are thanked for package quality control).
ggpmisc 0.4.1
CRAN release: 20210802
The suggestion from Mark Neal of adding support for quantile regression partly addressed in ggpmisc 0.4.0 has lead to additional enhancements in this version. The idea of supporting confidence bands for quantile regression came from Samer Mouksassi who also provided code examples. Additional suggestions from Mark Neal, Carl and other users have lead to bug fixes as well as to an interface with better defaults for arguments (see issue #1). Some other enhancements are based on my own needs or ideas.
 Add support for robust regression using
rlm
and for fitfunction
objects instat_poly_eq()
.  Make it easier to use
stat_poly_eq()
andstat_quant_eq()
withformula = x ~ y
and other models in which the explanatory variable isy
in addition to models withx
as explanatory variable (this was already supported but the defaults foreq.with.lhs
andeq.x.rhs
were hard coded needing manual override while they are now set dynamically depending on theformula
).  Revise
stat_poly_eq()
andstat_quant_eq()
so that they pass to the geom by default a suitable value as argument toparse
depending onoutput.type
(enhancement suggested by Mark Neal in issue #11) and so that the defaultoutput.type
is"markdown"
if the argument passed togeom
is one of"richtext"
or"textbox"
, improving compatibility with package ‘ggtext’.  Revise
stat_poly_eq()
andstat_quant_eq()
so that whenoutput.type = "numeric"
they return the coefficient estimates asnumeric
columns indata
(problem withcoefs.ls
column in data when using facets reported by cgnolte in issue #12).  Revise
stat_poly_eq()
adding support for optional use of lower case r and p for R^{2} and Pvalue, respectively.  Fix bug in
stat_poly_eq()
andstat_quant_eq()
resulting in mishandling of formulas using the+ 0
notation to exclude the intercept (reported by orgadish in issue #10).  Add
stat_poly_line()
, which is a new interface toggplot2::stat_smooth()
acceptingformula = x ~ y
and other models in which the explanatory variable isy
rather thanx
or settingorientation = "y"
. In contrast toggplot2::stat_smooth(),
stat_poly_line()
has"lm"
as default formethod
irrespective of the number of observations.  Add
stat_quant_line()
which is a merge ofggplot2::stat_smooth()
andggplot2::stat_quantile()
acceptingformula = x ~ y
and other models in which the explanatory variable isy
rather thanx
or settingorientation = "y"
to fit models withx
as explanatory variable. This statistic makes it possible to add to a plot a double quantile regression.stat_quant_line()
supports plotting of confidence bands for quantile regression usingggplot2::geom_smooth()
to create the plot layer.  Add
stat_quant_band()
which plots quantile regressions for three quantiles as a band plus a line, acceptingformula = x ~ y
and other models in which the explanatory variable isy
rather thanx
or settingorientation = "y"
to fit models withx
as explanatory variable. By default the band uses"steelblue"
asfill
, to distinguish them from confidence bands.  Add support for quantile regression
rq
, robust regressionrlm
, and resistant regressionlqs
andfunction
objects tostat_fit_residuals()
andstat_fit_deviations()
.  Make it possible to use
stat_fit_residuals()
andstat_fit_deviations()
withformula = x ~ y
and other models in which the explanatory variable isy
in addition to models withx
as explanatory variable.  Add
weights
to returned values bystat_fit_residuals()
andstat_fit_deviations()
and add support for theweight
aesthetic as their input for parameterweights
of the model fit functions.  Revise
stat_poly_eq()
andstat_quant_eq()
so that by default they keep trailing zeros according to the numbers of significant digits given bycoef.digits
. A new parametercoef.keep.zeros
can be set toFALSE
to restore the deletion of trailing zeros. Be aware that even if the character label for the equation contains trailing zeros, if it is parsed into R an expression (as it is by default) the trailing zeros will be dropped at this later stage. Trailing zeros in the equation will be rendered to the plot only ifoutput.type
is other than"expression"
. Equations and other labels may render slightly differently than in previous versions as nowsprintf()
is used to format all labels.  Fix bug in
stat_poly_eq()
andstat_quant_eq()
that resulted in bad/nonsyntactical character strings foreq.label
whenoutput.type
was different from its default of"expression"
.
ggpmisc 0.4.0
CRAN release: 20210603
Package ‘ggpmisc’ has been split into two packages: ‘ggpp’ containing extensions to the grammar of graphics and ‘ggpmisc’ containing extensions related to plot decorations based on model fits, statistical summaries and other descriptors of the data being plotted. Package ‘ggpmisc’ depends on ‘ggpp’ with no visible changes for users. Package ‘ggpp’ can be loaded instead of ‘ggpmisc’ when only the extensions it contains are needed. Package ‘gginnards’ containing tools for editing ggplot objects as well as tools for inspecting them is an earlier spinoff from ‘gpmisc’.
The changes in this version stem for users’ questions and suggestions. Many thanks!
Add
stat_quant_eq()
based on quantile regression as implemented in package ‘quantreg’. (enhancement suggested by Mark Neal)Add
n.label
andn
to the values returned bystat_poly_eq()
andstat_quant_eq()
. (enhancement suggested by a question from ganidat)Add
r.squared
,adj.r.squared
,p.value
andn
asnumeric
values returned in addition to the correspondingcharacter
labels whenstat_poly_eq()
is called withoutput.type
other thannumeric
. Similarly forn
andrho
in the case ofstat_quant_eq()
. (enhancement suggested by a question from Tiptop)Fix bug in
stat_poly_eq()
leading to empty returned value when data contains too few observations to fit the model. (reported by ganidat)Add support for quantile regression
rq
, robust regressionrlm
, and resistant regressionlqs
andfunction
objects tostat_fit_deviations()
.
ggpmisc 0.3.9
CRAN release: 20210404
 Update the documentation of
geom_plot()
.  Revise handling of rounding for R^{2} and Pvalue in
stat_poly_eq()
.  Fix bug in
stat_poly_eq()
that resulted in no labels being displayed for any group when one group has too few distinct xvalues to fit the polynomial (reported by user 5432156 “ganidat” in StackOverflow).  [Under development!] Link repositioned text to its original position with a segment or arrow:
geom_linked_text()
. Except for the drawing of segments or arrows this new geometry behaves asggplot2::geom_text()
. Note: Segments and arrows are drawn only if the position function used returns both the repositioned and original coordinates.  Add support for advanced nudging:
position_nudge_centre()
andposition_nudge_line()
compute the direction of nudging and return both the nudged and original positions.  Add support for simple nudging:
position_nudge_to()
nudges to new usersupplied position(s);position_nudge_keep()
nudges to position(s) based on usersupplied position shift. These functions return both nudged and original position(s), which makes possible to draw connecting segments from text labels to the original position.
ggpmisc 0.3.81
CRAN release: 20210127
 Fix bug: suggested package not loaded in vignette ModelBased Plot Annotations resulting in “method not found” warning in some examples.
ggpmisc 0.3.8
CRAN release: 20210125

CODE BREAKING: functions
stat_fit_glance()
,stat_fit_augment()
,stat_fit_tidy()
andstat_fit_tb()
now import the tidiers from package ‘generics’ instead of from ‘broom’. As a result, users must now explicitly load the package where the methods to be used are defined, such as ‘broom’ or ‘broom.mixed’ or define them before calling these statistics.  Add formal parameter
glance.args
tostat_fit_glance()
, parametertidy.ars
tostat_fit_tidy()
andstat_fit_tb()
and parameteraugment.args
tostat_fit_augment()
as some specializations ofbroom::glance()
,broom::tidy()
andstat_fit_augment()
accept arguments specific to a given fitting method.  Fix bug:
stat_fit_tidy()
would fail withquantreg::rq()
and any other fit methods that do not return by default standard error estimates for parameter estimates (Thanks to Mark Neal for reporting the problem).  Revise
stat_fit_glance()
,stat_fit_augment()
andstat_fit_tidy()
to ensure compatibility withcor.test()
and other functions that require an object rather than a quoted expression as argument fordata
.  Add formal parameter
p.digits
tostat_fit_tb()
.  New vignette explaining how the grammar of graphics has been expanded to better support annotations.
 Fix bug:
try_tibble.ts()
andtry_data_frame()
did not handle correctly the conversion of dates for some time series, which also could affectggplot.ts()
.  Fix bug:
stat_peaks()
andstat_valleys()
generated wrong labels if aDate
object was mapped to x (the bug did not affect POSIX or datetime, and was obvious as it resulted in a shift in dates by several decades).  Move git repository from Bitbucket to Github. Numbering of issues restarts from #1, but all old commits were transferred as is.
 Set up Github action for CRANchecks on Windows, OS X and Ubuntu.
ggpmisc 0.3.7
CRAN release: 20201109
 Update
stat_fit_tb()
to support renaming of terms/parameter names in the table (Suggested by Big Old Dave and Z. Lin). In addition implement selection, reordering and renaming of columns and terms/parameters using positional indexes and pattern matching of truncated names in addition to whole names. Improve formatting of small Pvalues.  Update
stat_fmt_tb()
to support the same expanded syntax asstat_fit_tb()
.  Add
stat_dens1d_filter()
,stat_dens1d_filter_g()
andstat_dens1d_labels()
, to complement existingstat_dens2d_filter()
,stat_dens2d_filter_g()
andstat_dens2d_labels()
.  Update
stat_dens2d_filter()
,stat_dens2d_filter_g()
andstat_dens2d_labels()
adding formal parameterskeep.sparse
andinvert.selection
, as available in the new 1D versions.  Update
stat_dens2d_labels()
to accept not only character strings but also functions as argument tolabel.fill
as the newstat_dens1d_labels()
does.  Revise documentation including the User Guide.
ggpmisc 0.3.6
CRAN release: 20200907
 Override
ggplot2::annotate()
adding support for aestheticsnpcx
andnpcy
.  Add
stat_summary_xy()
andstat_centroid()
.  Revise
stat_poly_eq()
to support labelling of equations according to group.  Implement
output.type
"markdown"
instat_poly_eq()
usable withgeom_richtext()
from package ‘ggtext’.
ggpmisc 0.3.5
CRAN release: 20200601
 Add support for “table themes” to geom_table() and
geom_table_npc()
.
ggpmisc 0.3.4
CRAN release: 20200422
 Add support for p.value.label and f.value.label to
stat_poly_eq()
.  Update to track deprecations in ‘ggplot2’ (>= 3.3.0).
ggpmisc 0.3.3
CRAN release: 20191201
 Fix bug in
stat_poly_eq()
.  Minor revision of the User Guide and documentation.
ggpmisc 0.3.2
CRAN release: 20191111
This version implements some new features and fixes bugs in the features introduced in version 0.3.1, please do rise an issue if you notice any remaining bugs! Some reported weaknesses in the documentation have been addressed. This updated version depends on ‘ggplot2’ (>= 3.2.1).
Add support for volcano and quadrant plots of outcomes.
Add geometries
geom_vhlines()
andgeom_quadrant_lines()
.Add convenience scales
scale_x_logFC()
andscale_y_logFC()
for data expressed as fold change.Add convenience scales
scale_x_Pvalue()
, scale_y_Pvalue(),scale_x_FDR()
,scale_y_FDR()
.Add convenience scales
scale_colour_outcome()
,scale_fill_outcome()
andscale_shape_outcome()
for data expressed as ternary or binary outcomes.Add conversion functions
outcome2factor()
andthreshold2factor()
to convert vectors of numeric outcomes into factors with 2 or 3 levels.Add conversion function
xy_outcomes2factor()
andxy_thresholds2factor()
to combine two vectors of numeric outcomes into a 4level factor.Improve support for modelfit annotations.
Update
stat_poly_eq()
so that optionally instead of text labels it can return numeric values extracted from the fit object.Document with examples how to pass weights and covariates to statistics based on methods from package ‘broom’. Highlight the differences among
stat_poly_eq()
and thestat_fit_xxx()
statistics implemented using package ‘broom’.Revise
stat_apply_fun()
to allow simultaneous application of functions to x and y aesthetics, and handling ofdiff()
and other functions returning slightly shorter vectors than their input.Support in
stat_fit_tb()
,stat_fit_augment()
,stat_fit_tidy()
andstat_fit_glance()
the use of character strings as position arguments for parameterslabel.x
andlabel.y
when using geoms based on x and y aesthetics in addition to when using those taking thenpcx
andnpcy
aesthetics.
ggpmisc 0.3.1
CRAN release: 20190402
This is a major update, with a few cases in which old code may need to be revised to work, and many cases in which there will be subtle differences in the positions of labels used as annotations. The many new features may still have some bugs, please do rise an issue if you notice one!
Version requiring ‘ggplot2’ (>= 3.1.0).
Add new geometries, several of them accepting x and y in npc units through the new aesthetics npcx
and npcy
, allowing positioning relative to plotting area irrespective of native data units and scale limits. These geometries are useful on their own for annotations in particular they allow consistent positioning of textual summaries. By default they do not inherit the plot’s aesthetic mappings making their behaviour remain by default inbetween that of true geometries and that of annotate().
 Add
geom_text_npc()
andgeom_label_npc()
using aesthetics npcx and npcy.  Add
geom_table_npc()
using aesthetics npcx and npcy.  Add
geom_plot()
andgeom_plot_npc()
which can be used to add inset plots to a ggplot.  Add
geom_grob()
andgeom_grob_npc()
which can be used to add inset grobs to a ggplot.  Add
geom_x_margin_point()
,geom_y_margin_point()
,geom_x_margin_arrow()
andgeom_y_margin_arrow()
which behave similarly togeom_hline()
andgeom_vline()
but plot points or arrows instead of lines. Addgeom_x_margin_grob()
andgeom_y_margin_grob()
with similar behaviour but for adding grobs.  Revise textualsummary statistics to use the new npc version of geometries.
 This may break old code that used
geom_table()
and depended on the old default ofinherit.aes=TRUE
.  Add “summarize” statistics for groups and panels.
 Add
stat_apply_panel()
andstat_apply_group()
.  Add workaround to
stat_fit_glance()
and improve diagnosis of unsupported input. Replace bad example in the corresponding documentation (workaround for bug reported by Robert White).  Update documentation.
 Add and revise examples.
 Revise vignette.
ggpmisc 0.3.0
CRAN release: 20180716
Version requiring ‘ggplot2’ (>= 3.0.0), now in CRAN. Low level manipulation and debug methods and functions moved to new package ‘gginnards’ available through CRAN.
 Remove debug stats and geoms > ‘gginnards’.
 Remove layer manipulation functions > ‘gginnards’.
 Add support for “weight” aesthetic in
stat_poly_eq()
(fixing bug reported by S.AlKhalidi).  Add support for column selection and renaming to
stat_fit_tb()
.  Add new statistic
stat_fmt_tb()
for formatting of tibbles for addition to plots as tables.  Rename
stat_quadrat_count()
intostat_quadrant_count()
(missspelling).  Revise vignette.
ggpmisc 0.2.17.9902
NonCRAN version with additional functionality, but requiring the development version of ‘ggplot2’.
 Track code breaking change in ‘ggplot2’ commit #2620 (20180517).
ggpmisc 0.2.17.9900
NonCRAN version with additional functionality, but requiring the development version of ‘ggplot2’ >= 2.2.1.9000 (>= commit of 20170209) from Github. Visit

geom_table()
, a geom for adding a layer containing one or more tables to a plot panel. 
stat_fit_tb()
a stat that computes a tidy tabular version of the summary or ANOVA table from a model fit.
ggpmisc 0.2.17
CRAN release: 20180504
CRAN version
Add
stat_quadrat_count()
a stat that computes the number of observations in each quadrant of a plot panel ignoring grouping.Fix bugs, one of which is code breaking: the names of returned parameter estimates have changed in
stat_fit_tidy()
now pasting"_estimate"
to avoid name clashes with mapped variables.
ggpmisc 0.2.16
CRAN release: 20170917
 Revise
stat_fit_tidy()
so that it returns pvalues for parameters, in addition to estimates and their standard errors.  BUG FIX: Revise
geom_debug()
adding missing default arguments.  Add functions for manipulation of layers in ggplot objects:
delete_layers()
,append_layers()
,move_layers()
,shift_layers()
,which_layers()
,extract_layers()
,num_layers()
,top_layer()
andbottom_layer()
.
ggpmisc 0.2.15
CRAN release: 20170514
Add stat_fit_tidy()
implemented using broom::tidy()
. Makes it possible to add the fitted equation for any fitted model supported by package ‘broom’, as long as the user supplies within aes() the code to build a label string. Update user guide.
ggpmisc 0.2.14
CRAN release: 20170202
Fix bug in stat_poly_equation()
eq.x.rhs
argument ignored when using expressions.
ggpmisc 0.2.13
CRAN release: 20161126
 Fix bugs in
try_tibble()
andtry_data_frame()
which made them fail silently with some objects of class"ts"
in the case of numeric (decimal date) index for time. In addition lack of special handling for classes"yearmon"
and"yearqrt"
from package ‘zoo’, lead to erroneous date shifts by a few days.  Add methods
ggplot.ts()
andggplot.xts()
.
ggpmisc 0.2.12
CRAN release: 20161022
 Change default value for parameter
label.fill
instat_dens2d_labels()
fromNA
to""
.  Improve documentation using current ‘ggrepel’ version, which implements changes that make
stat_dens2d_labels()
useful.
ggpmisc 0.2.11
Add
stat_dens2d_labels()
, a statistic that resets label values toNA
by default, or any character string supplied as argument, in regions of a panel with high density of observations.Add
stat_den2d_filter()
, a statistic that filtersout/filtersin observations in regions of a panel with high density of observations. These two statistics are useful for labeling or highlighting observations in regions of a panel with low density. Both stats use a compute_panel function.Add
stat_den2d_filter_g()
, a statistic that filtersout/filtersin observations in regions of a group with high density of observations. This statistics is useful for highlighting observations. It uses a compute_group function. They use internallyMASS:kde2d
to estimate densities and default values for parameters are adjusted dynamically based on the number of observations.
ggpmisc 0.2.10
CRAN release: 20160730
 Add userrequested feature: allow user to specify number ‘digits’ used in formatting numbers in labels in
stat_poly_eq()
.  Update
try_data_frame()
to return an object of class"tibble"
and addtry_tibble()
as synonym.  Update documentation and start using package ‘staticdocs’ to build a documentation web site.
ggpmisc 0.2.9
CRAN release: 20160618
 Add support for tikz in
stat_poly_eq()
.  Fix bug in
stat_poly_eq()
.  Fix bug in
geom_debug()
.  Fix bug in
stat_fit_augment()
.
ggpmisc 0.2.8
CRAN release: 20160522
Enhance
stat_poly_eq()
so that 1) position of labels according to npc (relative positions using normalized coordinates), as well as by named positions"top"
,"bottom"
,"right"
,"left"
and"center"
is now implemented; 2) when grouping is present, suitablevjust
values are computed to automatically position the labels for the different groups without overlap. Default label positions are now relative to the range of each panel’s x and y scales, eliminating in most cases the need to manually tweak label positions.Add
stat_fit_glance()
uses package ‘broom’ for maximum flexibility in model function choice when wanting to add labels based on information from a model fit, at the expense of very frequently having to explicitly set aesthetics, and always having to add code to do the formatting of the values to be used in labels. Label position is as described above forstat_poly_eq()
.Add
stat_fit_deviations()
for highlighting residuals in plots of fitted models. This statistic currently supports onlylm()
fits. By default geom “segment” is used to highlight the deviations of the observations from a fitted model.Add
stat_fit_residuals()
for plotting residuals from a fitted model on their own in plots matching plots of lm fits plotted with stat_smooth() even with grouping or facets. This statistic currently supports onlylm()
fits. By default geom “point” is used to plot the residual from a fitted model.Add preliminary version of
stat_fit_augment()
, which uses package ‘broom’ for maximum flexibility in model function choice, to augment the data with additional columns of values derived from a model fit.
ggpmisc 0.2.7
CRAN release: 20160322
 Add support for AIC and BIC labels to
stat_poly_eq()
.  Add prettyprinting of parameter values expressed in engineering notation in
stat_poly_eq()
.  Add support for usersupplied label coordinates in
stat_poly_eq()
.  Improve
stat_debug_panel()
and stat_debug_group() so that they can optionally print to the console a summary of the data received as input.  Add
geom_debug()
, a geom that summarizes its data input to the console, and produces no visible graphical output.
ggpmisc 0.2.6
CRAN release: 20160225
 Add support for usersupplied lhs and for usersupplied rhsvariable name in the equation label in
stat_poly_eq()
.
ggpmisc 0.2.4
 Improve handling of time zones in
try_data_frame()
.  Revise documentation and vignette.
ggpmisc 0.2.3

stat_poly_eq()
changed to include the lhs (left hand side) of the equation by default.
ggpmisc 0.2.2
Add function try_data_frame() to convert R objects including time series objects of all classes accepted by
try.xts()
into data frames suitable for plotting withggplot()
.Update
stat_peaks()
andstat_valleys()
to work correctly when the x aesthetic uses aDate
orDatetime
continuous scale such asggplot()
sets automatically forPOSIXct
variables mapped to the x aesthetic.
ggpmisc 0.2.1
 Rename
stat_debug()
asstat_debug_group()
and addstat_debug_panel()
.  Add
stat_peaks()
andstat_valleys()
(these are simpler versions ofggspectra::stat_peaks()
andggspectra::stat_valleys()
for use with any numerical data (rather than light spectra).