R: Histogram

histogram

R Documentation

Histogram

Description

Create a histogram based on the output of the hist function in the graphics package.

Usage

histogram(
  vector = NULL,
  breaks = NULL,
  counts = NULL,
  percent = FALSE,
  bin_fill_color = "green4",
  bin_border_color = "black",
  bin_border_thickness = 1,
  notify_na_count = NULL,
  x_axis_tick_marks = NULL,
  y_axis_tick_marks = NULL,
  cap_axis_lines = TRUE,
  x_axis_title = "Value",
  y_axis_title = NULL,
  y_axis_title_vjust = 0.85
)

Arguments

`vector`	a numeric vector
`breaks`	a numeric vector indicating breaks for the bins. By default, no input is required for this argument.
`counts`	a numeric vector containing counts for the bins (i.e., heights of the bins). By default, no input is required for this argument.
`percent`	logical. If `percent = TRUE`, percentages will be plotted rather than frequencies (default = FALSE).
`bin_fill_color`	color of the area inside each bin (default = "green4")
`bin_border_color`	color of the border around each bin (default = "black")
`bin_border_thickness`	thickness of the border around each bin (default = 1)
`notify_na_count`	if `TRUE`, notify how many observations were removed due to missing values. By default, NA count will be printed only if there are any NA values.
`x_axis_tick_marks`	a vector of values at which to place tick marks on the x axis (e.g., setting `x_axis_tick_marks = seq(0, 10, 5)` will put tick marks at 0, 5, and 10.)
`y_axis_tick_marks`	a vector of values at which to place tick marks on the y axis (e.g., setting `y_axis_tick_marks = seq(0, 10, 5)` will put tick marks at 0, 5, and 10.)
`cap_axis_lines`	logical. Should the axis lines be capped at the outer tick marks? (default = FALSE)
`x_axis_title`	title for x axis (default = "Value")
`y_axis_title`	title for y axis (default = "Count" or "Percentage", depending on the value of `percent`)
`y_axis_title_vjust`	position of the y axis title (default = 0.85).

Value

the output will be a histogram, a ggplot object.

Examples


histogram(1:100)
histogram(c(1:100, NA))
histogram(vector = mtcars[["mpg"]])
histogram(vector = mtcars[["mpg"]], percent = TRUE)
histogram(vector = mtcars[["mpg"]],
x_axis_tick_marks = c(10, 25, 35), y_axis_title_vjust = 0.5,
y_axis_title = "Freq", x_axis_title = "Values of mpg")