\HeaderA{chart.CumReturns}{Cumulates and graphs a set of periodic returns}{chart.CumReturns}
\keyword{ts}{chart.CumReturns}
\keyword{multivariate}{chart.CumReturns}
\keyword{distribution}{chart.CumReturns}
\keyword{models}{chart.CumReturns}
\keyword{hplot}{chart.CumReturns}
\begin{Description}\relax
Chart that cumulates the periodic returns given and draws a line graph of the results as a "wealth index".
\end{Description}
\begin{Usage}
\begin{verbatim}
chart.CumReturns(R, wealth.index = FALSE, legend.loc = NULL, colorset =(1:12), begin = c("first","axis"), ...)
\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{wealth.index}] if \code{wealth.index} is \code{TRUE}, shows the "value of \$1", starting the cumulation of returns at 1 rather than zero 
\item[\code{legend.loc}] places a legend into one of nine locations on the chart: bottomright, bottom, bottomleft, left, topleft, top, topright, right, or center. 
\item[\code{colorset}] color palette to use, set by default to rational choices 
\item[\code{begin}] Align shorter series to:
\Itemize{
\item first - prior value of the first column given for the reference or longer series or,
\item axis  - the initial value (1 or zero) of the axis.
}

\item[\code{...}] any other passthru parameters 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Cumulates the return series and displays either as a wealth index or as cumulative returns.
\end{Details}
\begin{Value}
A timeseries line chart of the cumulative return series.
\end{Value}
\begin{Author}\relax
Peter Carl
\end{Author}
\begin{References}\relax
Bacon, Carl. \emph{Practical Portfolio Performance Measurement and Attribution}. Wiley. 2004. \\
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{chart.TimeSeries}{chart.TimeSeries}} \\
\code{\LinkA{plot}{plot}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(edhec)
chart.CumReturns(edhec[,"Funds of Funds",drop=FALSE],main="Cumulative Returns")
chart.CumReturns(edhec[,"Funds of Funds",drop=FALSE],wealth.index=TRUE, main="Value of \$1")
\end{ExampleCode}
\end{Examples}

