<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="X-UA-Compatible" content="IE=Edge" />

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />

<title>hist(x) &#8212; Matplotlib 3.5.3 documentation</title>

<!-- Loaded before other Sphinx assets -->

<link href="../../_static/styles/theme.css?digest=1999514e3f237ded88cf" rel="stylesheet">

<link href="../../_static/styles/pydata-sphinx-theme.css?digest=1999514e3f237ded88cf" rel="stylesheet">

<link rel="stylesheet"

href="../../_static/vendor/fontawesome/5.13.0/css/all.min.css">

<link rel="preload" as="font" type="font/woff2" crossorigin

href="../../_static/vendor/fontawesome/5.13.0/webfonts/fa-solid-900.woff2">

<link rel="preload" as="font" type="font/woff2" crossorigin

href="../../_static/vendor/fontawesome/5.13.0/webfonts/fa-brands-400.woff2">

<link rel="stylesheet" type="text/css" href="../../_static/pygments.css" />

<link rel="stylesheet" type="text/css" href="../../_static/css/style.css" />

<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />

<link rel="stylesheet" type="text/css" href="../../_static/plot_directive.css" />

<link rel="stylesheet" type="text/css" href="../../_static/copybutton.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-binder.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-dataframe.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-rendered-html.css" />

<link rel="stylesheet" type="text/css" href="../../_static/panels-main.c949a650a448cc0ae9fd3441c0e17fb0.css" />

<link rel="stylesheet" type="text/css" href="../../_static/panels-variables.06eb56fa6e07937060861dad626602ad.css" />

<link rel="stylesheet" type="text/css" href="../../_static/mpl.css?v3.5.3-2-gade8736b7a" />

<!-- Pre-loaded scripts that we'll load fully later -->

<link rel="preload" as="script" href="../../_static/scripts/pydata-sphinx-theme.js?digest=1999514e3f237ded88cf">

<script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>

<script src="../../_static/jquery.js"></script>

<script src="../../_static/underscore.js"></script>

<script src="../../_static/doctools.js"></script>

<script src="../../_static/clipboard.min.js"></script>

<script src="../../_static/copybutton.js"></script>

<link rel="canonical" href="https://matplotlib.org/stable/plot_types/stats/hist_plot.html" />

<link rel="search" type="application/opensearchdescription+xml"

title="Search within Matplotlib 3.5.3 documentation"

href="../../_static/opensearch.xml"/>

<link rel="shortcut icon" href="../../_static/favicon.ico"/>

<link rel="search" title="Search" href="../../search.html" />

<link rel="next" title="boxplot(X)" href="boxplot_plot.html" />

<link rel="prev" title="Statistics plots" href="index.html" />

<meta name="viewport" content="width=device-width, initial-scale=1" />

<meta name="docsearch:language" content="None">

<script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js"></script>

</head>

<body data-spy="scroll" data-target="#bd-toc-nav" data-offset="60">

<div class="container-fluid" id="banner"></div>

<nav class="navbar navbar-light navbar-expand-lg bg-light fixed-top bd-navbar" id="navbar-main"><div class="container-xl">

<div id="navbar-start">

<a class="navbar-brand" href="../../index.html">

<img src="../../_static/logo2.svg" class="logo" alt="logo">

</a>

</div>

<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbar-collapsible" aria-controls="navbar-collapsible" aria-expanded="false" aria-label="Toggle navigation">

<span class="navbar-toggler-icon"></span>

</button>

<div id="navbar-collapsible" class="col-lg-9 collapse navbar-collapse">

<div id="navbar-center" class="mr-auto">

<div class="navbar-center-item">

<ul id="navbar-main-elements" class="navbar-nav">

<li class="nav-item">

<a class="reference internal nav-link" href="../index.html">Plot types</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../gallery/index.html">Examples</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../tutorials/index.html">Tutorials</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../api/index.html">Reference</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../users/index.html">User guide</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../devel/index.html">Develop</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../users/release_notes.html">Release notes</a>

</li>

</div>

</div>

<div id="navbar-end">

<div class="navbar-end-item">

<ul id="navbar-icon-links" class="navbar-nav" aria-label="Icon Links">

<li class="nav-item">

<a class="nav-link" href="https://gitter.im/matplotlib/matplotlib" rel="noopener" target="_blank" title="gitter">

<span><i class="fab fa-gitter"></i></span>

<label class="sr-only">gitter</label>

</a>

</li>

<li class="nav-item">

<a class="nav-link" href="https://discourse.matplotlib.org" rel="noopener" target="_blank" title="discourse">

<span><i class="fab fa-discourse"></i></span>

<label class="sr-only">discourse</label>

</a>

</li>

<li class="nav-item">

<a class="nav-link" href="https://github.com/matplotlib/matplotlib" rel="noopener" target="_blank" title="GitHub">

<span><i class="fab fa-github-square"></i></span>

<label class="sr-only">GitHub</label>

</a>

</li>

<li class="nav-item">

<a class="nav-link" href="https://twitter.com/matplotlib/" rel="noopener" target="_blank" title="twitter">

<span><i class="fab fa-twitter-square"></i></span>

<label class="sr-only">twitter</label>

</a>

</li>

</ul>

</div>

</div>

</div>

</nav>

<div class="container-xl">

<div class="row">

<!-- Only show if we have sidebars configured, else just a small margin -->

<div class="col-12 col-md-3 bd-sidebar">

<div class="sidebar-start-items"><form class="bd-search d-flex align-items-center" action="../../search.html" method="get">

<i class="icon fas fa-search"></i>

<input type="search" class="form-control" name="q" id="search-input" placeholder="Search the docs ..." aria-label="Search the docs ..." autocomplete="off" >

</form><nav class="bd-links" id="bd-docs-nav" aria-label="Main navigation">

<div class="bd-toc-item active">

<ul class="current nav bd-sidenav">

<li class="toctree-l1 has-children">

<a class="reference internal" href="../basic/index.html">

Basic

</a>

<input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" type="checkbox"/>

<label for="toctree-checkbox-1">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="../basic/plot.html">

plot(x, y)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../basic/scatter_plot.html">

scatter(x, y)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../basic/bar.html">

bar(x, height) / barh(y, width)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../basic/stem.html">

stem(x, y)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../basic/step.html">

step(x, y)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../basic/fill_between.html">

fill_between(x, y1, y2)

</a>

</li>

</ul>

</li>

<li class="toctree-l1 has-children">

<a class="reference internal" href="../arrays/index.html">

Plots of arrays and fields

</a>

<input class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" type="checkbox"/>

<label for="toctree-checkbox-2">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="../arrays/imshow.html">

imshow(Z)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../arrays/pcolormesh.html">

pcolormesh(X, Y, Z)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../arrays/contour.html">

contour(X, Y, Z)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../arrays/contourf.html">

contourf(X, Y, Z)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../arrays/barbs.html">

barbs(X, Y, U, V)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../arrays/quiver.html">

quiver(X, Y, U, V)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../arrays/streamplot.html">

streamplot(X, Y, U, V)

</a>

</li>

</ul>

</li>

<li class="toctree-l1 current active has-children">

<a class="reference internal" href="index.html">

Statistics plots

</a>

<input checked="" class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" type="checkbox"/>

<label for="toctree-checkbox-3">

<i class="fas fa-chevron-down">

</i>

</label>

<ul class="current">

<li class="toctree-l2 current active">

<a class="current reference internal" href="#">

hist(x)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="boxplot_plot.html">

boxplot(X)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="errorbar_plot.html">

errorbar(x, y, yerr, xerr)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="violin.html">

violinplot(D)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="eventplot.html">

eventplot(D)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="hist2d.html">

hist2d(x, y)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="hexbin.html">

hexbin(x, y, C)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="pie.html">

pie(x)

</a>

</li>

</ul>

</li>

<li class="toctree-l1 has-children">

<a class="reference internal" href="../unstructured/index.html">

Unstructured coordinates

</a>

<input class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" type="checkbox"/>

<label for="toctree-checkbox-4">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="../unstructured/tricontour.html">

tricontour(x, y, z)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../unstructured/tricontourf.html">

tricontourf(x, y, z)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../unstructured/tripcolor.html">

tripcolor(x, y, z)

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../unstructured/triplot.html">

triplot(x, y)

</a>

</li>

</ul>

</li>

</div>

</div>

<div class="sidebar-end-items">

</div>

</div>

<div class="d-none d-xl-block col-xl-2 bd-toc">

<div class="toc-item">

<nav id="bd-toc-nav">

</div>

<div class="toc-item">

</div>

</div>

<main class="col-12 col-md-9 col-xl-7 py-md-5 pl-md-5 pr-md-4 bd-content" role="main">

<div>

<div class="sphx-glr-download-link-note admonition note">

<p class="admonition-title">Note</p>

<p>Click <a class="reference internal" href="#sphx-glr-download-plot-types-stats-hist-plot-py"><span class="std std-ref">here</span></a>

to download the full example code</p>

<section class="sphx-glr-example-title" id="hist-x">

<span id="sphx-glr-plot-types-stats-hist-plot-py"></span><h1>hist(x)<a class="headerlink" href="#hist-x" title="Permalink to this headline">#</a></h1>

<p>See <a class="reference internal" href="../../api/_as_gen/matplotlib.axes.Axes.hist.html#matplotlib.axes.Axes.hist" title="matplotlib.axes.Axes.hist"><code class="xref py py-obj docutils literal notranslate"><span class="pre">hist</span></code></a>.</p>

<img src="../../_images/sphx_glr_hist_plot_001.png" srcset="../../_images/sphx_glr_hist_plot_001.png, ../../_images/sphx_glr_hist_plot_001_2_0x.png 2.0x" alt="hist plot" class = "sphx-glr-single-img"/><div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>

<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>

<span class="n">plt</span><span class="o">.</span><span class="n">style</span><span class="o">.</span><span class="n">use</span><span class="p">(</span><span class="s1">&#39;_mpl-gallery&#39;</span><span class="p">)</span>

<span class="c1"># make data</span>

<a href="https://numpy.org/doc/stable/reference/random/generated/numpy.random.seed.html#numpy.random.seed" title="numpy.random.seed" class="sphx-glr-backref-module-numpy-random sphx-glr-backref-type-py-function"><span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span></a><span class="p">(</span><span class="mi">1</span><span class="p">)</span>

<a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">x</span></a> <span class="o">=</span> <span class="mi">4</span> <span class="o">+</span> <a href="https://numpy.org/doc/stable/reference/random/generated/numpy.random.normal.html#numpy.random.normal" title="numpy.random.normal" class="sphx-glr-backref-module-numpy-random sphx-glr-backref-type-py-function"><span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">normal</span></a><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mf">1.5</span><span class="p">,</span> <span class="mi">200</span><span class="p">)</span>

<span class="c1"># plot:</span>

<a href="../../api/figure_api.html#matplotlib.figure.Figure" title="matplotlib.figure.Figure" class="sphx-glr-backref-module-matplotlib-figure sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">fig</span></a><span class="p">,</span> <span class="n">ax</span> <span class="o">=</span> <a href="../../api/_as_gen/matplotlib.pyplot.subplots.html#matplotlib.pyplot.subplots" title="matplotlib.pyplot.subplots" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function"><span class="n">plt</span><span class="o">.</span><span class="n">subplots</span></a><span class="p">()</span>

<a href="../../api/_as_gen/matplotlib.axes.Axes.hist.html#matplotlib.axes.Axes.hist" title="matplotlib.axes.Axes.hist" class="sphx-glr-backref-module-matplotlib-axes sphx-glr-backref-type-py-method"><span class="n">ax</span><span class="o">.</span><span class="n">hist</span></a><span class="p">(</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="numpy.ndarray" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-class sphx-glr-backref-instance"><span class="n">x</span></a><span class="p">,</span> <span class="n">bins</span><span class="o">=</span><span class="mi">8</span><span class="p">,</span> <span class="n">linewidth</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span> <span class="n">edgecolor</span><span class="o">=</span><span class="s2">&quot;white&quot;</span><span class="p">)</span>

<a href="../../api/_as_gen/matplotlib.axes.Axes.set.html#matplotlib.axes.Axes.set" title="matplotlib.axes.Axes.set" class="sphx-glr-backref-module-matplotlib-axes sphx-glr-backref-type-py-method"><span class="n">ax</span><span class="o">.</span><span class="n">set</span></a><span class="p">(</span><span class="n">xlim</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">8</span><span class="p">),</span> <span class="n">xticks</span><span class="o">=</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.arange.html#numpy.arange" title="numpy.arange" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-function"><span class="n">np</span><span class="o">.</span><span class="n">arange</span></a><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">8</span><span class="p">),</span>

<span class="n">ylim</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">56</span><span class="p">),</span> <span class="n">yticks</span><span class="o">=</span><a href="https://numpy.org/doc/stable/reference/generated/numpy.linspace.html#numpy.linspace" title="numpy.linspace" class="sphx-glr-backref-module-numpy sphx-glr-backref-type-py-function"><span class="n">np</span><span class="o">.</span><span class="n">linspace</span></a><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">56</span><span class="p">,</span> <span class="mi">9</span><span class="p">))</span>

<a href="../../api/_as_gen/matplotlib.pyplot.show.html#matplotlib.pyplot.show" title="matplotlib.pyplot.show" class="sphx-glr-backref-module-matplotlib-pyplot sphx-glr-backref-type-py-function"><span class="n">plt</span><span class="o">.</span><span class="n">show</span></a><span class="p">()</span>

<div class="sphx-glr-footer sphx-glr-footer-example docutils container" id="sphx-glr-download-plot-types-stats-hist-plot-py">

<div class="sphx-glr-download sphx-glr-download-python docutils container">

<p><a class="reference download internal" download="" href="../../_downloads/4b0bfc86a1ba58f96b40478cc4e5bb49/hist_plot.py"><code class="xref download docutils literal notranslate"><span class="pre">Download</span> <span class="pre">Python</span> <span class="pre">source</span> <span class="pre">code:</span> <span class="pre">hist_plot.py</span></code></a></p>

<div class="sphx-glr-download sphx-glr-download-jupyter docutils container">

<p><a class="reference download internal" download="" href="../../_downloads/721e3406f8136c90efcd9d5508b8fcbb/hist_plot.ipynb"><code class="xref download docutils literal notranslate"><span class="pre">Download</span> <span class="pre">Jupyter</span> <span class="pre">notebook:</span> <span class="pre">hist_plot.ipynb</span></code></a></p>

<p class="sphx-glr-signature">Keywords: matplotlib code example, codex, python plot, pyplot

<a class="reference external" href="https://sphinx-gallery.readthedocs.io">Gallery generated by Sphinx-Gallery</a></p>

</div>

</main>

</div>

</div>

<!-- Scripts loaded after <body> so the DOM is not blocked -->

<div id="unreleased-message"> You are reading an old version of the documentation (v3.5.3). For the latest version see <a href="https://matplotlib.org/stable/plot_types/stats/hist_plot.html">https://matplotlib.org/stable/plot_types/stats/hist_plot.html</a></div>

<script src="../../_static/scripts/pydata-sphinx-theme.js?digest=1999514e3f237ded88cf"></script>

<footer class="footer mt-5 mt-md-0">

<div class="container">

<div class="footer-item">

<p class="copyright">

&copy; Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012 - 2022 The Matplotlib development team.<br>

</div>

<div class="footer-item">

<p class="sphinx-version">

Created using <a href="http://sphinx-doc.org/">Sphinx</a> 4.5.0.<br>

</div>

</div>

</body>