R/plot_bar_sd.R
plot_bar_sd.Rd
This function takes a data table, categorical X and numeric Y variables, and plots bars showing the mean with SD error bars. The X variable is mapped to the fill
aesthetic of bars. The related plot_bar_sd_sc
plots bars with a single colour.
plot_bar_sd(
data,
xcol,
ycol,
b_alpha = 1,
bwid = 0.7,
bthick = 1,
ewid = 0.3,
ColPal = "all_grafify",
ColSeq = TRUE,
ColRev = FALSE,
TextXAngle = 0,
fontsize = 20,
...
)
a data table object, e.g. a data.frame or tibble.
name of the column to plot on X axis. This should be a categorical variable.
name of the column to plot on the Y axis. This should be a quantitative variable.
fractional opacity of bars, default set to 1 (i.e. maximum opacity & zero transparency).
width of bars, default 0.7
thickness of bar borders; default 1.
width of error bars, default 0.3
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.
any additional arguments to pass to stat_summary
.
This function returns a ggplot2
object of class "gg" and "ggplot".
The function uses stat_summary
with geom = "bar"
. 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
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_bar_sd(data = data_doubling_time,
xcol = Student, ycol = Doubling_time)
#apply distant colours in the default palette
plot_bar_sd(data = data_doubling_time,
xcol = Student, ycol = Doubling_time,
ColSeq = FALSE)