barhomogenize

homogenize all the bars included in the current working axes

Calling Sequence

barhomogenize()
barhomogenize([h[,'style'[,'width']]])

Arguments

h an axes handle, (default:
 h=gca() ).

: :style a string, ‘grouped’ or ‘stacked’ (default: ‘grouped’). : :width (optional), a real scalar, defines the width (a percentage of

the available room) for the bar (default: 0.8).

:

Description

If there are several bar calls, the barhomogenize function allows to homogenize the width and style of all bars (i.e which has the polyline_style type 6) included in the current working axes. These bars must have the same x data.

barhomogenize( ) : takes the default values, h=gca(), width=0.8, style=’grouped’. ``

barhomogenize(h,...) : defines the current axes where the drawing is performed.

barhomogenize(...,width,...) : defines the width of the bar(s) in percentage (generally: 0<width<=1).

barhomogenize(...,style,...) : defines how the bars are drawn. The ‘grouped’ option allows to center the M polylines versus each components of x, and the ‘stacked’ option allows to stack them.

Sample

Examples

// First example: creation of 1 yellow bar (i.e 1 polyline with polyline_style=6) and 3 bars (i.e 3 polylines with polyline_style=6)
`subplot`_(2,3,1)
`xtitle`_('ex1: creation of 1 yellow bar and 3 bars')
x=1:3;
y1=1:3;
y2=[4 3 5;6 7 8;9 10 11];
`bar`_(x,y1,'yellow');`bar`_(x,y2);

// grouped homogenisation of these 4 bars
`subplot`_(2,3,2)
`xtitle`_('grouped homogenisation')
x=1:3;
y1=1:3;
y2=[4 3 5;6 7 8;9 10 11];
`bar`_(x,y1,'yellow');`bar`_(x,y2);
barhomogenize();

// stacked homogenisation of the 4 bars
`subplot`_(2,3,3)
`xtitle`_('stacked homogenisation')
x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
`bar`_(x,y1,'yellow');`bar`_(x,y2);
barhomogenize('stacked',1);

// Second example : creation of 1 red bar (i.e 1 polyline with polyline_style=6) and 2 polylines with type=1 (calling plot function)
`subplot`_(2,3,4)
`xtitle`_('ex2: creation of 1 bar and 2 polylines')
x=1:10;
y=`sin`_(x)/2;
`bar`_(x,y,'red')
x1=1:10;
y1=[`sin`_(x);`cos`_(x)]
`plot`_(x1,y1)

// modify the polyline_style type of the second polyline from plot (this polyline becomes a bar)
`subplot`_(2,3,5)
`xtitle`_('transformation of the second polyline to bar')
x=1:10;
y=`sin`_(x)/2;
`bar`_(x,y,'red')
x1=1:10;
y1=[`sin`_(x);`cos`_(x)]
`plot`_(x1,y1)
e=`gce`_();
e2=e.children(2);
e2.polyline_style=6;

// homogenisation of the first bar (from bar function) and second bar (from the modification).
`subplot`_(2,3,6)
`xtitle`_('grouped homogenisation')
x=1:10;
y=`sin`_(x)/2;
`bar`_(x,y,'red')
x1=1:10;
y1=[`sin`_(x);`cos`_(x)]
`plot`_(x1,y1)
e=`gce`_();
e2=e.children(2);
e2.polyline_style=6;
barhomogenize();
// change the style and the width
//barhomogenize('stacked',0.5);
//barhomogenize('stacked',1);

See Also

Table Of Contents

This Page