plot_histogram {fabR}R Documentation

Draw histogram of one (possibly grouped) column in a tibble

Description

This function draws a histogram plot of the values of a column. Missing values can be given as input to non-valid and valid values separately, or grouped by another column. The output can be editable (using plotly library) or static (using ggplot2 library). The R-code is also editable for coding recycling purpose.

Usage

plot_histogram(
  tbl = "airquality",
  col = "Ozone",
  filter = "c()",
  negate = FALSE,
  missing_values = "c()",
  out = "ggplot2-cat",
  group_by = NULL
)

Arguments

tbl

A character string or tibble specifying the input tibble

col

A character string specifying a column of interest

filter

A character string specifying the values to filter. (equivalent to 'values in') This determines which values should be retained. It can be applied to both grouped and ungrouped data.

negate

If TRUE, return non-matching elements.

missing_values

Vector listing values to exclude from valid values. These values will not be excluded from counting - but will be displayed separately from valid values.

out

parameter that specifies the output expected: can be either 'ggplot2', 'plotly','ggplot2-code', 'plotly-code','ggplot2-cat' or 'plotly-cat'. ggplot2 renders a static plot, plotly a dynamic plot, code gives the code in a string (usable directly with eval/parse functions) and cat provides indented code in the console.

group_by

A character string of one column in the tbl that can be taken as a grouping column. The visual element will be grouped and displayed by this column.

Value

A hist plot object

See Also

ggplot2::ggplot()

Examples

{

##### Example 1 -------------------------------------------------------------
# cat output generated as a template when no argument provided
plot_histogram()

##### Example 2 -------------------------------------------------------------
# graph of Petal.Length
plot_histogram(tbl = iris, col = "Petal.Length", out = "ggplot2")

}


[Package fabR version 1.1.1 Index]