insurancerating (version 0.6.3)

histbin: Create a histogram with outlier bins

Description

Visualize the distribution of a single continuous variable by dividing the x axis into bins and counting the number of observations in each bin. Data points that are considered outliers can be binned together. This might be helpful to display numerical data over a very wide range of values in a compact way.

Usage

histbin(
  data,
  x,
  left = NULL,
  right = NULL,
  line = FALSE,
  bins = 30,
  fill = "#E7B800",
  fill_outliers = "#a7d1a7"
)

Arguments

data

data.frame

x

variable name in data.frame `data` that should be mapped

left

numeric indicating the floor of the range

right

numeric indicating the ceiling of the range

line

show density line (default is FALSE)

bins

numeric to indicate number of bins

fill

color used to fill bars

fill_outliers

color used to fill outlier bars

Value

a ggplot2 object

Details

Wrapper function around `ggplot2::geom_histogram()`. The method is based on suggestions from https://edwinth.github.io/blog/outlier-bin/.

Examples

# NOT RUN {
histbin(MTPL2, premium)
histbin(MTPL2, premium, left = 30, right = 120, line = TRUE, bins = 30)

# }