R/plot_point_sd.R
plot_point_sd.Rd
This function takes a data table, categorical X and numeric Y variables, and plots a point showing the mean with SD error bars. The X variable is mapped to the fill
aesthetic of symbols. The related plot_point_sd_sc
plots bars with a single colour.
plot_point_sd(
data,
xcol,
ycol,
s_alpha = 1,
symsize = 3.5,
symthick = 1,
ewid = 0.2,
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 a categorical X variable.
name of the column with quantitative Y variable.
fractional opacity of symbols, default set to 1 (i.e. maximum opacity & zero transparency).
size of point symbols, default set to 3.5.
thickness of symbol border, default set to 1.
width of error bars, default set to 0.2.
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".
The function uses stat_summary
with geom = "point"
with size = 3
.
Standard deviation (SD) is plotted through stat_summary
calculated using mean_sdl
from the ggplot2
package (get help with ?mean_sdl
), and 1x SD is plotted (fun.arg = list(mult = 1)
.
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
.
You are instead encouraged to show all data using the following functions: plot_scatterbar_sd
, plot_scatterbox
, plot_dotbox
, plot_dotbar_sd
, plot_scatterviolin
or plot_dotviolin
.
#Basic usage
plot_point_sd(data = data_doubling_time,
xcol = Student, ycol = Doubling_time)