\HeaderA{chart.RelativePerformance}{relative performance chart between multiple return series}{chart.RelativePerformance}
\keyword{ts}{chart.RelativePerformance}
\keyword{multivariate}{chart.RelativePerformance}
\keyword{distribution}{chart.RelativePerformance}
\keyword{models}{chart.RelativePerformance}
\keyword{hplot}{chart.RelativePerformance}
\begin{Description}\relax
Plots a time series chart that shows the ratio of the cumulative performance for two assets at each point in time and makes periods of under- or out-performance easier to see.
\end{Description}
\begin{Usage}
\begin{verbatim}
chart.RelativePerformance(Ra, Rb, main = "Relative Performance", xaxis = TRUE, colorset = (1:12), legend.loc = NULL, ylog = FALSE, elementcolor = "darkgray", lty = 1, cex.legend=0.7, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{Ra}] an xts, vector, matrix, data frame, timeSeries or zoo object of asset returns 
\item[\code{Rb}] return vector of the benchmark asset 
\item[\code{main}] set the chart title, same as in \code{plot} 
\item[\code{xaxis}] if true, draws the x axis 
\item[\code{colorset}] color palette to use, set by default to rational choices 
\item[\code{elementcolor}] provides the color for drawing less-important chart elements, such as the box lines, axis lines, etc. replaces \code{darken} 
\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{ylog}] TRUE/FALSE set the y-axis to logarithmic scale, similar to \code{\LinkA{plot}{plot}}, default FALSE 
\item[\code{cex.legend}] the magnification to be used for sizing the legend relative to the current setting of 'cex'.  
\item[\code{lty}] set the line type, same as in \code{\LinkA{plot}{plot}} 
\item[\code{...}] any other passthru parameters 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
To show under- and out-performance through different periods of time, a time series view
is more helpful. The value of the chart is less important than the slope of the line. If
the slope is positive, the first asset (numerator) is outperforming the second, and vice versa.
May be used to look at the returns of a fund relative to each member of the peer
group and the peer group index.
Alternatively, it might be used to assess the peers individually against an asset class or peer group index.
\end{Details}
\begin{Value}
chart of relative returns
\end{Value}
\begin{Author}\relax
Peter Carl
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{Return.relative}{Return.relative}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(managers)
chart.RelativePerformance(managers[, 1:6, drop=FALSE], managers[, 8, drop=FALSE], colorset=rich8equal, legend.loc="bottomright", main="Relative Performance to S&P")
\end{ExampleCode}
\end{Examples}

