barh - histogramme horizontal de barres

Calling Sequence

barh(y)

barh(x,y)

barh([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: 0.8=80%.
• color : (optionnel), une chaine (par défaut: 'blue'), specifiant la couleur intérieur des barres.
• style: (optionnel), une chaine, 'grouped' or 'stacked' (par défaut: 'grouped').

Description

barh(y,...) : si y est un vecteur alors la fonction barh 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).

barh(x,y,...) : si y est un vecteur alors la fonction barh dessine une polyline de type polyline_style égale à  6, vérifiant: longeur de x length = 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 nombre de ligne de y).

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

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

barh(...,style,...) : dans le cas ou y est une matrice l'option style definit la façon dont les barres sont dessiné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 'grouped' permet de centrer les M polylines par rapport aux abscisses (i.e par rapport à  chaque composantes de x), et l'option 'stacked' permet de les empiler.

barh(...,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 barh, 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 juste une barre, width=0.5, color='yellow', par défaut x=1:length(y)
scf(0);
y=[1 -3 5];
barh(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];
barh(x,y);

// Troisième exemple : dessine 3 barres (nombre de colonnes de y) style='stacked'.
scf(2);
x=[1 2 5]; y=[1 4 7;2 5 8;3 6  9];
barh(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];
barh(x,y,0.2,'green');

See Also

bar ,   barhomogenize ,   plot ,   polyline_properties ,  

Author

Farid Belahcene