cwaitbar.m 1.0

An extension/generalization of the MATLAB's WAITBAR function. Used when you want to show progress in "nested computations". Supports different coloring of bars other than the default red color. See example below on usage.%%%%%CWAITBAR Display compound wait bar.H = CWAITBAR(X,TITLE) creates and displays wait bars offractional lengths X and with one title string TITLE.The handle to the compound waitbar figure is returned in H.X values should be between 0 and 1.Each subsequent call to cwaitbar, CWAITBAR([BAR X]),extends the length of the bar BAR to the new position X.The first bar is the topmost bar and is BAR = 1 whichcorresponds to the outermost loop.H = CWAITBAR(X,TITLE) where TITLE is a cellstring with samenumber of titles as there are fractional lengths in X.Suitable for showing the bars' corresponding loop indices.H = CWAITBAR(X,TITLE,COLOR) where COLOR is the color of thebars. COLOR is either a color code character (see PLOT) oran RGB vector. The default color is red. COLOR can also bea cell array with same number of elements as there are barsin the cwaitbar figure.The order of the elements in vector X and cell arrays TITLEand COLOR which is consistent with the bar number BAR is:The first element corresponds to the first bar at the topof the figure which in turn corresponds to the outermost loop.CWAITBAR is typically used inside nested FOR loops thatperforms lengthy computations.Examples:cwaitbar([.3 .2 .7],'Please wait...'); %single titleh = cwaitbar([0 0 0],{'i','j','k'},{[.8 .2 .8],'b','r'});for i=1:5,% computations %for j=1:10% computations %for k=1:100% computations %cwaitbar([3 k/100])endcwaitbar([2 j/10])endcwaitbar([1 i/5])endclose(h)See also WAITBAR.

Requirements:	No special requirements
Platforms:	Matlab
Keyword:	Array,  Arrays,  Bars,  Barsin,  Consistent,  Cwaitbarxtitlecolor,  Element,  Elements,  Figurethe,  Fractional,  Indicesh,  Isthe,  Number,  Order,  Showing,  Titleand,  Vector,  Xsuitable
Users rating:	0/10