\HeaderA{chart.Boxplot}{box whiskers plot wrapper}{chart.Boxplot}
\keyword{ts}{chart.Boxplot}
\keyword{multivariate}{chart.Boxplot}
\keyword{distribution}{chart.Boxplot}
\keyword{models}{chart.Boxplot}
\keyword{hplot}{chart.Boxplot}
\begin{Description}\relax
A wrapper to create box and whiskers plot with some defaults useful for comparing distributions.
\end{Description}
\begin{Usage}
\begin{verbatim}
chart.Boxplot(R, horizontal = TRUE, names = TRUE, as.Tufte = FALSE, sort.by = c(NULL, "mean", "median", "variance"), colorset = "black", symbol.color = "red", mean.symbol = 1, median.symbol = "|", outlier.symbol = 1, show.data = NULL, add.mean = TRUE, sort.ascending = FALSE, xlab = "Return", main = "Return Distribution Comparison", element.color = "darkgray", ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{R}] an xts, vector, matrix, data frame, timeSeries or zoo object of asset returns 
\item[\code{horizontal}] TRUE/FALSE plot horizontal (TRUE) or vertical (FALSE)  
\item[\code{names}] logical. if TRUE, show the names of each series 
\item[\code{as.Tufte}] logical. default FALSE. if TRUE use method derived for Tufte for limiting chartjunk 
\item[\code{sort.ascending}] logical.  If TRUE sort the distributions by ascending \code{sort.by} 
\item[\code{sort.by}] one of "NULL", "mean", "median", "variance" 
\item[\code{colorset}] color palette to use, set by default to rational choices 
\item[\code{symbol.color}] draws the symbols described in \code{mean.symbol},\code{median.symbol},\code{outlier.symbol} in the color specified 
\item[\code{mean.symbol}] symbol to use for the mean of the distribution 
\item[\code{median.symbol}] symbol to use for the median of the distribution 
\item[\code{outlier.symbol}] symbol to use for the outliers of the distribution 
\item[\code{show.data}] numerical vector of column numbers to display on top of boxplot, default NULL 
\item[\code{add.mean}] logical. if TRUE, show a line for the mean of all distributions plotted
\item[\code{xlab}] set the x-axis label, same as in \code{\LinkA{plot}{plot}} 
\item[\code{main}] set the chart title, same as in \code{\LinkA{plot}{plot}} 
\item[\code{element.color}] specify the color of chart elements.  Default is "darkgray" 
\item[\code{...}] any other passthru parameters 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
We have also provided controls for all the symbols and lines in the chart.  One default, set by \code{as.Tufte=TRUE}, will strip chartjunk and draw a Boxplot per recommendations by Edward Tufte. It can also be useful when comparing several series to sort them in order of ascending or descending "mean", "median", "variance" by use of \code{sort.by} and \code{sort.ascending=TRUE}.
\end{Details}
\begin{Value}
box plot of returns
\end{Value}
\begin{Author}\relax
Peter Carl
\end{Author}
\begin{References}\relax
Tufte, Edward R.  \emph{The Visual Display of Quantitative Information}. Graphics Press. 1983. p. 124-129
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{boxplot}{boxplot}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(edhec)
chart.Boxplot(edhec)
chart.Boxplot(edhec,as.Tufte=TRUE)
\end{ExampleCode}
\end{Examples}

