View source: R/create_bar_plot.R
create_bar_plot | R Documentation |
Function creates a ggplot2 based bar plot with optional scaling and ordering.
create_bar_plot(
df,
aes_x = NULL,
aes_y = NULL,
aes_color = NULL,
aes_fill = NULL,
position = "stack",
title = NULL,
subtitle = NULL,
caption = NULL,
center_titles = FALSE,
x_title = NULL,
y_title = NULL,
hide_x_tics = FALSE,
hide_y_tics = FALSE,
rot_x_tic_angle = 0,
rot_y_tic_label = FALSE,
bar_fill = NA,
bar_color = "black",
bar_alpha = 1,
bar_size = 1,
bar_width = NULL,
x_major_breaks = NULL,
y_limits = NULL,
y_major_breaks = waiver(),
y_minor_breaks = waiver(),
y_labels = waiver(),
axis_text_size = 11,
do_coord_flip = FALSE,
order_bars = NULL,
bar_labels = FALSE,
bar_label_sz = 4,
bar_label_color = "black",
bar_label_fontface = "plain",
bar_label_alpha = 1,
show_major_grids = TRUE,
show_minor_grids = TRUE,
panel_color = "white",
panel_border_color = "black",
show_legend = TRUE,
legend_pos = "right",
legend_key_width = 0.7,
legend_key_height = 0.7,
legend_key_backgrd = "white",
silent_NA_warning = FALSE,
png_file_path = NULL,
png_width_height = c(480, 480)
)
df |
The target data frame for the bar chart. |
aes_x |
Sets the x axis discrete variable name from |
aes_y |
Sets the y axis numeric variable name from |
aes_color |
Sets the variable name from |
aes_fill |
Sets the variable name from |
position |
A string that sets the bar positions. Acceptable values are |
title |
A string that sets the overall title. |
subtitle |
A string that sets the overall subtitle. |
caption |
A string that sets the captiion. |
center_titles |
A logical which if |
x_title |
A string that sets the x axis title. If NULL (the default) then the x axis title does not appear. |
y_title |
A string that sets the y axis title. If NULL (the default) then the y axis title does not appear. |
hide_x_tics |
A logical that controls the appearance of the x axis tics. |
hide_y_tics |
A logical that controls the appearance of the y axis tics. |
rot_x_tic_angle |
A numeric that sets the angle of rotation for the x tic label. When x tic labels are long, a value of 40 for this argument usually works well. |
rot_y_tic_label |
A logical which if TRUE rotates the y tic labels 90 degrees for enhanced readability. |
bar_fill |
A string that sets the fill color attribute for the bars. |
bar_color |
A string that sets the outline color attribute for the bars. |
bar_alpha |
A numeric that sets the alpha component attribute to |
bar_size |
A numeric that sets the outline thickness attribute of the bars. |
bar_width |
A numeric that sets the width attribute of the bars. |
x_major_breaks |
If |
y_limits |
A numeric 2 element vector that sets the minimum and maximum for the y axis. Use NA to refer to the existing minimum and maximum. |
y_major_breaks |
A numeric vector or function that defines the exact major tic locations along the y axis. |
y_minor_breaks |
A numeric vector or function that defines the exact minor tic locations along the y axis. |
y_labels |
A character vector with the same length as |
axis_text_size |
A numeric that sets the font size along the axis'. Default is 11. |
do_coord_flip |
A logical which if |
order_bars |
A string which will order the bars in a specific direction. Acceptable values are "asc" or "desc" |
bar_labels |
A logical which if |
bar_label_sz |
A numeric that sets the size of the label. |
bar_label_color |
A string that sets the label's color. |
bar_label_fontface |
A string that sets the label's font face. Acceptable values are "plain", "bold", "italic", "bold.italic". |
bar_label_alpha |
A numeric that sets the label's alpha value. |
show_major_grids |
A logical that controls the appearance of major grids. |
show_minor_grids |
A logical that controls the appearance of minor grids. |
panel_color |
A string in hexidecimal or color name that sets the plot panel's color. The default is "white". |
panel_border_color |
A string in hexidecimal or color name that sets the plot panel's border color. The default is "black". |
show_legend |
A logical that controls the appearance of the legend. |
legend_pos |
A string that sets the legend position. Acceptable values are "top", "bottom", "left", "right". |
legend_key_width |
A numeric that sets the legend width in cm. |
legend_key_height |
A numeric that sets the legend height in cm. |
legend_key_backgrd |
A string that sets the legend's background color. |
silent_NA_warning |
A logical that controls the appearance of a console warning when Na's are removed. |
png_file_path |
A character string with the directory and file name to produce a png image of the plot. |
png_width_height |
A numeric vector that sets the width and height of the png image in pixels. The default is c(480,480). There are 37.8 pixels in a centimeter. |
A plot object.
Rick Dean
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.