Horizontal bar ggplot that is facetted, but not coloured.
gg_hbar_col_facet(
data,
x_var,
y_var,
col_var,
facet_var,
text_var = NULL,
position = "dodge",
pal = NULL,
pal_rev = FALSE,
width = 0.75,
alpha = 1,
size_line = 0.5,
title = NULL,
title_wrap = 65,
subtitle = NULL,
subtitle_wrap = 75,
x_balance = FALSE,
x_expand = NULL,
x_labels = waiver(),
x_na = TRUE,
x_pretty_n = 3,
x_title = NULL,
x_title_wrap = 50,
x_trans = "identity",
x_zero = TRUE,
x_zero_line = NULL,
y_balance = FALSE,
y_expand = NULL,
y_labels = NULL,
y_na = TRUE,
y_pretty_n = 4,
y_rev = FALSE,
y_title = NULL,
y_title_wrap = 50,
y_zero = FALSE,
y_zero_line = NULL,
col_labels = NULL,
col_legend_ncol = NULL,
col_legend_nrow = NULL,
col_na = TRUE,
col_rev = FALSE,
col_title = NULL,
col_title_wrap = 25,
facet_labels = NULL,
facet_na = TRUE,
facet_ncol = NULL,
facet_nrow = NULL,
facet_scales = "fixed",
caption = NULL,
caption_wrap = 80,
font_family = "",
font_size_title = NULL,
font_size_body = NULL
)
A tibble or dataframe. Required input.
Unquoted numeric variable to be on the x scale. Required input.
Unquoted variable to be on the y scale (i.e. character, factor, logical, numeric, date or datetime). If numeric, date or datetime, variable values are bins that are mutually exclusive and equidistant. Required input.
Unquoted categorical variable to colour the bars. Required input.
Unquoted categorical variable to facet the data by. Required input.
Unquoted variable to be used as a customised tooltip in combination with plotly::ggplotly(plot, tooltip = "text"). Defaults to NULL.
Whether bars are positioned by "dodge" or "stack". Defaults to "dodge".
Character vector of hex codes.
TRUE or FALSE of whether to reverse the pal.
Width of bars. Defaults to 0.75.
The alpha of the fill. Defaults to 1.
The size of the outlines of bars.
Title string. Defaults to NULL.
Number of characters to wrap the title to. Defaults to 65.
Subtitle string.
Number of characters to wrap the subtitle to. Defaults to 75.
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 vector to modify x scale labels, as per the ggplot2 labels argument in ggplot2 scales functions. If NULL, categorical variable labels are converted to sentence case. Use ggplot2::waiver() to keep x labels untransformed.
TRUE or FALSE of whether to include x_var NA values. Defaults to TRUE.
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.
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, a string specifying a transformation for the x scale, such as "log10" or "sqrt". Defaults to "identity".
For a numeric x variable, TRUE or FALSE of whether the minimum of the x scale is zero. Defaults to TRUE.
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.
For a numeric y variable, add balance to the y scale so that zero is in the centre. 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 vector to modify y scale labels, as per the ggplot2 labels argument in ggplot2 scales functions. 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 TRUE.
For a numeric or date y variable, the desired number of intervals on the y scale, as calculated by the pretty algorithm. Defaults to 6.
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.
For a numeric y variable, TRUE or FALSE of whether the minimum of the y scale is zero. Defaults to FALSE.
For a numeric y variable, TRUE or FALSE of whether to add a zero reference line to the y scale. Defaults to TRUE if there are positive and negative values in y_var. Otherwise defaults to FALSE.
A function or vector to modify colour scale labels, as per the ggplot2 labels argument in ggplot2 scales functions. If NULL, categorical variable labels are converted to sentence case. Use ggplot2::waiver() to keep y labels untransformed.
The number of columns in the legend.
The number of rows in the legend.
TRUE or FALSE of whether to include col_var NA values. Defaults to TRUE.
TRUE or FALSE of whether the colour scale is reversed. Defaults to FALSE. 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.
As per the ggplot2 labeller argument within the ggplot facet_wrap function. If NULL, defaults to ggplot2::as_labeller(snakecase::to_sentence_case). Use facet_labels = ggplot2::label_value to turn off default sentence case transformation.
TRUE or FALSE of whether to include facet_var NA values. Defaults to TRUE.
The number of columns of facetted plots.
The number of rows of facetted plots.
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 80.
Font family to use. Defaults "".
Font size for the title text. Defaults to 11.
Font size for all text other than the title. Defaults to 10.
A ggplot object.
# NOT RUN {
library(dplyr)
library(simplevis)
library(palmerpenguins)
plot_data <- penguins %>%
group_by(species, sex, island) %>%
summarise(body_mass_g = mean(body_mass_g, na.rm = TRUE))
gg_hbar_col_facet(plot_data, body_mass_g, species, island, sex)
# }
Run the code above in your browser using DataLab