R/plot_dotbar_sd.R
plot_dotbar_sd.Rd
This function takes a data table, X and Y variables, and plots a graph with a dotplot and bars using stat_summary
with geom = "bar"
, and geom_dotplot
geometries. 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)
.
plot_dotbar_sd(
data,
xcol,
ycol,
dotsize = 1.5,
dotthick = 1,
bwid = 0.7,
ewid = 0.2,
b_alpha = 1,
d_alpha = 1,
ColPal = "all_grafify",
ColRev = FALSE,
ColSeq = TRUE,
TextXAngle = 0,
fontsize = 20,
...
)
a data table object, e.g. 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 quantitative Y axis. This should be a quantitative variable.
size of dots relative to binwidth used by geom_dotplot
. Default set to 1.5, increase/decrease as needed.
thickness of dot border (stroke
parameter of geom_dotplot
), default set to 1.
width of bars, default set to 0.7
width of error bars, default set to 0.2.
fractional opacity of bars, default set to 1 (i.e. maximum opacity & zero transparency).
fractional opacity of dots, 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".
whether to reverse order of colour choice, default F (FALSE); can be set to T (TRUE).
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
.
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 ggplot2
geom_dotplot.
This function returns a ggplot2
object of class "gg" and "ggplot".
The X variable is mapped to the fill
aesthetic in both bar and dotplot.
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
.
The size of dots can be adjusted using the parameter, which is dotsize = 1
by default.
This function is related to plot_scatterbar_sd
, plot_dotbar_sd
and plot_dotviolin
.
plot_dotbar_sd(data = data_cholesterol,
xcol = Treatment,
ycol = Cholesterol)
#> Bin width defaults to 1/30 of the range of the data. Pick better value with `binwidth`.
plot_dotbar_sd(data = data_1w_death,
xcol = Genotype, ycol = Death,
ColPal = "pale", ColSeq = FALSE, ColRev = TRUE)
#> Bin width defaults to 1/30 of the range of the data. Pick better value with `binwidth`.