bar - histogramme de barres

Calling Sequence

bar(y)

bar(x,y)

bar([h],x,y [,width [,color [,style]]])

Parameters

• h : un pointeur sur les axes, (par défaut: h=gca() ).
• y : un scalaire, un vecteur de taille N, ou une matrice de taille N*M
• x : un scalaire ou un vecteur de taille N, (si y est un vecteur alors x doit etre de meme longeur que y. Si y est une matrice alors x doit etre un vecteur de longeur egale au nombre de lignes de y).
• width : (optionnel), un scalaire, définit l'épaisseur des barres (un pourcentage de l'epaisseur maximum autorisé pour une barre), par défaut: width=0.8, i.e 80%.
• color : (optionnel), une chaine (par défaut: 'blue'), specifiant la couleur de l'intérieur des barres.
• style: (optionel), une chaine, 'grouped' or 'stacked' (par défaut: 'grouped').

Description

bar(y,...) : si y est un vecteur alors la fonction bar dessine une polyline de type polyline_style égale à  6, dans ce cas x =1 : length(y). Si y est une matrice de taille N*M, alors la fonction bar dessine M polylines de (type 6), chaque polyline correspond à  une colonne de y est au vecteur x=1:size(y,1).

bar(x,y,...) : si y est un vecteur alors la fonction bar dessine une polyline de type polyline_style égale à  6, vérifiant: longeur de x = longeur de y .Si y est une matrice de taille N*M, alors la fonction bar dessine M polylines de (type 6), chaque polyline correspond à  une colonne de y est au vecteur x vérifiant longueur de x=size(y,1) (i.e longueur de x = nombre de ligne de y).

bar(h,...) : definit les axes courants ou le dessin est réalisé.

bar(...,width,...) : definit l'épaisseur des barres en pourcentage (générallement: 0<width<=1).

bar(...,style,...) : dans le cas ou y est une matrice l'option style definit la façon dont les barres sont positionnées les unes par rapport aux autres. Si y est une matice N*M (donc M polylines de type 6) alors il y a 2 façons de dessiner ces M barres. l'option style fixée à  grouped' permet de centrer les M polylines par rapport aux abscisses (i.e par rapport à  chaque composantes de x), et l'option style fixée à  'stacked' permet de les empiler.

bar(...,color,...) : definit la couleur des barres. La fonction bar utilise la meme colormap que la fonction plot .

S'il y a plusieurs appels à  la fonction bar, la fonction barhomogenize permet d'homogénéiser l'épaisseur et le style de toutes les barres (i.e les polylines de type 6) inclus dans les axes courrants.

Examples

// Premier exemple : dessine une barre, avec les paramètres width=0.5
// et color='yellow' et par défaut x=1:length(y), style = 'grouped'.
scf(0);
y=[1 -3 5];
bar(y,0.5,'yellow');

// Deuxième exemple : par défaut style='grouped'
scf(1);
x=[1 2 5]; y=[1  -5 6;3 -2 7;4  -3 8];
bar(x,y);

// Troisième exemple : dessine 3 bars (nombre de colonnes de y) style='stacked'.
scf(2);
x=[1 2 5]; y=[1 4 7;2 5 8;3 6  9];
bar(x,y,'stacked');

// Quatrième exemple; width=0.2;color='green'; par défaut style='grouped'
scf(3);
x=[1 2 5]; y=[1 4 7;2 5 8;3 6 9];
bar(x,y,0.2,'green');

See Also

barh ,   barhomogenize ,   plot ,   polyline_properties ,  

Author

Farid Belahcene