

    \filetitle{barcon}{Contribution bar graph for tseries objects}{tseries/barcon}

	\paragraph{Syntax}
 
 \begin{verbatim}
 [h,range] = barcon(x,...)
 [h,range] = barcon(range,x,...)
 [h,range] = barcon(a,range,x,...)
 \end{verbatim}
 \paragraph{Input arguments}
 
 \begin{itemize}
 \item
   \texttt{a} {[} numeric {]} - Handle to axes in which the graph will be
   plotted; if not specified, the current axes will used.
 \item
   \texttt{range} {[} numeric {]} - Date range; if not specified the
   entire range of the input tseries object will be plotted.
 \item
   \texttt{x} {[} tseries {]} - Input tseries object whose columns will
   be ploted as a contribution bar graph.
 \end{itemize}
 \paragraph{Output arguments}
 
 \begin{itemize}
 \item
   \texttt{h} {[} numeric {]} - Handle(s) to the bars plotted.
 \item
   \texttt{range} {[} numeric {]} - Actually plotted date range.
 \end{itemize}
 \paragraph{Options}
 
 \begin{itemize}
 \item
   \texttt{'barWidth='} {[} numeric \textbar{} \emph{0.8} {]} - Width of
   bars as a percentage of the space each period occupies on the x-axis.
 \item
   \texttt{'colorMap='} {[} numeric \textbar{}
   \emph{get(gcf(),`colorMap')} {]} - Color map used to fill the
   contribution bars.
 \item
   \texttt{'dateFormat='} {[} char \textbar{}
   \emph{irisget(`plotdateformat')} {]} - Date format for the tick marks
   on the x-axis.
 \item
   \texttt{'dateTick='} {[} numeric \textbar{} \emph{\texttt{Inf}} {]} -
   Vector of dates locating tick marks on the x-axis; Inf means they will
   be created automatically.
 \item
   \texttt{'evenlySpread='} {[} \emph{\texttt{true}} \textbar{}
   \texttt{false} {]} - Colors picked for the contribution bars are
   evenly spread across the color map.
 \item
   \texttt{'ordering='} {[} `ascend' \textbar{} `descend' \textbar{}
   \emph{`preserve'} \textbar{} numeric {]} - Ordering of contributions
   with the same sign withinin each period; \texttt{'preserve'} means the
   original order will be preserved.
 \end{itemize}
 \paragraph{Description}
 
 \paragraph{Example}


