ggstatsplot

MAJOR CHANGES

• The feature to superimpose normality curve on a histogram (in gghistostats()) has been removed.
  This feature always felt like an ad hoc addition to the plot, and has nothing to do with the key
  statistical analysis in question (which is not about checking the normality of the distribution).

MINOR CHANGES

• Updates code to fix warnings coming via updates to easystats packages.

BUG FIXES

• Empty groups in factors are no longer dropped in ggpiestats() and ggbarstats() (#935).

MAJOR CHANGES

• The cryptic but very useful parameter k has been renamed to digits to
  improve its discoverability.

• To be consistent with other functions, ggpiestats() and ggbarstats() now
  default to two-sided alternative hypothesis.

BREAKING CHANGES

• To be internally consistent, the plot.type argument has been removed from
  ggbetweenstats(), since no such argument exists for ggwithinstats(). This
  argument was also redundant. Since removing a specific geom is straightforward
  using *.args arguments. Examples for these two functions illustrate how.

• ggbetweenstats() and ggwithinstats() retire pairwise.comparisons
  argument since it was redundant. In order to turn off showing pairwise
  comparisons, you can now use pairwise.display = "none".

NEW FEATURES

• ggbetweenstats() gets boxplot.args argument to pass additional arguments
  to the underlying geom function. This also fixes regression introduced in
  0.11.1 release where outlier points were displayed along with box plot.

BREAKING CHANGES

• The outlier tagging functionality in ggbetweenstats() and ggwithinstats()
  has been removed. It was too crude to be useful or reliable, and users should
  instead prefer more informative methods (e.g. performance::check_outliers()).

MINOR CHANGES

• Fix failures due to changes in {parameters}.

BREAKING CHANGES

• The minimum needed R version is now bumped to R 4.1 because a crucial
  dependency ({pbkrtest}) requires this R version.

MINOR CHANGES

• Maintenance release to catch up with {ggplot2} and {easystats} updates.

BREAKING CHANGES

• The output parameter for all functions has been removed. All functions now
  return only the plot, which itself contains all necessary details that were
  previously extracted using the output argument. You can extract all the
  necessary details (including expressions containing statistical details)
  from a plot using extract_stats() function. There are two additional helpers
  to get expressions: extract_subtitle() and extract_caption().

MAJOR CHANGES

• xfill and yfill arguments for ggscatterstats() have been removed. You
  can specify all aesthetic modifications for side histograms in scatter plot
  using xsidehistogram.args and ysidehistogram.args arguments.

• Updates to changes made in the latest {ggplot2} release (3.4.0).

MAJOR CHANGES

• Due to changes to the underlying API of {parameters}, the effsize argument
  has been renamed to effectsize.type.

• Removes unnecessary re-exports of {tidyverse} operators.

MINOR CHANGES

• Fixes tests for changes in dependencies.

MINOR CHANGES

• Internal housekeeping to adjust to changes in upstream dependencies.

MINOR CHANGES

• Hot fix release to correct a failing example in CRAN daily checks.

MAJOR CHANGES

• The pairwise_comparions() function implementation now lives in
  {statsExpressions} package, although it will continue to be exported from
  {ggstatsplot} package.

• The details about pairwise test for ggbetweenstats() and ggwithinstats()
  functions are now displayed as a label for the secondary axis. Previously,
  this information was displayed in the caption. Given that caption already
  contained Bayesian test details, it was becoming difficult to stack
  different expressions on top of each other. To avoid unnecessary code
  complexity and also to avoid crowded caption, this decision was made.
  Additionally, the pairwise test label has been slightly abbreviated, and so
  is the label for significance bars. This is done to not let the text
  overwhelm the numeric values, the latter being more important.

MAJOR CHANGES

• Moves {PMCMRplus} package from Imports to Suggests. So, if, as a user, you
  wish to use pairwise comparisons in ggbetweenstats() and
  ggwithinstats(), you will need to download this package.

MINOR CHANGES

• To keep the documentation maintainable, a number of vignettes have either
  been removed or they are no longer evaluated and only code is reported.

NEW FEATURES

• The pairwise_comparisons() function for carrying out one-way pairwise
  comparisons has now moved in {ggstatsplot} from {pairwiseComparisons}
  package.

BREAKING CHANGES

• A number of effect size estimates and their confidence intervals have
  changed due to respective changes made in {effectsize} package version
  0.5 release. For full details of these changes, see:
  https://easystats.github.io/effectsize/news/index.html

• For the same reason, the effect size for one-way contingency table has
  changed from Cramer's V to Pearson's C.

MAJOR CHANGES

• For plotting marginal distributions in ggscatterstats, {ggstatsplot} now
  relies on ggside package instead of ggExtra. This was done to remove a
  glaring inconsistency in the API. All functions in {ggstatsplot} produced
  ggplot objects and could be further modified with ggplot2 functions,
  except ggscatterstats, which led to a lot of confusion among users (e.g.
  #28). This change gets rid of this inconsistency. But it comes at a cost:
  there is no more marginal.type argument that lets you change the type of
  marginal distribution graphic and histogram is the only possible option.
  Note that this is not a breaking change. Your past code will continue to
  work but it will now always produce a histogram instead of other marginal
  graphic you might have chosen.

• Minimum needed R version is now 4.0.

MINOR CHANGES

• Online vignette about combine_plots has been removed. In case you want to
  create a grid of plots, it is highly recommended that you use patchwork
  package directly and not this wrapper around it which is mostly useful with
  {ggstatsplot} plots.

• ggscatterstats labeling arguments accept only unquoted inputs now, and not
  quoted or string inputs. Allowing this was a bad design choice in the past
  since most functions in {ggstatsplot}, inspired by tidyverse, expect
  unquoted (x) - and not quoted ("x") - arguments. So this function was
  the odd one out.

• Gets rid of ipmisc dependency.

• Removes movies_wide dataset, which was virtually identical to
  movies_long dataset and was not used anywhere in the package. Also removes
  the unused VR_dilemma dataset.

NEW FEATURES

• Adds extract_stats function to extract dataframes containing statistical
  details.

MAJOR CHANGES

• There is finally a publication for {ggstatsplot} package!
  https://joss.theoj.org/papers/10.21105/joss.03167

• The ggcoefstats function defaults to NULL for xlab and ylab
  arguments, which lets users change these labels if they wish to do so.
  Additionally, the x-axis label, if not specified, now defaults to
  "estimate". Whether this estimate corresponds to regression coefficient or
  effect size like partial eta-squared should be clear from the label itself.

• To reduce the dependency load, ggcorrplot moves from Imports to
  Suggests.

• The bar.fill argument in gghistostats is retired in favor of the new
  bin.args argument that can be used to pass aesthetic arguments to
  ggplot2::stat_bin.

• ggstatsplot.layer argument has been retired. If the user chooses a
  certain ggplot2 theme, it means they want that theme, and not
  {ggstatsplot}'s varnish on it. So the previous behavior was undesirable.
  This is a backward compatible change, so the plots should not look
  different.

MINOR CHANGES

• The pch size for ggcorrmat has been increased to 14 (#579) to increase
  its visibility compared to the correlation value text.

• ggwithinstats gains point.args to change geom_point.

• Minor change to ggcorrmat legend title - content in parentheses is now
  shown outside of it.

BUG FIXES

• ggcoefstats didn't work when statistic for the given model was
  chi-squared. This has been fixed.

MAJOR CHANGES

• To reduce the dependency load, ggExtra moves from Imports to
  Suggests.

• All functions are more robust in the sense that when statistical analysis
  fails, they will return only the plots with no subtitles/captions. This
  helps avoid difficult-to-diagnose edge case failures when the primary
  functions are used in grouped_ functions (e.g., #559). The ggpiestats
  and ggbarstats functions always behaved this way, but the rest of the
  functions now also mimic this behavior.

MINOR CHANGES

• The ggcoefstats labels do not contain degrees of freedom when they are not
  available instead of displaying Inf.