barh

Paramètres

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').

hdl

Argument de sortie dans lequel est renvoyé le handle de l'objet graphique de type Polyline créé par la fonction. Il peut être utilisé pour modifier ses propriétés (voir polyline_properties).

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.

Exemples

// 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');

Voir aussi

• bar — histogramme de barres
• barhomogenize — uniformise le style des barres dessinées dans un repère graphique
• plot — 2D plot
• polyline_properties — description of the Polyline entity properties

Historique