bar

Paramètres

h

un pointeur sur les axes, (par défaut: h=gca() ).

y

scalaire, vecteur de taille N, ou matrice (N_lignes * M_colonnes) de nombres réels ou d'entiers encodés, avec

• N : nombre de groupes de barres. Chaque groupe est rassemblé à (proximité de) la position x dédiée.
• M : nombre de catégories = nombre de barres dans chaque groupe.

x

scalaire, ou vecteur de taille N. Par défaut,

• Si y est un vecteur : x=1:length(y)
• Si y est une matrice : x=1:size(y,"r")

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%.

colors

(option) String unique (commune), ou vecteur de M strings : noms des couleurs des M catégories (choisis dans la liste Scilab des noms prédéfinis), ou codes hexadécimaux de celles-ci (du type "#RRGGBB"). Par défaut, la série de couleurs utilisées par défaut par plot() est utilisée, commençant par "blue".

style

(option) 'grouped' (par défaut), ou 'stacked'.

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

bar(y,...) : si y est un vecteur, alors bar() dessine une polyline unique de type polyline_style=6, avec x=1:length(y). Si y est une matrice de taille N*M, alors bar() dessine M polylines de (type 6), avec x=1:size(y,1) ; chaque polyline correspond alors à une colonne de y, et à une catégorie, avec sa propre couleur .

bar(x,y,...) : comme bar(y,...) :, mais en indiquant explicitement les N positions x des groupes.

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

bar(...,width,...) : definit la largeur relative des barres : 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(...,colors,...) : definit les couleurs des catégories de barres. Toutes les barres d'une même catégorie sont remplies avec la même couleur.

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 colors='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;colors='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

• barh — histogramme horizontal de barres
• barhomogenize — uniformise le style des barres dessinées dans un repère graphique
• histplot — dessine un histogramme
• plot — 2D plot
• couleurs prédéfinies — liste des noms de couleurs prédéfinies
• polyline_properties — description of the Polyline entity properties
• bar3d — Graphique en barres 3D

Historique