Horizontal boxplot ggplot that is coloured and facetted.
gg_hboxplot_col_facet(
data,
x_var = NULL,
y_var,
col_var,
facet_var,
pal = NULL,
pal_na = "#7F7F7F",
pal_rev = FALSE,
alpha_fill = 0.5,
alpha_line = 1,
alpha_point = 1,
size_line = 0.5,
size_point = 1.5,
size_width = 0.5,
title = NULL,
title_wrap = 75,
subtitle = NULL,
subtitle_wrap = 75,
x_breaks_n = 2,
x_balance = FALSE,
x_expand = c(0, 0),
x_labels = scales::label_comma(),
x_title = NULL,
x_title_wrap = 50,
x_zero = FALSE,
x_zero_line = NULL,
y_expand = ggplot2::waiver(),
y_labels = snakecase::to_sentence_case,
y_na_rm = FALSE,
y_rev = FALSE,
y_title = NULL,
y_title_wrap = 50,
col_labels = stringr::str_to_sentence,
col_legend_none = FALSE,
col_na_rm = FALSE,
col_rev = FALSE,
col_title = NULL,
col_title_wrap = 25,
facet_labels = snakecase::to_sentence_case,
facet_na_rm = FALSE,
facet_ncol = NULL,
facet_nrow = NULL,
facet_rev = FALSE,
facet_scales = "fixed",
caption = NULL,
caption_wrap = 75,
theme = gg_theme(gridlines_v = TRUE),
stat = "boxplot",
xmin_var = NULL,
xlower_var = NULL,
xmiddle_var = NULL,
xupper_var = NULL,
xmax_var = NULL
)An ungrouped summarised tibble or dataframe generally in a structure to be transformed to boxplot statistics (or alternatively in a structure of summary boxplot statistics). Required input.
Unquoted numeric variable to be on the x scale for when stat = "boxplot" is selected.
Unquoted categorical variable to be on the y scale (i.e. character, factor, or logical). Required input.
Unquoted categorical or numeric variable to colour the boxplots. Required input.
Unquoted categorical variable to facet the data by. Required input.
Character vector of hex codes.
The hex code or name of the NA colour to be used.
TRUE or FALSE of whether to reverse the pal.
The opacity of the fill. Defaults to 0.5.
The opacity of the outline. Defaults to 1.
The opacity of the outlier points. Defaults to 1.
The size of the outlines of boxplots.
The size of the outlier points. Defaults to 1.5.
Width of boxes. Defaults to 0.5.
Title string.
Number of characters to wrap the title to. Defaults to 60.
Subtitle string.
Number of characters to wrap the subtitle to. Defaults to 60.
For a numeric or date x variable, the desired number of intervals on the x scale, as calculated by the pretty algorithm. Defaults to 5.
For a numeric x variable, add balance to the x scale so that zero is in the centre of the x scale.
A vector of range expansion constants used to add padding to the x scale, as per the ggplot2 expand argument in ggplot2 scales functions.
A function or named vector to modify x scale labels. Use ggplot2::waiver() to keep x labels untransformed.
X scale title string. Defaults to NULL, which converts to sentence case with spaces. Use "" if you would like no title.
Number of characters to wrap the x title to. Defaults to 50.
For a numeric x variable, TRUE or FALSE of whether the minimum of the x scale is zero. Defaults to FALSE.
For a numeric x variable, TRUE or FALSE whether to add a zero reference line to the x scale. Defaults to TRUE if there are positive and negative values in x_var. Otherwise defaults to FALSE.
A vector of range expansion constants used to add padding to the y scale, as per the ggplot2 expand argument in ggplot2 scales functions.
A function or named vector to modify y scale labels. If NULL, categorical variable labels are converted to sentence case. Use ggplot2::waiver() to keep y labels untransformed.
TRUE or FALSE of whether to include y_var NA values. Defaults to FALSE.
For a categorical variable, TRUE or FALSE of whether the y variable variable is reversed. Defaults to FALSE.
y scale title string. Defaults to NULL, which converts to sentence case with spaces. Use "" if you would like no title.
Number of characters to wrap the y title to. Defaults to 50.
A function or named vector to modify colour scale labels. Defaults to snakecase::to_sentence_case for categorical colour variables and scales::number for numeric colour variables. Use ggplot2::waiver() to keep colour labels untransformed.
TRUE or FALSE of whether to remove the legend.
TRUE or FALSE of whether to include col_var NA values. Defaults to FALSE.
TRUE or FALSE of whether the colour scale is reversed. Defaults to FALSE.
Colour title string for the legend. Defaults to NULL, which converts to sentence case with spaces. Use "" if you would like no title.
Number of characters to wrap the colour title to. Defaults to 25. Not applicable where mobile equals TRUE.
A function or named vector to modify facet scale labels. Defaults to converting labels to sentence case. Use ggplot2::waiver() to keep facet labels untransformed.
TRUE or FALSE of whether to include facet_var NA values. Defaults to FALSE.
The number of columns of facetted plots.
The number of rows of facetted plots.
TRUE or FALSE of whether the facet variable variable is reversed. Defaults to FALSE.
Whether facet_scales should be "fixed" across facets, "free" in both directions, or free in just one direction (i.e. "free_x" or "free_y"). Defaults to "fixed".
Caption title string.
Number of characters to wrap the caption to. Defaults to 75.
A ggplot2 theme.
String of "boxplot" or "identity". Defaults to "boxplot".
Unquoted numeric variable for minimum of whisker on the x scale for when stat = "identity" is selected.
Unquoted numeric variable for minimum of box on the x scale for when stat = "identity" is selected.
Unquoted numeric variable for middle of box on the x scale for when stat = "identity" is selected.
Unquoted numeric variable for maximum of box on the x scale for when stat = "identity" is selected.
Unquoted numeric variable for maximum of whisker on the x scale for when stat = "identity" is selected.
A ggplot object.
# NOT RUN {
library(simplevis)
library(palmerpenguins)
penguins %>%
dplyr::mutate(year = as.character(year)) %>%
gg_hboxplot_col_facet(x_var = body_mass_g,
y_var = year,
col_var = sex,
facet_var = species,
col_na_rm = TRUE)
#For ggplotly, pipe in plotly::layout(boxmode = "group") layer
# }
Run the code above in your browser using DataLab