R/plot_xy_CatGroup.R
plot_xy_CatGroup.Rd
This function takes a data table, quantitative X and Y variables along with a categorical grouping variable, and a and plots a graph with using geom_point
. The categorical CatGroup
variable is mapped to the fill
aesthetic of symbols.
plot_xy_CatGroup(
data,
xcol,
ycol,
CatGroup,
symsize = 2.5,
symthick = 1,
s_alpha = 1,
ColPal = "all_grafify",
ColSeq = TRUE,
ColRev = FALSE,
TextXAngle = 0,
fontsize = 20
)
a data table object, e.g. data.frame or tibble.
name of the column with quantitative X variable.
name of the column with quantitative Y variable.
a categorical variable as grouping factor for colour of data points, should be a categorical variable for default colours to work. Will be converted to factor
if your column is numeric
size of symbols used by geom_point
. Default set to 2.5, increase/decrease as needed.
thickness of symbol border, default set to 1.
fractional opacity of symbols, default set to 1 (i.e. maximum opacity & zero transparency).
grafify colour palette to apply, default "all_grafify"; alternatives: "okabe_ito", "bright", "pale", "vibrant", "contrast", "muted" "dark", "light".
logical TRUE or FALSE. Default TRUE for sequential colours from chosen palette. Set to FALSE for distant colours, which will be applied using scale_fill_grafify2
.
whether to reverse order of colour choice, default F (FALSE); can be set to T (TRUE).
orientation of text on X-axis; default 0 degrees. Change to 45 or 90 to remove overlapping text.
parameter of base_size
of fonts in theme_classic
, default set to size 20.
This function returns a ggplot2
object of class "gg" and "ggplot".
Colours can be changed using ColPal
, ColRev
or ColSeq
arguments. Colours available can be seen quickly with plot_grafify_palette
.
ColPal
can be one of the following: "okabe_ito", "dark", "light", "bright", "pale", "vibrant, "muted" or "contrast".
ColRev
(logical TRUE/FALSE) decides whether colours are chosen from first-to-last or last-to-first from within the chosen palette.
ColSeq
(logical TRUE/FALSE) decides whether colours are picked by respecting the order in the palette or the most distant ones using colorRampPalette
.
This plot is related to plot_xy_NumGroup
which requires a numeric grouping factor.
When summary statistics (mean/median) are required, use plot_3d_scatterbar
, plot_3d_scatterbox
or plot_4d_scatterbox
.
#The grouping factor cyl is automatically converted to categorical variable
plot_xy_CatGroup(data = mtcars,
xcol = mpg, ycol = disp, CatGroup = cyl,
ColPal = "vibrant", ColSeq = FALSE)