# bar

Diagramme en barres.

## 📝 Syntaxe

* bar(Y)
* bar(X, Y)
* bar(..., width)
* bar(..., color)
* bar(..., propertyName, propertyValue)
* bar(ax, ...)
* b = bar(...)

## 📥 Argument d'entrée

* X - abscisses : scalaire, vecteur ou tableau de chaînes.
* Y - ordonnées : vecteur.
* width - scalaire, 0.8 (par défaut).
* color - une chaîne scalaire ou un vecteur ligne de caractères : nom de couleur ou nom court de couleur.
* propertyName - une chaîne scalaire ou un vecteur ligne de caractères.
* propertyValue - une valeur.
* ax - Objet axes.

## 📤 Argument de sortie

* b - objet graphique patch.

## 📄 Description

bar(X, Y) crée un diagramme en barres à partir de deux ensembles de vecteurs X-Y.

Lorsqu'un seul argument est fourni (Y), il est interprété comme un vecteur de valeurs Y, et les abscisses X sont générées comme une séquence de 1 au nombre d'éléments du vecteur Y.

Vous pouvez éventuellement spécifier la largeur des barres.

Une valeur de 1.0 fera que chaque barre touche exactement ses voisines, tandis que la largeur par défaut est fixée à 0.8.

## 💡 Exemples

```matlab
f = figure();
y = [ 91 75 123.5 105 150 131 203 179 249 226 281.5];
bar(y);

```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-b54aed63dff1cf4bd538cd814573428650349e32%2Fbar_1.svg?alt=media)

```matlab
f = figure();
y = [ 91 75 123.5 105 150 131 203 179 249 226 281.5];
bar(y, 0.5);

```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-78ff4d291b25a61b764cf102c171e1a38d1b11a1%2Fbar_2.svg?alt=media)

```matlab
f = figure();
x = 1900:10:2000;
y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(x, y, 'r');

```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-0c3a2763a4e96473a5a793cc321c3a2365b49d5e%2Fbar_3.svg?alt=media)

```matlab
f = figure();
x = [ "Summer", "Spring", "Winter", "Autumn"];
y = [ 2 1 4 3];
bar(x, y);

```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-329d8a17a2d200f99db1b2816f0f01052e9a7f6d%2Fbar_4.svg?alt=media)

```matlab
f = figure();
y = [91 75 123.5 105 150 131 203 179 249 226 281.5];
bar(y, 'FaceColor', [0 .5 .5], 'EdgeColor', [0 .9 .9], 'LineWidth', 1.5)

```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-fa0ec543871e6b51962c8c1f9f6cb9340741a73d%2Fbar_5.svg?alt=media)

## 🔗 Voir aussi

[hist](https://nelson-9.gitbook.io/nelson/markdown/fr/graphics/hist), [patch](https://nelson-9.gitbook.io/nelson/markdown/fr/graphics/patch).

## 🕔 Historique

| Version | 📄 Description                                        |
| ------- | ----------------------------------------------------- |
| 1.0.0   | version initiale                                      |
| 1.12.0  | Gestion du nom de couleur ou du nom court de couleur. |
