Point ggplot that is coloured.

Point ggplot that is coloured, but not facetted.

ggplot_point_col(
  data,
  x_var,
  y_var,
  col_var,
  text_var = NULL,
  size_point = 1,
  pal = NULL,
  pal_rev = FALSE,
  col_method = NULL,
  col_cuts = NULL,
  col_na = TRUE,
  x_balance = FALSE,
  x_zero = FALSE,
  x_zero_line = NULL,
  x_trans = "identity",
  x_labels = waiver(),
  x_pretty_n = 6,
  x_rev = FALSE,
  x_expand = NULL,
  y_balance = FALSE,
  y_expand = NULL,
  y_labels = waiver(),
  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_legend_ncol = NULL,
  col_legend_nrow = NULL,
  col_labels_dp = 1,
  font_family = "Helvetica",
  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
)

Arguments

data	An ungrouped summarised tibble or dataframe. Required input.
x_var	Unquoted numeric, date or categorical variable to be on the x axis. Required input.
y_var	Unquoted numeric variable to be on the y axis. Required input.
col_var	Unquoted variable for points to be coloured by. Required input.
text_var	Unquoted variable to be used as a customised tooltip in combination with plotly::ggplotly(plot, tooltip = "text"). Defaults to NULL.
size_point	Size of points. Defaults to 1.
pal	Character vector of hex codes. Defaults to viridis. Use the pals package to find a suitable palette.
pal_rev	Reverses the palette. Defaults to FALSE.
col_method	The method of colouring features, either "bin", "quantile" or "category." If numeric, defaults to "quantile".
col_cuts	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.
col_na	TRUE or FALSE of whether to show NA values of the colour variable. Defaults to TRUE.
x_balance	For a numeric x variable, add balance to the x scale so that zero is in the centre. Defaults to FALSE.
x_zero	For a numeric x variable, TRUE or FALSE of whether the minimum of the x scale is zero. Defaults to FALSE.
x_zero_line	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.
x_trans	For a numeric x variable, a string specifying a transformation for the x scale, such as "log10" or "sqrt". Defaults to "identity".
x_labels	Adjust the x scale labels through a function that takes the breaks as input and returns labels as output.
x_pretty_n	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.
x_rev	For a categorical x variable, TRUE or FALSE of whether the x variable variable is reversed. Defaults to FALSE.
x_expand	Adjust the vector of range expansion constants used to add some padding on the x scale.
y_balance	For a numeric y variable, add balance to the y scale so that zero is in the centre of the y scale.
y_expand	Adjust the vector of range expansion constants used to add some padding on the y scale.
y_labels	Adjust the y scale labels through a function that takes the breaks as input and returns labels as output.
y_pretty_n	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.
y_trans	For a numeric y variable, a string specifying a transformation for the y scale, such as "log10" or "sqrt". Defaults to "identity".
y_zero	For a numeric y variable, TRUE or FALSE of whether the minimum of the y scale is zero. Defaults to TRUE.
y_zero_line	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	Title string. Defaults to NULL.
subtitle	Subtitle string. Defaults to "[Subtitle]".
x_title	X scale title string. Defaults to NULL, which converts to sentence case with spaces. Use "" if you would like no title.
y_title	y scale title string. Defaults to NULL, which converts to sentence case with spaces. Use "" if you would like no title.
col_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	Caption title string. Defaults to NULL.
col_legend_ncol	The number of columns in the legend.
col_legend_nrow	The number of rows in the legend.
col_labels_dp	Select the appropriate number of decimal places for numeric variable auto legend labels. Defaults to 1.
font_family	Font family to use. Defaults to "Helvetica".
font_size_title	Font size for the title text. Defaults to 11.
font_size_body	Font size for all text other than the title. Defaults to 10.
title_wrap	Number of characters to wrap the title to. Defaults to 70. Not applicable where mobile equals TRUE.
subtitle_wrap	Number of characters to wrap the subtitle to. Defaults to 80. Not applicable where mobile equals TRUE.
x_title_wrap	Number of characters to wrap the x title to. Defaults to 50.
y_title_wrap	Number of characters to wrap the y title to. Defaults to 50.
col_title_wrap	Number of characters to wrap the colour title to. Defaults to 25. Not applicable where mobile equals TRUE.
caption_wrap	Number of characters to wrap the caption to. Defaults to 80. Not applicable where mobile equals TRUE.
mobile	Whether the plot is to be displayed on a mobile device. Defaults to FALSE. If within an app with the mobileDetect function, then use mobile = input$isMobile.

Value

A ggplot object.

Examples

library(dplyr)

plot_data <- slice_sample(ggplot2::diamonds, prop = 0.05)

ggplot_point_col(plot_data, carat, price, color)