<divid="unreleased-message"> You are reading an old version of the documentation (v3.2.0). For the latest version see <ahref="/stable/">https://matplotlib.org/stable/</a></div>
<pclass="last">Click <aclass="reference internal" href="#sphx-glr-download-gallery-frontpage-3d-py"><spanclass="std std-ref">here</span></a> to download the full example code</p>
<spanid="sphx-glr-gallery-frontpage-3d-py"></span><h1>Frontpage 3D example<aclass="headerlink" href="#frontpage-3d-example" title="Permalink to this headline">¶</a></h1>
<p>This example reproduces the frontpage 3D example.</p>
<spanclass="kn">from</span><spanclass="nn">matplotlib.colors</span><spanclass="kn">import</span><ahref="../../api/_as_gen/matplotlib.colors.LightSource.html#matplotlib.colors.LightSource" title="View documentation for matplotlib.colors.LightSource"><spanclass="n">LightSource</span></a>
<spanclass="k">with</span><ahref="../../api/cbook_api.html#matplotlib.cbook.get_sample_data" title="View documentation for matplotlib.cbook.get_sample_data"><spanclass="n">cbook</span><spanclass="o">.</span><spanclass="n">get_sample_data</span></a><spanclass="p">(</span><spanclass="s1">'jacksboro_fault_dem.npz'</span><spanclass="p">)</span><spanclass="k">as</span><spanclass="n">file</span><spanclass="p">,</span> \
<ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.load.html#numpy.load" title="View documentation for numpy.load"><spanclass="n">np</span><spanclass="o">.</span><spanclass="n">load</span></a><spanclass="p">(</span><spanclass="n">file</span><spanclass="p">)</span><spanclass="k">as</span><spanclass="n">dem</span><spanclass="p">:</span>
<ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">z</span></a><spanclass="o">=</span><spanclass="n">dem</span><spanclass="p">[</span><spanclass="s1">'elevation'</span><spanclass="p">]</span>
<ahref="https://docs.python.org/3/library/functions.html#int" title="View documentation for builtins.int"><spanclass="n">nrows</span></a><spanclass="p">,</span><ahref="https://docs.python.org/3/library/functions.html#int" title="View documentation for builtins.int"><spanclass="n">ncols</span></a><spanclass="o">=</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.shape.html#numpy.ndarray.shape" title="View documentation for numpy.ndarray.shape"><spanclass="n">z</span><spanclass="o">.</span><spanclass="n">shape</span></a>
<ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">x</span></a><spanclass="o">=</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.linspace.html#numpy.linspace" title="View documentation for numpy.linspace"><spanclass="n">np</span><spanclass="o">.</span><spanclass="n">linspace</span></a><spanclass="p">(</span><spanclass="n">dem</span><spanclass="p">[</span><spanclass="s1">'xmin'</span><spanclass="p">],</span><spanclass="n">dem</span><spanclass="p">[</span><spanclass="s1">'xmax'</span><spanclass="p">],</span><ahref="https://docs.python.org/3/library/functions.html#int" title="View documentation for builtins.int"><spanclass="n">ncols</span></a><spanclass="p">)</span>
<ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">y</span></a><spanclass="o">=</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.linspace.html#numpy.linspace" title="View documentation for numpy.linspace"><spanclass="n">np</span><spanclass="o">.</span><spanclass="n">linspace</span></a><spanclass="p">(</span><spanclass="n">dem</span><spanclass="p">[</span><spanclass="s1">'ymin'</span><spanclass="p">],</span><spanclass="n">dem</span><spanclass="p">[</span><spanclass="s1">'ymax'</span><spanclass="p">],</span><ahref="https://docs.python.org/3/library/functions.html#int" title="View documentation for builtins.int"><spanclass="n">nrows</span></a><spanclass="p">)</span>
<ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">x</span></a><spanclass="p">,</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">y</span></a><spanclass="o">=</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.meshgrid.html#numpy.meshgrid" title="View documentation for numpy.meshgrid"><spanclass="n">np</span><spanclass="o">.</span><spanclass="n">meshgrid</span></a><spanclass="p">(</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">x</span></a><spanclass="p">,</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">y</span></a><spanclass="p">)</span>
<ahref="https://docs.python.org/3/library/stdtypes.html#tuple" title="View documentation for builtins.tuple"><spanclass="n">region</span></a><spanclass="o">=</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.s_.html#numpy.s_" title="View documentation for numpy.s_"><spanclass="n">np</span><spanclass="o">.</span><spanclass="n">s_</span></a><spanclass="p">[</span><spanclass="mi">5</span><spanclass="p">:</span><spanclass="mi">50</span><spanclass="p">,</span><spanclass="mi">5</span><spanclass="p">:</span><spanclass="mi">50</span><spanclass="p">]</span>
<ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">x</span></a><spanclass="p">,</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">y</span></a><spanclass="p">,</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">z</span></a><spanclass="o">=</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">x</span></a><spanclass="p">[</span><ahref="https://docs.python.org/3/library/stdtypes.html#tuple" title="View documentation for builtins.tuple"><spanclass="n">region</span></a><spanclass="p">],</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">y</span></a><spanclass="p">[</span><ahref="https://docs.python.org/3/library/stdtypes.html#tuple" title="View documentation for builtins.tuple"><spanclass="n">region</span></a><spanclass="p">],</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">z</span></a><spanclass="p">[</span><ahref="https://docs.python.org/3/library/stdtypes.html#tuple" title="View documentation for builtins.tuple"><spanclass="n">region</span></a><spanclass="p">]</span>
<ahref="../../api/_as_gen/matplotlib.figure.Figure.html#matplotlib.figure.Figure" title="View documentation for matplotlib.figure.Figure"><spanclass="n">fig</span></a><spanclass="p">,</span><ahref="../../api/_as_gen/matplotlib.axes.SubplotBase.html#matplotlib.axes.SubplotBase" title="View documentation for matplotlib.axes.SubplotBase"><spanclass="n">ax</span></a><spanclass="o">=</span><ahref="../../api/_as_gen/matplotlib.pyplot.subplots.html#matplotlib.pyplot.subplots" title="View documentation for matplotlib.pyplot.subplots"><spanclass="n">plt</span><spanclass="o">.</span><spanclass="n">subplots</span></a><spanclass="p">(</span><spanclass="n">subplot_kw</span><spanclass="o">=</span><spanclass="nb">dict</span><spanclass="p">(</span><spanclass="n">projection</span><spanclass="o">=</span><spanclass="s1">'3d'</span><spanclass="p">))</span>
<ahref="../../api/_as_gen/matplotlib.colors.LightSource.html#matplotlib.colors.LightSource" title="View documentation for matplotlib.colors.LightSource"><spanclass="n">ls</span></a><spanclass="o">=</span><ahref="../../api/_as_gen/matplotlib.colors.LightSource.html#matplotlib.colors.LightSource" title="View documentation for matplotlib.colors.LightSource"><spanclass="n">LightSource</span></a><spanclass="p">(</span><spanclass="mi">270</span><spanclass="p">,</span><spanclass="mi">45</span><spanclass="p">)</span>
<spanclass="c1"># To use a custom hillshading mode, override the built-in shading and pass</span>
<spanclass="c1"># in the rgb colors of the shaded surface calculated from "shade".</span>
<ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">rgb</span></a><spanclass="o">=</span><ahref="../../api/_as_gen/matplotlib.colors.LightSource.html#matplotlib.colors.LightSource" title="View documentation for matplotlib.colors.LightSource"><spanclass="n">ls</span></a><spanclass="o">.</span><spanclass="n">shade</span><spanclass="p">(</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">z</span></a><spanclass="p">,</span><spanclass="n">cmap</span><spanclass="o">=</span><spanclass="n">cm</span><spanclass="o">.</span><spanclass="n">gist_earth</span><spanclass="p">,</span><spanclass="n">vert_exag</span><spanclass="o">=</span><spanclass="mf">0.1</span><spanclass="p">,</span><spanclass="n">blend_mode</span><spanclass="o">=</span><spanclass="s1">'soft'</span><spanclass="p">)</span>
<spanclass="n">surf</span><spanclass="o">=</span><ahref="../../api/_as_gen/matplotlib.axes.SubplotBase.html#matplotlib.axes.SubplotBase" title="View documentation for matplotlib.axes.SubplotBase"><spanclass="n">ax</span></a><spanclass="o">.</span><spanclass="n">plot_surface</span><spanclass="p">(</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">x</span></a><spanclass="p">,</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">y</span></a><spanclass="p">,</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">z</span></a><spanclass="p">,</span><spanclass="n">rstride</span><spanclass="o">=</span><spanclass="mi">1</span><spanclass="p">,</span><spanclass="n">cstride</span><spanclass="o">=</span><spanclass="mi">1</span><spanclass="p">,</span><spanclass="n">facecolors</span><spanclass="o">=</span><ahref="https://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.html#numpy.ndarray" title="View documentation for numpy.ndarray"><spanclass="n">rgb</span></a><spanclass="p">,</span>
<ahref="../../api/_as_gen/matplotlib.axes.SubplotBase.html#matplotlib.axes.SubplotBase" title="View documentation for matplotlib.axes.SubplotBase"><spanclass="n">ax</span></a><spanclass="o">.</span><spanclass="n">set_xticks</span><spanclass="p">([])</span>
<ahref="../../api/_as_gen/matplotlib.axes.SubplotBase.html#matplotlib.axes.SubplotBase" title="View documentation for matplotlib.axes.SubplotBase"><spanclass="n">ax</span></a><spanclass="o">.</span><spanclass="n">set_yticks</span><spanclass="p">([])</span>
<ahref="../../api/_as_gen/matplotlib.axes.SubplotBase.html#matplotlib.axes.SubplotBase" title="View documentation for matplotlib.axes.SubplotBase"><spanclass="n">ax</span></a><spanclass="o">.</span><spanclass="n">set_zticks</span><spanclass="p">([])</span>
<ahref="../../api/_as_gen/matplotlib.figure.Figure.html#matplotlib.figure.Figure" title="View documentation for matplotlib.figure.Figure"><spanclass="n">fig</span></a><spanclass="o">.</span><spanclass="n">savefig</span><spanclass="p">(</span><spanclass="s2">"surface3d_frontpage.png"</span><spanclass="p">,</span><spanclass="n">dpi</span><spanclass="o">=</span><spanclass="mi">25</span><spanclass="p">)</span><spanclass="c1"># results in 160x120 px image</span>
</pre></div>
</div>
<divclass="sphx-glr-footer class sphx-glr-footer-example docutils container" id="sphx-glr-download-gallery-frontpage-3d-py">