% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/ms_histogramchart.R
\name{ms_histogramchart}
\alias{ms_histogramchart}
\title{Histogram chart object}
\usage{
ms_histogramchart(
  data,
  value,
  bin_count = NULL,
  bin_width = NULL,
  interval_closed = c("right", "left"),
  underflow = NULL,
  overflow = NULL
)
}
\arguments{
\item{data}{a data.frame.}

\item{value}{numeric column name (raw observations).}

\item{bin_count}{integer, requested number of bins. Mutually exclusive
with \code{bin_width}. NULL = automatic.}

\item{bin_width}{numeric, requested bin width. Mutually exclusive with
\code{bin_count}. NULL = automatic.}

\item{interval_closed}{one of \code{"right"} (default) or \code{"left"}. Defines
which end of each bin is inclusive.}

\item{underflow}{numeric, values below this go in an "underflow" bin.
NULL to disable.}

\item{overflow}{numeric, values above this go in an "overflow" bin.
NULL to disable.}
}
\value{
An \code{ms_chart} object (subclass \code{ms_histogramchart}).
}
\description{
Creation of a histogram chart object that can be inserted
in a 'Microsoft' document. Histogram charts use the chartEx pipeline
(Office 2016+); older versions of 'Microsoft Office' will display a
fallback placeholder.

Data is a single column of raw numeric observations. Office computes
the bins automatically; pass \code{bin_count} or \code{bin_width} to override.
}
\examples{
library(officer)

set.seed(1)
dat <- data.frame(x = rnorm(200, mean = 10, sd = 4))
hi <- ms_histogramchart(dat, value = "x", bin_count = 12)

doc <- read_pptx()
doc <- add_slide(doc)
doc <- ph_with(doc, hi, location = ph_location_fullsize())
print(doc, target = tempfile(fileext = ".pptx"))
}
\seealso{
\code{\link[=chart_labels]{chart_labels()}}

Other 'Office' chart objects:
\code{\link[=ms_areachart]{ms_areachart()}},
\code{\link[=ms_barchart]{ms_barchart()}},
\code{\link[=ms_boxplotchart]{ms_boxplotchart()}},
\code{\link[=ms_bubblechart]{ms_bubblechart()}},
\code{\link[=ms_chart_combine]{ms_chart_combine()}},
\code{\link[=ms_funnelchart]{ms_funnelchart()}},
\code{\link[=ms_linechart]{ms_linechart()}},
\code{\link[=ms_paretochart]{ms_paretochart()}},
\code{\link[=ms_piechart]{ms_piechart()}},
\code{\link[=ms_radarchart]{ms_radarchart()}},
\code{\link[=ms_scatterchart]{ms_scatterchart()}},
\code{\link[=ms_stockchart]{ms_stockchart()}},
\code{\link[=ms_sunburstchart]{ms_sunburstchart()}},
\code{\link[=ms_treemapchart]{ms_treemapchart()}},
\code{\link[=ms_waterfallchart]{ms_waterfallchart()}}
}
\concept{'Office' chart objects}
