barplots: Fast way to create bar plots

In metan: Multi Environment Trials Analysis

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)

metan documentation built on March 7, 2023, 5:34 p.m.