metan (version 1.5.0)

barplots: 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.expand = 0.05,
  y.breaks = waiver(),
  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,
  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,
  legend.position = "bottom",
  size.line = 0.5,
  size.text = 12,
  fontfam = "sans",
  na.rm = TRUE,
  verbose = FALSE,
  plot_theme = theme_metan()
)
plot_factbars(
  .data,
  ...,
  resp,
  y.expand = 0.05,
  y.breaks = waiver(),
  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,
  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.expand

A multiplication range expansion factor. Defaults to 0.05.

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.

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.

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 30% of width.bar.

level

The confidence level

invert

Logical argument. If TRUE, the order of the factors entered in changes in the graph

width.bar

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

legend.position

The position of the legend in the plot.

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

Value

An object of class gg, ggplot.

See Also

plot_lines, plot_factlines

Examples

# NOT RUN {
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
                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
                plot_theme = ggplot2::theme_gray()) #change plot themes
arrange_ggplot(p1, p2)
# }