NEWS.md

In ggblanket: Simplify 'ggplot2' Visualisation

ggblanket 10.0.0

• Breaking: removed *_limits and *_oob arguments.
• Breaking: removed *_mode_n and grey_mode_* functions.
• Breaking: removed grey_mode_* functions.
• Breaking: removed greyness helper.
• Breaking: in set_blanket, removed annotate_* arguments.
• Breaking: removed *_orientation arguments from *_mode_* functions.
• Breaking: in *_mode_*, removed ticks_length_* arguments.
• Breaking: renamed aes_contrast to aes_colour_contrast.
• In set_blanket, added hierarchical arguments that set geom defaults.
• Added *_breaks_n arguments.
• Added *_sec_axis arguments.
• Added *_symmetric arguments.
• Added mode_orientation argument.
• Added weave_* sub-setup functions.
• Added mode_orientation_to_x and mode_orientation_to_y functions.
• Added aes_colour_* and aes_fill_* functions inspired by work by (@teunbrand).
• Made mode_orientation convert unneeded components to transparent.
• For discrete colour scales, improved the determination of the number of colours required.
• In *_mode_*, changed lineend to "square".
• Fixed bug in col_palette_* by adding ....

ggblanket 9.1.1

• Forced user argument naming for set_blanket(), *_mode_*() and aes_contrast().
• Fixed bug in colouring more discrete values than the set col_palette_d.
• Fixed bug in colouring with when col_palette_d was set with names not in the data.
• Removed mode_family argument from aes_contrast().
• Made *_mode_t() and *_mode_b() have legend.byrow = TRUE.
• Made *_mode_*() functions more intuitive to remove/adjust elements.
• Changed gg_sf default to keeping all major gridlines.
• Updated hex colour strings to caps.
• Fixed code that was making the base plot an extra time unnecessarily.
• Fixed bug where *_breaks and *_limits was not working.

ggblanket 9.1.0

• Moved mapping argument to within layer.
• Determine x and y classes based on axis of a built plot.
• Guess orientation based on discrete y axis.
• Added *_orientation arguments for when the orientation guess is incorrect.
• Supported col_palette argument to accept a vector for ordinal variables.
• Made pattern guide/label equal to colour/fill align automatically.

ggblanket 9.0.0

• Supported a label-based workflow.
• Breaking: renamed *_title to *_label.
• Breaking: renamed titles_to_case to label_to_case.
• Breaking: removed weave_* functions.
• Breaking: removed geom_linewidth and geom_size from weave_geom_aes and set_blanket.
• Fixed bug where grey_mode_*/dark_mode_* were missing legend functionality.
• Improved scales by using scales::breaks_extended().
• In dark_mode_*, fixed incorrect axis_line_colour default.
• In *_mode_*, updated caption colour default.
• Made guides of alpha/shape/size/linewidth/linetype aesthetics equal to colour/fill align automatically.
• Breaking: removed replace_seq.
• Added col_drop and facet_drop arguments.
• Fixed bug relating to gg_bin_2d scales.
• Updated the default NA colour used for continuous colour scales to #988f88ff" (i.e. colorspace::darken(grey, 0.25)).
• Supported the use of scales::pal_*() functions within the col_palette argument.

ggblanket 8.0.0

• Breaking: renamed col_pal to col_palette.
• Breaking: removed ability to use col_palette when col = NULL.
• Breaking: in set_blanket and weave_*, renamed arguments.
• Updated set_blanket() and weave_col_palette_*() to set the default col_palette.
• Updated set_blanket() and weave_*() to set ggplot2 as well as ggblanket.
• Added jumble discrete colour palette.
• Added red, pink and purple.
• Changed the col_palette_na default to "seashell3".
• Added orientation argument to *_mode_* functions for use with ggplot2.
• Breaking: in aes_contrast, added arguments to optimise for modes, and renamed arguments.
• Breaking: removed facet_labels_position and facet_labels_switch.
• Breaking: adjusted *ness helper palettes.
• Added arguments to *_mode_* for more control of colours/linewidths etc.
• Minor *_mode_* updates.
• Made compatible with extension geoms with no x or y variables in layer_data.

ggblanket 7.0.0

• Added set_blanket function, which is now required to set the style.
• Added weave_geom_defaults and weave_annotate_defaults helper functions.
• Supported the use of colour and fill.
• Breaking: removed all alpha arguments.
• Breaking: renamed mode_set to weave_mode.
• Breaking: in aes_contrast, renamed col_pal to contrast_pal.
• Breaking: removed greys.
• Breaking: removed plum.
• Improved *_expand defaults for histograms and bar graphs etc.
• Fixed bug to support use of a named col_pal.
• Fixed bug when positional scale reversed with *_expand_limits.

ggblanket 6.0.0

• Rewrote code completely.
• Exported gg_blanket function, which allows for a ggproto geom (or character string) to be added.
• Added aes_contrast for a colour aesthetic that automatically contrasts with the fill aesthetic inspired by work by (@teunbrand, #649) ** Added alpha aesthetic support with new alpha, alpha_pal and alpha_* arguments.
• Added stat support for a ggproto object (or character string).
• Added position support for a ggproto object (or character string).
• Added transform support for a transform class object (or character string).
• Added facet_axes and facet_axis_labels arguments.
• Added facet_labels_position argument.
• Added gg_quantile, gg_rug, and gg_function functions.
• Added col_steps argument to support colouring by steps.
• Added *_position argument to support changing axis positions.
• Added mode_set function.
• Breaking: made theme_set set the theme globally with no side-effects.
• Breaking: Added light_mode_*, dark_mode_* and grey_mode_* family of functions.
• Updated gg_* functions to pretty removal of a axis line and ticks.
• Changed default theme to place the legend on the top right.
• Changed NULL effect of pretty axis *_limits = c(NA, NA) on y_expand NULL.
• Improved default gridlines, and changed their default colour.
• Fixed bug when col is logical class.
• Added new helper hex codes blue, teal, orange, navy, plum, and greys
• Updated the default discrete palette.
• Breaking: shift ... to the front to require users to name arguments.
• Breaking: renamed theme argument to mode.
• Breaking: renamed pal to col_pal.
• Breaking: renamed pal_na to col_pal_na.
• Breaking: renamed alpha to alpha_pal.
• Breaking: alpha now refers to the aesthetic only.
• Breaking: renamed *_include to *_expand_limits.
• Breaking: renamed *_trans to *_transform.
• Breaking: removed col_legend_place argument.
• Breaking: removed *_sec_axis argument.
• Breaking: removed light_mode and dark_mode functions.
• Breaking: removed col_scale argument.
• Breaking: removed gg_blank function.
• Breaking: removed *_gridlines arguments.
• Breaking: renamed facet_switch argument to facet_labels_switch.
• Breaking: removed guardian function.
• Breaking: renamed str_keep_seq to replace_seq.
• Breaking: renamed titles to titles_to_case.
• Breaking: removed magic where *_title = "" removed the title.
• Improved log transform defaults.
• Changed legend.byrow to FALSE.
• Each gg_* function's help now inherits parameters from gg_blanket (@olivroy, #625). Other improved documentation of help (@olivroy, #643).

ggblanket 5.2.0

• Updated colours: #357BA2 or mako[9](5) where no col aesthetic, guardian where discrete and 4 or less colours, scales:hue_pal for 5 or more colours, viridisLite::mako reversed for continuous, and "grey" for NA.
• Breaking: removed all pal_* functions.
• Removed some unnecessary messages.
• Fixed bug where col_breaks was not working for a numeric col.
• Fixed bug where str_keep_seq was not working for date, datetime or time class.
• Fixed bug so that time class variables work.
• Fixed bug for gg_contour_filled and gg_density_filled with default number of colours.
• Improved default positional breaks.
• Ensured positional breaks take expand into account.
• Updated gg_qq, so it includes a geom_qq_line layer, has nicer x_title, y_title and coord defaults.
• Added more positional scale arguments to gg_sf (i.e. *_limits, *_expand, *_breaks, and *_labels).
• Improved margins where col_legend_place is top.

ggblanket 5.1.0

• Fixed bug where col variable was reversing for non-flipped.
• Added pal_light_mode and pal_dark_mode.

ggblanket 5.0.0

• Added mapping argument to allow extra aesthetics to be included, such as shape (or use delayed evaluation for aesthetics other than col, colour, fill or alpha).
• Added stat argument back for flexibility.
• Added linetype_title, shape_title, and size_title arguments.
• Added str_keep_seq helper function to support keeping labels in a sequence.
• Breaking: made horizontal y characters and factors plot values from low at bottom to high at top.
• Breaking: removed lower, middle, upper, xlower, xmiddle, and xupper arguments from gg_blank.
• Updated *_breaks defaults.
• Made plot order logical variables with TRUE first.
• Added pal_discrete2 with 6 colour blind safe colours for a light background theme.

ggblanket 4.0.0

• Breaking: removed the stat argument for all gg_* functions except gg_blank.
• Breaking: renamed pal_hue to pal_discrete and made colours relatively red/green colour blind safe.
• Breaking: renamed gg_bin2d to gg_bin_2d.
• Breaking: changed *_oob default back to scales::oob_keep.
• Improved scales to work better with transformations, limits, breaks etc.
• Added gg_contour, gg_contour_filled, gg_density2d, gg_density2d_filled functions.
• Made default to keep unused factors across all scales and facets.
• Made default continuous label function to drop trailing zeros.
• Made default legend place simpler: bottom, unless continuous. Otherwise right.
• Added text aesthetic in for plotly::ggplotly.

ggblanket 3.0.0

• New theme functions: light_mode and dark_mode.
• Breaking: removed gg_theme.
• Breaking: renamed *_grid arguments to *_gridlines.
• Breaking: removed void argument.
• Breaking: removed gg_function.
• Breaking: made col_rescale require a function (e.g. scales::rescale()).
• Added facet_switch argument.
• Made col_legend_place = "none" only remove the col legend.
• Made gg_bin2d and gg_hex scales calculate in the same way as other functions.
• For raster, removed col aesthetic so that legend would work.
• Improved gg_sf default alpha.
• Supported gg_sf to work with non-standard named geometry.
• Thanks Nik Mitchell and Rosie Percival for feedback.

ggblanket 2.0.0

• Made ggblanket work better with adding layers.
• Made the pal no longer inherit to layers where no col aesthetic.
• Made x and y scales work better, including with NA in the limits.
• Added 2 colours to pal_hue.
• Breaking: changed default *oob argument to scales::oob_censor.
• Breaking: changed default coord argument to include clip = "off" argument.
• Breaking: removed add_tooltip function.
• Breaking: changed pal functions to pal_blue, pal_grey, and pal_hue.

ggblanket 1.8.0

• Updated default colour palette.
• Updated default NA colour.

ggblanket 1.7.0

• Updated gg_theme default axis-line and gridline thickness.
• Supported named pal vectors.
• Removed clip argument.
• Added in coord argument.
• Added in *_oob arguments.
• Improved how *_limits works.
• Removed default gridlines for gg_sf.
• Fixed bug with default x_expand.
• Fixed bug with gg_histogram scales.
• Critical fix to support dplyr 1.1.0.
• Supported colouring date, datetime and time variables.
• Made datetime breaks default to waiver.
• Breaking: removed void argument from gg_theme.
• Corrected bug with gg_raster legend not showing.
• Updated gg_raster *_limits and *_expand defaults.
• Internal function to make infinite values NA made compatible with dplyr 1.1.0 (#269, @DavisVaughan)

ggblanket 1.6.0

• Breaking: renamed add_tooltip_text to add_tooltip and changed column name to "tooltip".
• Breaking: coord argument removed.
• Added clip argument and defaulted to "on".
• Made x and y limits also act within the coord.
• Made gg_blank more powerful and flexible.
• Improved horizontal flipped plot scales.
• Fixed bugs relating to free facet_scales and scale limits.
• Improved vignette.

ggblanket 1.5.0

• Breaking: redesigned gg_theme.
• Added automatic gridline removal.
• Added gg_bin2d function.
• Added gg_hex function.
• Added col_trans and col_rescale arguments.
• Made col_legend_place default "r" where numeric col variable.
• Made *_title = "" equivalent to + labs(* = NULL).
• Supported x and y datetime variables.
• Supported x and y time variables.
• Redesigned internal code for x, y and col scales.

ggblanket 1.4.0

• Breaking: Removed col_intervals argument.
• Breaking: Removed *_oob argument.
• Breaking: In gg_theme, changed *_style arguments to *_face.
• Breaking: In gg_theme, changed font arguments to family.
• Added gg_polygon function.
• Added col_continuous argument to support colouring by "steps".
• Added col_legend_rev argument to reverse legends.
• Added facet_layout argument for more faceting flexibility.
• Added facet_space argument to support proportional facet panels.
• Removed width default.
• Improved default legend look for where continuous gradient.
• Improved scales where y is NULL and plot is horizontal.
• Fixed bug with position = "fill".
• Updated messages.
• Added vignette.

ggblanket 1.3.0

• Breaking: removed facet_intervals argument.
• Breaking: made extensive changes to gg_theme function.
• Added facet2 aesthetic in to support effortless grid faceting.
• Changed default background theme colours.
• Fixed bug with *_limits and *_include not working correctly.
• Added *_sec_axis arguments.
• Changed *_oob default to scales::oob_keep.
• Removed reversal of logical variable order.
• Defaulted col_legend_place to "b".

ggblanket 1.2.0

• Breaking: Removed *_breaks_n and *_breaks_width.
• Added support for *_breaks to receive a function.
• Added *_include argument.
• Added *_trans argument.
• Modified default x_breaks behaviour for when both x and y are numeric or date.
• Enhanced gg_blank to work with only one x or y.
• Provided support for ggplotly.
• Added new add_tooltip_text function.
• Added new titles argument to apply a function across titles.
• Support gg_ functions working with more stats.
• Removed size argument, in anticipation of ggplot2 3.4.0.
• Updated gg_theme title vjust and margins.

ggblanket 1.1.0

• Remove default sentence case transformation of categorical variable labels.
• Updated scales to work in a consistent way with position = "fill".

ggblanket 1.0.0

• Initial release.

ggblanket documentation built on Sept. 11, 2024, 7:37 p.m.