# hist

Tracé d'histogramme.

## 📝 Syntaxe

* hist(x)
* hist(x, nbins)
* hist(ax, ...)
* counts = hist(...)
* \[counts, centers] = hist(...)

## 📥 Argument d'entrée

* x - vecteur ou matrice
* nbins - vecteur.
* ax - Objet axes.

## 📤 Argument de sortie

* counts - Nombre d'éléments dans chaque intervalle : vecteur ligne.
* centers - Centres des intervalles : vecteur.

## 📄 Description

Un histogramme est une représentation graphique qui illustre la distribution des valeurs d'un ensemble de données.

Lorsque vous utilisez la fonction hist, elle organise les éléments du vecteur Y en 10 intervalles également espacés et fournit le nombre d'éléments dans chaque intervalle sous forme de vecteur ligne.

hist(Y, x) avec un vecteur x, la fonction retourne la distribution des valeurs de Y parmi des intervalles déterminés par la longueur de x, avec des centres spécifiés par les valeurs de x.

Par exemple, si x est un vecteur de 5 éléments, hist classera les éléments de Y dans cinq intervalles, chacun centré sur l'axe des x aux valeurs spécifiées dans x.

Lorsque vous utilisez hist(...) sans spécifier d'argument de sortie, cela génère un tracé d'histogramme. Les intervalles sont répartis le long de l'axe des x entre les valeurs minimale et maximale trouvées dans le vecteur d'entrée Y.

## 💡 Exemple

```matlab
f = figure();
for i = 1:4
  subplot(2, 2, i)
  hist(randn(1000, 1), 50)
end

```

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

## 🔗 Voir aussi

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

## 🕔 Historique

| Version | 📄 Description   |
| ------- | ---------------- |
| 1.0.0   | version initiale |
