Fast way to create bar plots

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.

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

Tiago Olivoto tiagoolivoto@gmail.com

Examples

# \donttest{
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)
# }

Arguments

Value

See also

Author

Examples