Point ggplot that is coloured and facetted.
gg_point_col_facet(
data,
x_var,
y_var,
col_var,
facet_var,
text_var = NULL,
pal = NULL,
pal_na = "#7F7F7F",
pal_rev = FALSE,
alpha_point = 1,
size_point = 1.5,
title = NULL,
title_wrap = 80,
subtitle = NULL,
subtitle_wrap = 80,
x_balance = FALSE,
x_breaks_n = 2,
x_expand = NULL,
x_jitter = 0,
x_labels = NULL,
x_rev = FALSE,
x_title = NULL,
x_title_wrap = 50,
x_zero = FALSE,
x_zero_line = NULL,
y_balance = FALSE,
y_breaks_n = 3,
y_expand = c(0, 0),
y_jitter = 0,
y_labels = scales::label_comma(),
y_title = NULL,
y_title_wrap = 50,
y_zero = FALSE,
y_zero_line = NULL,
col_breaks_n = 4,
col_cuts = NULL,
col_intervals_right = TRUE,
col_labels = NULL,
col_legend_none = FALSE,
col_method = NULL,
col_na_rm = 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 = 80,
theme = gg_theme(gridlines_h = TRUE, gridlines_v = TRUE)
)An ungrouped summarised tibble or dataframe in a structure to be plotted untransformed. Required input.
Unquoted variable to be on the x scale (i.e. character, factor, logical, numeric, date or POSIXt). Required input.
Unquoted numeric variable to be on the y scale. Required input.
Unquoted variable for points to be coloured by. 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.
Character vector of hex codes.
The hex code or name of the NA colour to be used.
Reverses the palette. Defaults to FALSE.
The opacity of the points.
Size of points. Defaults to 1.5.
Title string.
Number of characters to wrap the title to. Defaults to 100.
Subtitle string.
Number of characters to wrap the subtitle to. Defaults to 100.
For a numeric x variable, add balance to the x scale so that zero is in the centre. Defaults to FALSE.
For a numeric or date x variable, the desired number of intervals on the x scale, as calculated by the pretty algorithm. Defaults to 2.
A vector of range expansion constants used to add padding to the x scale, as per the ggplot2 expand argument in ggplot2 scales functions.
Amount of horizontal jitter to be added in positive and negative directions. Defaults to 0. See ggplot2::position_jitter for further information.
A function or named vector to modify x scale labels. Use function(x) x to keep labels untransformed.
For a categorical x variable, TRUE or FALSE of whether the x variable variable is reversed. Defaults to FALSE.
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 of 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 of the y scale.
For a numeric or date x variable, the desired number of intervals on the x scale, as calculated by the pretty algorithm. Defaults to 4.
A vector of range expansion constants used to add padding to the y scale, as per the ggplot2 expand argument in ggplot2 scales functions.
Amount of vertical jitter to be added in positive and negative directions. Defaults to 0.See ggplot2::position_jitter for further information.
A function or named vector to modify y scale labels. Use function(x) x to keep labels untransformed.
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 TRUE.
For a numeric y variable, TRUE or FALSE 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.
For a numeric colour variable, the desired number of intervals on the colour scale.
A vector of cuts to colour a numeric variable. If "bin" is selected, the first number in the vector should be either -Inf or 0, and the final number Inf. If "quantile" is selected, the first number in the vector should be 0 and the final number should be 1. Defaults to quartiles.
For a numeric colour variable, TRUE or FALSE of whether bins or quantiles are to be cut right-closed. Defaults to TRUE.
A function or named vector to modify colour scale labels. Defaults to snakecase::to_sentence_case for categorical colour variables and scales::label_comma() for numeric. Use function(x) x to keep labels untransformed.
TRUE or FALSE of whether to remove the legend.
The method of colouring features, either "bin", "quantile", "continuous", or "category." If numeric, defaults to "bin".
TRUE or FALSE of whether to include col_var NA values. 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.
A function or named vector to modify facet scale labels. Defaults to converting labels to sentence case. Use function(x) x to keep 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 80.
A ggplot2 theme.
A ggplot object.
# NOT RUN {
library(simplevis)
library(palmerpenguins)
gg_point_col_facet(penguins,
x_var = bill_length_mm,
y_var = body_mass_g,
col_var = sex,
facet_var = species)
# }
Run the code above in your browser using DataLab