matplotlib.axes.Axes.hist #

Haches. hist ( x , bins = None , range = None , density = False , weights = None , cumulative = False , bottom = None , histtype = 'bar' , align = 'mid' , orientation = 'vertical' , rwidth = None , log = False , color = None, label = None , stacked = False , * , data = None , ** kwargs ) [source] #

Calculer et tracer un histogramme.

Cette méthode utilise numpy.histogrampour classer les données dans x et compter le nombre de valeurs dans chaque classe, puis dessine la distribution sous la forme a BarContainerou Polygon. Les paramètres bins , range , density et weights sont transmis à numpy.histogram.

Si les données ont déjà été regroupées et comptées, utilisez barou stairspour tracer la distribution :

counts, bins = np.histogram(x)
plt.stairs(bins, counts)

Vous pouvez également tracer des casiers et des nombres précalculés hist()en traitant chaque casier comme un seul point avec un poids égal à son nombre :

plt.hist(bins[:-1], bins, weights=counts)

L'entrée de données x peut être un tableau singulier, une liste d'ensembles de données de longueurs potentiellement différentes ([ x0 , x1 , ...]) ou un ndarray 2D dans lequel chaque colonne est un ensemble de données. Notez que la forme ndarray est transposée par rapport à la forme liste. Si l'entrée est un tableau, alors la valeur de retour est un tuple ( n , bins , patches ); si l'entrée est une séquence de tableaux, alors la valeur de retour est un tuple ([ n0 , n1 , ...], bins , [ patches0 , patches1 , ...]).

Les tableaux masqués ne sont pas pris en charge.

Paramètres :

x (n,) tableau ou suite de (n,) tableaux

Valeurs d'entrée, cela prend soit un seul tableau, soit une séquence de tableaux qui ne doivent pas nécessairement être de la même longueur.

bins int ou sequence ou str, par défaut : rcParams["hist.bins"](par défaut : 10)

Si bins est un entier, il définit le nombre de bins de largeur égale dans la plage.

Si bins est une séquence, elle définit les bords des bins, y compris le bord gauche du premier bin et le bord droit du dernier bin ; dans ce cas, les bacs peuvent être inégalement espacés. Tous les bacs sauf le dernier (le plus à droite) sont à moitié ouverts. En d'autres termes, si bins est :

[1, 2, 3, 4]

alors le premier bac est (incluant 1, mais excluant 2) et le second . Le dernier groupe, cependant, est , qui comprend 4.[1, 2)[2, 3)[3, 4]

Si bins est une chaîne, il s'agit de l'une des stratégies de regroupement prises en charge par numpy.histogram_bin_edges: 'auto', 'fd', 'doane', 'scott', 'stone', 'rice', 'sturges' ou 'sqrt'.

range tuple ou None, par défaut : None

La gamme inférieure et supérieure des bacs. Les valeurs aberrantes inférieures et supérieures sont ignorées. S'il n'est pas fourni, la plage est . Range n'a aucun effet si bins est une séquence.(x.min(), x.max())

Si bins est une séquence ou si une plage est spécifiée, la mise à l'échelle automatique est basée sur la plage de bins spécifiée au lieu de la plage de x.

densité bool, par défaut : False

Si True, dessine et renvoie une densité de probabilité : chaque groupe affichera le nombre brut du groupe divisé par le nombre total de comptes et la largeur du groupe ( ), de sorte que la zone sous l'histogramme s'intègre à 1 ( ).density = counts / (sum(counts) * np.diff(bins))np.sum(density * np.diff(bins)) == 1

Si stacked vaut également True, la somme des histogrammes est normalisée à 1.

poids (n,) de type tableau ou Aucun, par défaut : Aucun

Un tableau de poids, de la même forme que x . Chaque valeur de x ne contribue que par son poids associé au nombre de bacs (au lieu de 1). Si la densité est True, les pondérations sont normalisées, de sorte que l'intégrale de la densité sur la plage reste égale à 1.

cumulatif booléen ou -1, par défaut : False

Si True, alors un histogramme est calculé où chaque bac donne les comptes dans ce bac plus tous les bacs pour les valeurs plus petites. Le dernier bin donne le nombre total de points de données.

Si la densité est également Truealors l'histogramme est normalisé de telle sorte que le dernier bin est égal à 1.

Si cumulatif est un nombre inférieur à 0 (par exemple, -1), le sens d'accumulation est inversé. Dans ce cas, si la densité est également True, alors l'histogramme est normalisé de sorte que la première case soit égale à 1.

type tableau inférieur , scalaire ou aucun, par défaut : aucun

Emplacement du fond de chaque bac, c'est-à-dire. les bacs sont tracés de bottomà S'il s'agit d'un scalaire, le bas de chaque bac est décalé de la même valeur. S'il s'agit d'un tableau, chaque bac est décalé indépendamment et la longueur du bas doit correspondre au nombre de bacs. Si aucun, la valeur par défaut est 0.bottom + hist(x, bins)

histtype {'bar', 'barstacked', 'step', 'stepfilled'}, par défaut : 'bar'

Le type d'histogramme à dessiner.

'bar' est un histogramme traditionnel de type barre. Si plusieurs données sont fournies, les barres sont disposées côte à côte.
'barstacked' est un histogramme de type barre où plusieurs données sont empilées les unes sur les autres.
'step' génère un lineplot qui est par défaut non rempli.
'stepfilled' génère un lineplot rempli par défaut.

aligner {'gauche', 'milieu', 'droite'}, par défaut : 'milieu'

L'alignement horizontal des barres de l'histogramme.

'gauche' : les barres sont centrées sur les bords gauches du bac.
'mid' : les barres sont centrées entre les bords du bac.
'right' : les barres sont centrées sur les bords droits du bac.

orientation {'vertical', 'horizontal'}, par défaut : 'vertical'

Si 'horizontal', barhsera utilisé pour les histogrammes de type barre et le kwarg inférieur sera les bords gauches.

rwidth float ou None, par défaut : None

La largeur relative des barres en tant que fraction de la largeur de la case. Si None, calcule automatiquement la largeur.

Ignoré si histtype est 'step' ou 'stepfilled'.

log bool, par défaut : False

Si True, l'axe de l'histogramme sera défini sur une échelle logarithmique.

couleur couleur ou type de tableau de couleurs ou Aucun, par défaut : Aucun

Couleur ou séquence de couleurs, une par jeu de données. Par défaut ( None) utilise la séquence de couleurs de ligne standard.

label str ou None, par défaut : None

Chaîne ou séquence de chaînes pour faire correspondre plusieurs ensembles de données. Les graphiques à barres produisent plusieurs correctifs par jeu de données, mais seul le premier reçoit l'étiquette, ce qui legendfonctionnera comme prévu.

booléen empilé , par défaut : False

Si True, plusieurs données sont empilées les unes sur les autres Si Falseplusieurs données sont disposées côte à côte si histtype est 'bar' ou les unes sur les autres si histtype est 'step'

Retours :

n tableau ou liste de tableaux: Les valeurs des cases de l'histogramme. Voir densité et poids pour une description de la sémantique possible. Si l'entrée x est un tableau, alors c'est un tableau de longueur nbins . Si input est une séquence de tableaux , alors il s'agit d'une liste de tableaux avec les valeurs des histogrammes pour chacun des tableaux dans le même ordre. Le dtype du tableau n (ou de ses tableaux d'éléments) sera toujours flottant même si aucune pondération ou normalisation n'est utilisée.[data1, data2, ...]
tableau de bacs: Les bords des bacs. Longueur nbins + 1 (nbins bords gauche et bord droit du dernier bin). Toujours un seul tableau même lorsque plusieurs ensembles de données sont transmis.
correctifs BarContainerou liste d'un seul Polygonou liste de tels objets: Conteneur d'artistes individuels utilisé pour créer l'histogramme ou la liste de ces conteneurs s'il existe plusieurs ensembles de données d'entrée.

Autres paramètres :

objet de données indexable, facultatif

S'ils sont fournis, les paramètres suivants acceptent également une chaîne s, qui est interprétée comme data[s](sauf si cela déclenche une exception) :

x , poids

**kwargs

PatchPropriétés

Voir également

hist2d: Histogramme 2D avec cases rectangulaires
hexbin: Histogramme 2D avec bacs hexagonaux

Remarques

Pour un grand nombre de bacs (> 1000), le traçage peut être beaucoup plus rapide si histtype est défini sur 'step' ou 'stepfilled' plutôt que sur 'bar' ou 'barstacked'.