Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function
bar
histogramme de barres
Séquence d'appel
bar(y) bar(x,y) bar([h],x,y [,width [,color [,style]]])
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: 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.
Exemples
// 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');
Voir Aussi
Auteurs
Farid Belahcene
<< bar_histogram | bar_histogram | barh >> |