This function takes a data table, a quantitative variable (ycol
) and a Grouping variable (group
), if available, and plots a histogram graph using geom_histogram
).
plot_histogram(
data,
ycol,
group,
BinSize = 30,
linethick = 1,
c_alpha = 0.2,
ColPal = "all_grafify",
ColRev = FALSE,
ColSeq = TRUE,
TextXAngle = 0,
fontsize = 20,
Group,
alpha,
...
)
a data table e.g. data.frame or tibble.
name of the column containing the quantitative variable whose histogram distribution is to be plotted.
name of the column containing a categorical grouping variable.
bins to use on X-axis, default set to 30.
thickness of symbol border, default set to 1.
fractional opacity of colour filled within histograms, default set to 0.2 (i.e. 20% opacity).
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.
deprecated old argument for group
; retained for backward compatibility.
deprecated old argument for c_alpha
; retained for backward compatibility.
any additional arguments to pass to ggplot2
geom_histogram.
This function returns a ggplot2
object of class "gg" and "ggplot".
Note that the function requires the quantitative Y variable first, and groups them based on an X variable. The group variable is mapped to the fill
and colour
aesthetics in geom_histogram
.
ColPal & ColRev options are applied to both fill
and colour
scales. Colours available can be seen quickly with plot_grafify_palette
.
Colours can be changed using ColPal
, ColRev
or ColSeq
arguments.
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
.
#Basic usage
plot_histogram(data = data_t_pratio,
ycol = Cytokine, group = Genotype,
BinSize = 10)
#with log transformation
plot_histogram(data = data_t_pratio,
ycol = log(Cytokine), group = Genotype,
BinSize = 10)