barh

Fonction Scilab
Last update : 30/11/2005

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