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,
  ...
)

Arguments

data

a data table e.g. data.frame or tibble.

ycol

name of the column containing the quantitative variable whose histogram distribution is to be plotted.

group

name of the column containing a categorical grouping variable.

BinSize

bins to use on X-axis, default set to 30.

linethick

thickness of symbol border, default set to 1.

c_alpha

fractional opacity of colour filled within histograms, default set to 0.2 (i.e. 20% opacity).

ColPal

grafify colour palette to apply, default "all_grafify"; alternatives: "okabe_ito", "bright", "pale", "vibrant", "contrast", "muted" "dark", "light".

ColRev

whether to reverse order of colour choice, default F (FALSE); can be set to T (TRUE).

ColSeq

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.

TextXAngle

orientation of text on X-axis; default 0 degrees. Change to 45 or 90 to remove overlapping text.

fontsize

parameter of base_size of fonts in theme_classic, default set to size 20.

Group

deprecated old argument for group; retained for backward compatibility.

alpha

deprecated old argument for c_alpha; retained for backward compatibility.

...

any additional arguments to pass to ggplot2geom_histogram.

Value

This function returns a ggplot2 object of class "gg" and "ggplot".

Details

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.

Examples

#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)