barplots {metan}

Fast way to create bar plots

Description

• plot_bars() Creates a bar plot based on one categorical variable and one numeric variable. It can be used to show the results of a one-way trial with qualitative treatments.

• plot_factbars() Creates a bar plot based on two categorical variables and one numeric variable. It can be used to show the results of a two-way trial with qualitative-qualitative treatment structure.

Usage

plot_bars(
  .data,
  x,
  y,
  order = NULL,
  y.lim = NULL,
  y.breaks = waiver(),
  y.expand = 0.05,
  y.contract = 0,
  xlab = NULL,
  ylab = NULL,
  n.dodge = 1,
  check.overlap = FALSE,
  color.bar = "black",
  fill.bar = "gray",
  lab.bar = NULL,
  lab.bar.hjust = 0.5,
  lab.bar.vjust = -0.5,
  lab.bar.angle = 0,
  size.text.bar = 5,
  values = FALSE,
  values.hjust = 0.5,
  values.vjust = 1.5,
  values.angle = 0,
  values.digits = 2,
  values.size = 4,
  lab.x.hjust = 0.5,
  lab.x.vjust = 1,
  lab.x.angle = 0,
  errorbar = TRUE,
  stat.erbar = "se",
  width.erbar = NULL,
  level = 0.95,
  invert = FALSE,
  width.bar = 0.9,
  size.line = 0.5,
  size.text = 12,
  fontfam = "sans",
  na.rm = TRUE,
  verbose = FALSE,
  plot_theme = theme_metan()
)

plot_factbars(
  .data,
  ...,
  resp,
  y.lim = NULL,
  y.breaks = waiver(),
  y.expand = 0.05,
  y.contract = 0,
  xlab = NULL,
  ylab = NULL,
  n.dodge = 1,
  check.overlap = FALSE,
  lab.bar = NULL,
  lab.bar.hjust = 0.5,
  lab.bar.vjust = -0.5,
  lab.bar.angle = 0,
  size.text.bar = 5,
  values = FALSE,
  values.hjust = 0.5,
  values.vjust = 1.5,
  values.angle = 0,
  values.digits = 2,
  values.size = 4,
  lab.x.hjust = 0.5,
  lab.x.vjust = 1,
  lab.x.angle = 0,
  errorbar = TRUE,
  stat.erbar = "se",
  width.erbar = NULL,
  level = 0.95,
  invert = FALSE,
  col = TRUE,
  palette = "Spectral",
  width.bar = 0.9,
  legend.position = "bottom",
  size.line = 0.5,
  size.text = 12,
  fontfam = "sans",
  na.rm = TRUE,
  verbose = FALSE,
  plot_theme = theme_metan()
)

Arguments

.data

The data set.

x, y

Argument valid for plot_bars() The variables to be mapped to the x and y axes, respectively.

order

Argument valid for plot_bars(). Controls the order of the factor in the x axis. Defaults to the order of the factors in .data. Use order = "asce" or order = "desc" to reorder the labels to ascending or descending order, respectively, based on the values of the variable y.

y.lim

The range of y axis. Defaults to NULL (maximum and minimum values of the data set). New values can be inserted as y.lim = c(y.min, y.max).

y.breaks

The breaks to be plotted in the y-axis. Defaults to waiver(). ⁠authomatic breaks⁠. The same arguments than x.breaks can be used.

y.expand, y.contract

A multiplication range expansion/contraction factor. y.expand expands the upper limit of the y escale, while y.contract contracts the lower limit of the y scale. By default y.expand = 0.05 and y.contract = 0 produces a plot without spacing in the lower y limit and an expansion in the upper y limit.

xlab, ylab

The labels of the axes x and y, respectively. Defaults to NULL.

n.dodge

The number of rows that should be used to render the x labels. This is useful for displaying labels that would otherwise overlap.

check.overlap

Silently remove overlapping labels, (recursively) prioritizing the first, last, and middle labels.

color.bar, fill.bar

Argument valid for plot_bars(). The color and fill values of the bars.

lab.bar

A vector of characters to show in each bar. Defaults to NULL.

lab.bar.hjust, lab.bar.vjust

The horizontal and vertical adjust for the labels in the bar. Defaults to 0.5 and -0.5, respectively.

lab.bar.angle

The angle for the labels in the plot. Defaults to 0. Use in combination with lab.bar.hjust and lab.bar.vjust to best fit the labels in the plot.

size.text.bar

The size of the text in the bar labels.

values

Logical argument. Shows the values in the plot bar? Defaults to FALSE

values.hjust, values.vjust

The horizontal and vertical adjust for the values in the bar. Defaults to 0.5 and 1.5, respectively. If values = TRUE the values are shown bellow the error bar.

values.angle

The angle for the labels in the plot. Defaults to 0. Use in combination with values.hjust and values.vjust to best fit the values in the plot bar.

values.digits

The significant digits to show if values = TRUE. Defaults to 2.

values.size

The size of the text for values shown in the bars. Defaults to 3.

lab.x.hjust, lab.x.vjust

The horizontal and vertical adjust for the labels in the bar. Defaults to 0.5 and 1, respectively.

lab.x.angle

The angle for the labels in x axis. Defaults to 0. Use in combination with lab.x.hjust and lab.x.vjust to best fit the labels in the axis.

errorbar

Logical argument, set to TRUE. In this case, an error bar is shown.

stat.erbar

The statistic to be shown in the errorbar. Must be one of the stat.erbar = "se" (standard error, default), stat.erbar = "sd" (standard deviation), or stat.erbar = "ci" (confidence interval), based on the confidence level in the argument level.

width.erbar

The width of the error bar. Defaults to 25% of width.bar.

level

The confidence level

invert

Logical argument. If TRUE, rotate the plot in plot_bars() and invert the order of the factors in plot_factbars().

width.bar

The width of the bars in the graph. Defaults to 0.9. Possible values are in the range 0-1.

size.line

The size of the line in the bars. Default to 0.5.

size.text

The size of the text. Default to 12.

fontfam

The family of the font text. Defaults to "sans".

na.rm

Should 'NA' values be removed to compute the statistics? Defaults to true

verbose

Logical argument. If TRUE a tibble containing the mean, N, standard deviation, standard error of mean and confidence interval is returned.

plot_theme

The graphical theme of the plot. Default is plot_theme = theme_metan(). For more details, see ggplot2::theme().

...

Argument valid for plot_factbars(). A comma-separated list of unquoted variable names. Sets the two variables to be mapped to the x axis.

resp

Argument valid for plot_factbars(). The response variable to be mapped to the y axis.

col

Logical argument valid for plot_factbars(). If FALSE, a gray scale is used.

palette

Argument valid for plot_factbars() The color palette to be used. For more details, see ?scale_colour_brewer

legend.position

The position of the legend in the plot.

Value

An object of class ⁠gg, ggplot⁠.

Author(s)

Tiago Olivoto [e-mail]

See Also

plot_lines(), plot_factlines()

Examples

library(metan)
# two categorical variables
plot_factbars(data_ge2,
              GEN,
              ENV,
              resp = PH)

# one categorical variable
p1 <- plot_bars(data_g, GEN, PH)
p2 <- plot_bars(data_g, GEN, PH,
                n.dodge = 2, # two rows for x labels
                y.expand = 0.1, # expand y scale
                y.contract = -0.75, # contract the lower limit
                errorbar = FALSE, # remove errorbar
                color.bar = "red", # color of bars
                fill.bar = alpha_color("cyan", 75), # create a transparent color
                lab.bar = letters[1:13]) # add labels
arrange_ggplot(p1, p2)