Fonction Scilab
Last update : 30/11/2005

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 juste une barre, width=0.5, color='yellow', par défaut x=1:length(y)
    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