Create a violin plot with a wrapper around the ggplot2::geom_violin function.
gg_violin(
data = NULL,
x = NULL,
y = NULL,
col = NULL,
facet = NULL,
facet2 = NULL,
group = NULL,
text = NULL,
stat = "ydensity",
position = "dodge",
pal = NULL,
pal_na = "#7F7F7F",
alpha = 0.9,
...,
titles = NULL,
title = NULL,
subtitle = NULL,
coord = NULL,
x_breaks = NULL,
x_expand = NULL,
x_include = NULL,
x_labels = NULL,
x_limits = NULL,
x_sec_axis = ggplot2::waiver(),
x_title = NULL,
x_trans = "identity",
y_breaks = NULL,
y_expand = NULL,
y_include = NULL,
y_labels = NULL,
y_limits = NULL,
y_sec_axis = ggplot2::waiver(),
y_title = NULL,
y_trans = "identity",
col_breaks = NULL,
col_continuous = "gradient",
col_include = NULL,
col_labels = NULL,
col_legend_place = NULL,
col_legend_ncol = NULL,
col_legend_nrow = NULL,
col_legend_rev = FALSE,
col_limits = NULL,
col_title = NULL,
facet_labels = NULL,
facet_ncol = NULL,
facet_nrow = NULL,
facet_scales = "fixed",
facet_space = "fixed",
facet_layout = NULL,
caption = NULL,
theme = NULL
)A ggplot object.
A data frame or tibble.
Unquoted x aesthetic variable.
Unquoted y aesthetic variable.
Unquoted col and fill aesthetic variable.
Unquoted facet aesthetic variable.
Unquoted second facet variable for a facet grid of facet by facet2 variables.
Unquoted group aesthetic variable.
Unquoted text aesthetic variable, which can be used in combination with plotly::ggplotly(., tooltip = "text").
Statistical transformation. A character string (e.g. "identity").
Position adjustment. Either a character string (e.g."identity"), or a function (e.g. ggplot2::position_identity()).
Colours to use. A character vector of hex codes (or names).
Colour to use for NA values. A character vector of a hex code (or name).
Opacity. A number between 0 and 1.
Other arguments passed to the relevant ggplot2::geom_* function.
A function to format the x, y and col titles, including in rlang lambda format. Defaults to snakecase::to_sentence_case.
Title string.
Subtitle string.
Coordinate system.
A function that takes the limits as input (e.g. scales::breaks_pretty()), or a vector of breaks.
Padding to the limits with the ggplot2::expansion function, or a vector of length 2 (e.g. c(0, 0)).
For a numeric or date variable, any values that the scale should include (e.g. 0).
A function that takes the breaks as inputs (e.g. scales::label_comma()), or a vector of labels.
A vector of length 2 to determine the limits of the axis. Alternatively, zoom in using coord = coord_cartesian(xlim = ...).
A secondary axis specified by the ggplot2::sec_axis or ggplot2::dup_axis function.
Axis title string. Defaults to converting to sentence case with spaces. Use "" for no title.
For a numeric variable, a transformation object (e.g. "log10").
A function that takes the limits as input (e.g. scales::breaks_pretty()), or a vector of breaks.
Padding to the limits with the ggplot2::expansion function, or a vector of length 2 (e.g. c(0, 0)).
For a numeric or date variable, any values that the scale should include (e.g. 0).
A function that takes the breaks as inputs (e.g. scales::label_comma()), or a vector of labels.
A vector of length 2 to determine the limits of the axis. Alternatively, zoom in using coord = coord_cartesian(ylim = ...).
A secondary axis specified by the ggplot2::sec_axis or ggplot2::dup_axis function.
Axis title string. Defaults to converting to sentence case with spaces. Use "" for no title.
For a numeric variable, a transformation object (e.g. "log10").
A function that takes the limits as input (e.g. scales::breaks_pretty()), or a vector of breaks.
Type of colouring for a continuous variable. Either "gradient" or "steps". Defaults to "steps".
For a numeric or date variable, any values that the scale should include (e.g. 0).
A function that takes the breaks as inputs (e.g. scales::label_comma()), or a vector of labels. Note this does not affect where col_intervals is not NULL.
The place for the legend. "b" for bottom, "r" for right, "t" for top, or "l" for left. Defaults to "b".
The number of columns for the legend elements.
The number of rows for the legend elements.
Reverse the elements of the legend. Defaults to FALSE.
A vector to determine the limits of the axis.
Legend title string. Defaults to converting to sentence case with spaces. Use "" for no title.
A function that takes the breaks as inputs (e.g. scales::label_comma()), or a named vector of labels (e.g. c("value" = "label", ...)).
The number of columns of facets. Only applies to a facet layout of "wrap".
The number of rows of facets. Only applies to a facet layout of "wrap".
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".
Whether facet_space should be "fixed" across facets, "free" to be proportional in both directions, or free to be proportional in just one direction (i.e. "free_x" or "free_y"). Only applies where the facet layout is a 'grid' and facet_scales are not fixed. Defaults to "fixed".
Whether the layout is to be "wrap" or "grid". If NULL and a single facet (or facet2) argument is provided, then defaults to "wrap". If NULL and both facet and facet2 arguments are provided, defaults to "grid"..
Caption title string.
A ggplot2 theme.
library(ggplot2)
mtcars %>%
dplyr::mutate(cyl = as.factor(cyl)) %>%
gg_violin(x = cyl, y = mpg)
Run the code above in your browser using DataLab