Point ggplot that is coloured, but not facetted.
gg_point_col(
data,
x_var,
y_var,
col_var,
text_var = NULL,
size_point = 1,
pal = NULL,
pal_rev = FALSE,
x_balance = FALSE,
x_expand = NULL,
x_labels = NULL,
x_na = TRUE,
x_pretty_n = 6,
x_rev = FALSE,
x_trans = "identity",
x_zero = FALSE,
x_zero_line = NULL,
y_balance = FALSE,
y_expand = NULL,
y_labels = waiver(),
y_na = TRUE,
y_pretty_n = 5,
y_trans = "identity",
y_zero = FALSE,
y_zero_line = NULL,
title = NULL,
subtitle = NULL,
x_title = NULL,
y_title = NULL,
col_title = NULL,
caption = NULL,
col_cuts = NULL,
col_labels = NULL,
col_labels_dp = NULL,
col_legend_ncol = NULL,
col_legend_nrow = NULL,
col_method = NULL,
col_na = TRUE,
font_family = "",
font_size_title = NULL,
font_size_body = NULL,
title_wrap = 70,
subtitle_wrap = 80,
x_title_wrap = 50,
y_title_wrap = 50,
col_title_wrap = 25,
caption_wrap = 80,
mobile = FALSE
)An ungrouped summarised tibble or dataframe. Required input.
Unquoted variable to be on the x scale (i.e. character, factor, logical, numeric, date or datetime). Required input.
Unquoted numeric variable to be on the y scale. Required input.
Unquoted variable for points to be coloured by. Required input.
Unquoted variable to be used as a customised tooltip in combination with plotly::ggplotly(plot, tooltip = "text"). Defaults to NULL.
Size of points. Defaults to 1.
Character vector of hex codes.
Reverses the palette. Defaults to FALSE.
For a numeric x variable, add balance to the x scale so that zero is in the centre. Defaults to FALSE.
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 6.
For a categorical x variable, TRUE or FALSE of whether the x variable variable is reversed. Defaults to FALSE.
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 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.
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 x variable, the desired number of intervals on the x scale, as calculated by the pretty algorithm. Defaults to 5.
For a numeric y variable, a string specifying a transformation for the y scale, such as "log10" or "sqrt". Defaults to "identity".
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.
Title string. Defaults to NULL.
Subtitle string.
X scale title string. Defaults to NULL, which converts to sentence case with spaces. Use "" if you would like no title.
y scale title string. Defaults to NULL, which converts to sentence case with spaces. Use "" if you would like no title.
Colour title string for the legend. Defaults to NULL, which converts to sentence case with spaces. Use "" if you would like no title.
Caption title string.
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.
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, and numeric variable labels to pretty labels with an internal function. Use ggplot2::waiver() to keep colour labels untransformed.
For numeric colour variables and where col_labels equals NULL, the number of decimal places. Defaults to 1 for "quantile" col_method, and the lowest dp within the col_cuts vector for "bin".
The number of columns in the legend.
The number of rows in the legend.
The method of colouring features, either "bin", "quantile" or "category." If numeric, defaults to "quantile".
TRUE or FALSE of whether to include col_var NA values. Defaults to TRUE.
Font family to use. Defaults to "".
Font size for the title text. Defaults to 11.
Font size for all text other than the title. Defaults to 10.
Number of characters to wrap the title to. Defaults to 70. Not applicable where mobile equals TRUE.
Number of characters to wrap the subtitle to. Defaults to 80. Not applicable where mobile equals TRUE.
Number of characters to wrap the x title to. Defaults to 50.
Number of characters to wrap the y title to. Defaults to 50.
Number of characters to wrap the colour title to. Defaults to 25. Not applicable where mobile equals TRUE.
Number of characters to wrap the caption to. Defaults to 80. Not applicable where mobile equals TRUE.
Whether the plot is to be displayed on a mobile device. Defaults to FALSE. If within a shiny app with the mobileDetect function, then use mobile = input$isMobile.
A ggplot object.
# NOT RUN {
library(simplevis)
library(palmerpenguins)
gg_point_col(penguins, bill_length_mm, body_mass_g, species)
# }
Run the code above in your browser using DataLab