.. _matplot_examples:

Matplotlib Examples
=========================================================================================

The following examples are based on examples in the
`3D plotting Gallery <https://matplotlib.org/stable/gallery/index.html#d-plotting>`_
of Matplotlib. This set of examples compare the methodology of forming
3D visulizations between Matplotlib and S3Dlib.

**Matplotlib**. Initially, x,y,z coordinates are constructed.  The coordinates are
then passed to specific Axes3D methods, eg. plot, plot_wireframe, plot_surface, plot_trisurf, 
contour, etc.

**S3Dlib**. First, base 3D objects are instantiated ( surface, line, or vectors ) to
established the network relationship among the vertex coordinates.  Functions are then
used to map coordinates and colors to produce the final object.  Mutliple mapping operations
may be performed on the same object and objects. Additionally, objects of the same class may be
added together to form one object. Finally, objects are added to the Axes3D.




.. toctree::
   :hidden:

   matplot_ex/demo3D.rst

.. raw:: html

    <a href="matplot_ex/demo3D.html">
    <div class="docbutton">
    <span class="tooltiptext">A very basic plot of a 3D surface using a solid color.</span>

.. only:: html

.. image:: matplot_ex/images/demo3D.png
   :class: docfig

3D Surface

.. raw:: html

    </div></a>









.. toctree::
   :hidden:

   matplot_ex/cyl_coor.rst

.. raw:: html

    <a href="matplot_ex/cyl_coor.html">
    <div class="docbutton">
    <span class="tooltiptext">Polar surface in native polar coordinates.</span>

.. only:: html

.. image:: matplot_ex/images/cyl_coor.png
   :class: docfig

3D Surface in Polar Coordinates

.. raw:: html

    </div></a>












.. toctree::
   :hidden:

   matplot_ex/wave.rst

.. raw:: html

    <a href="matplot_ex/wave.html">
    <div class="docbutton">
    <span class="tooltiptext"> Solid color surface with shading for topological perception.</span>

.. only:: html

.. image:: matplot_ex/images/wave.png
   :class: docfig

Shading

.. raw:: html

    </div></a>








.. toctree::
   :hidden:

   matplot_ex/mp_box.rst

.. raw:: html

    <a href="matplot_ex/mp_box.html">
    <div class="docbutton">
    <span class="tooltiptext"> Functional mapping color for on a cubic surface.</span>

.. only:: html

.. image:: matplot_ex/images/mp_box.png
   :class: docfig

3D Box Surface Plot

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   matplot_ex/pringle.rst

.. raw:: html

    <a href="matplot_ex/pringle.html">
    <div class="docbutton">
    <span class="tooltiptext"> Color mapping applied to surface normals for topological perception.</span>

.. only:: html

.. image:: matplot_ex/images/pringle.png
   :class: docfig

Color Mapping Normals

.. raw:: html

    </div></a>







.. toctree::
   :hidden:

   matplot_ex/twistribbon.rst

.. raw:: html

    <a href="matplot_ex/twistribbon.html">
    <div class="docbutton">
    <span class="tooltiptext"> Matplotlib example using cylindrical coordinates.</span>

.. only:: html

.. image:: matplot_ex/images/twistribbon.png
   :class: docfig

Cylindrical Coordinates

.. raw:: html

    </div></a>




.. toctree::
   :hidden:

   matplot_ex/cyl_contours.rst

.. raw:: html

    <a href="matplot_ex/cyl_contours.html">
    <div class="docbutton">
    <span class="tooltiptext">Contours constructed from a cylindrical surface.</span>

.. only:: html

.. image:: matplot_ex/images/cyl_contours.png
   :class: docfig

Cylindrical Surface Contours

.. raw:: html

    </div></a>





.. toctree::
   :hidden:

   matplot_ex/mp_triplot.rst

.. raw:: html

    <a href="matplot_ex/mp_triplot.html">
    <div class="docbutton">
    <span class="tooltiptext">3D comparison to the 2D Matplotlib example.</span>

.. only:: html

.. image:: matplot_ex/images/mp_triplot.png
   :class: docfig

Unstructured coordinates

.. raw:: html

    </div></a>





.. toctree::
   :hidden:

   matplot_ex/mp_triplot_sm.rst

.. raw:: html

    <a href="matplot_ex/mp_triplot_sm.html">
    <div class="docbutton">
    <span class="tooltiptext">Smoothed 3D surfface compared to the 2D Matplotlib example.</span>

.. only:: html

.. image:: matplot_ex/images/mp_triplot_sm.png
   :class: docfig

Unstructured coordinates, Smoothed Surface

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   matplot_ex/unstructured_sph.rst

.. raw:: html

    <a href="matplot_ex/unstructured_sph.html">
    <div class="docbutton">
    <span class="tooltiptext">3D comparison to the 2D Matplotlib example in alternative coordinates.</span>

.. only:: html

.. image:: matplot_ex/images/unstructured_sph.png
   :class: docfig

Unstructured Spherical and Cylindrical Coordinates

.. raw:: html

    </div></a>







.. toctree::
   :hidden:

   matplot_ex/mp_contours.rst

.. raw:: html

    <a href="matplot_ex/mp_contours.html">
    <div class="docbutton">
    <span class="tooltiptext">3D comparison to the 2D Matplotlib contours example.</span>

.. only:: html

.. image:: matplot_ex/images/mp_contours.png
   :class: docfig

Contours

.. raw:: html

    </div></a>








.. toctree::
   :hidden:

   matplot_ex/contours_3d_sph.rst

.. raw:: html

    <a href="matplot_ex/contours_3d_sph.html">
    <div class="docbutton">
    <span class="tooltiptext">3D comparison to the 2D Matplotlib contours example in alternative coordinates.</span>

.. only:: html

.. image:: matplot_ex/images/contours_3d_sph.png
   :class: docfig

Spherical and Cylindrical Contours

.. raw:: html

    </div></a>








.. toctree::
   :hidden:

   matplot_ex/mp_triple.rst

.. raw:: html

    <a href="matplot_ex/mp_triple.html">
    <div class="docbutton">
    <span class="tooltiptext">3D comparison to the 2D Matplotlib example.</span>

.. only:: html

.. image:: matplot_ex/images/mp_triple_1.png
   :class: docfig

Scalar Function Colormapping on a 3D Surface

.. raw:: html

    </div></a>





.. toctree::
   :hidden:

   matplot_ex/expl_norm.rst

.. raw:: html

    <a href="matplot_ex/expl_norm.html">
    <div class="docbutton">
    <span class="tooltiptext">3D surface analogy to a 2D histogram with normalize color mapping.</span>

.. only:: html

.. image:: matplot_ex/images/expl_norm_1.png
   :class: docfig

Data Density Plots

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   matplot_ex/mp_wire.rst

.. raw:: html

    <a href="matplot_ex/mp_wire.html">
    <div class="docbutton">
    <span class="tooltiptext"> Use of the surface edge property to construct a wire frame plot from a datagrid.</span>

.. only:: html

.. image:: matplot_ex/images/mp_wire.png
   :class: docfig

Datagrid Surface Wireframe Plot

.. raw:: html

    </div></a>








.. toctree::
   :hidden:

   matplot_ex/wireframe.rst

.. raw:: html

    <a href="matplot_ex/wireframe.html">
    <div class="docbutton">
    <span class="tooltiptext">Comparison among functional, datagrid and meshgrid methods for constructing wireframe plots.</span>

.. only:: html

.. image:: matplot_ex/images/wireframe.png
   :class: docfig

Functional, Datagrid and Meshgrid Surface wireframe plots

.. raw:: html

    </div></a>













.. toctree::
   :hidden:

   matplot_ex/jacksboro.rst

.. raw:: html

    <a href="matplot_ex/jacksboro.html">
    <div class="docbutton">
    <span class="tooltiptext"> Use of a topographic data set to create a 3D visualization.</span>

.. only:: html

.. image:: matplot_ex/images/jacksboro.png
   :class: docfig

Datagrid Geometry

.. raw:: html

    </div></a>








.. toctree::
   :hidden:

   matplot_ex/data_mesh.rst

.. raw:: html

    <a href="matplot_ex/data_mesh.html">
    <div class="docbutton">
    <span class="tooltiptext">Comparison between Datagrid and Meshgrid surface representations.</span>

.. only:: html

.. image:: matplot_ex/images/data_mesh.png
   :class: docfig

Datagrid and Meshgrid surfaces

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   matplot_ex/param_demo.rst

.. raw:: html

    <a href="matplot_ex/param_demo.html">
    <div class="docbutton">
    <span class="tooltiptext">Very basic parameteric curve.</span>

.. only:: html

.. image:: matplot_ex/images/param_demo.png
   :class: docfig

Parametric Curve

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   matplot_ex/colored_line.rst

.. raw:: html

    <a href="matplot_ex/colored_line.html">
    <div class="docbutton">
    <span class="tooltiptext">Color value points on a line.</span>

.. only:: html

.. image:: matplot_ex/images/colored_line.png
   :class: docfig

Multicolored line

.. raw:: html

    </div></a>





.. toctree::
   :hidden:

   matplot_ex/lorenz_demo.rst

.. raw:: html

    <a href="matplot_ex/lorenz_demo.html">
    <div class="docbutton">
    <span class="tooltiptext">Basic sequential line.</span>

.. only:: html

.. image:: matplot_ex/images/lorenz_demo.png
   :class: docfig

Lorenz Attractor

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   matplot_ex/three_lines.rst

.. raw:: html

    <a href="matplot_ex/three_lines.html">
    <div class="docbutton">
    <span class="tooltiptext">Comparison of Three different Line Class object construction methods and visualizations.</span>

.. only:: html

.. image:: matplot_ex/images/three_lines.png
   :class: docfig

Line Class Comparison

.. raw:: html

    </div></a>







.. toctree::
   :hidden:

   matplot_ex/mp_quiver.rst

.. raw:: html

    <a href="matplot_ex/mp_quiver.html">
    <div class="docbutton">
    <span class="tooltiptext">Basic vector plot.</span>

.. only:: html

.. image:: matplot_ex/images/mp_quiver.png
   :class: docfig

3D quiver plot

.. raw:: html

    </div></a>







.. toctree::
   :hidden:

   matplot_ex/lineframe.rst

.. raw:: html

    <a href="matplot_ex/lineframe.html">
    <div class="docbutton">
    <span class="tooltiptext">Comparison among functional, datagrid and meshgrid methods for constructing wireframe line plots.</span>

.. only:: html

.. image:: matplot_ex/images/lineframe.png
   :class: docfig

Functional, Datagrid and Meshgrid Line wireframe plots

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   matplot_ex/datagrid_slices.rst

.. raw:: html

    <a href="matplot_ex/datagrid_slices.html">
    <div class="docbutton">
    <span class="tooltiptext">Use of 3D dataset to create a set of line slices.</span>

.. only:: html

.. image:: matplot_ex/images/datagrid_slices.png
   :class: docfig

Datagrid Slices

.. raw:: html

    </div></a>







.. toctree::
   :hidden:

   matplot_ex/contours_demo.rst

.. raw:: html

    <a href="matplot_ex/contours_demo.html">
    <div class="docbutton">
    <span class="tooltiptext">Contour plots on planes of constant z</span>

.. only:: html

.. image:: matplot_ex/images/contours_demo.png
   :class: docfig

Contour Levels in 3D

.. raw:: html

    </div></a>





.. toctree::
   :hidden:

   matplot_ex/proj_contours.rst

.. raw:: html

    <a href="matplot_ex/proj_contours.html">
    <div class="docbutton">
    <span class="tooltiptext">Projection of contours on the 'walls' of the graph</span>

.. only:: html

.. image:: matplot_ex/images/proj_contours.png
   :class: docfig

Projecting contour profiles

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   matplot_ex/filled_slice.rst

.. raw:: html

    <a href="matplot_ex/filled_slice.html">
    <div class="docbutton">
    <span class="tooltiptext">Create polygons which fill the space under a line graph.</span>

.. only:: html

.. image:: matplot_ex/images/filled_slice.png
   :class: docfig

Filled 3D Line Graph

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   matplot_ex/vol_plot.rst

.. raw:: html

    <a href="matplot_ex/vol_plot.html">
    <div class="docbutton">
    <span class="tooltiptext">Visualization equivalent to xyz voxel plots.</span>

.. only:: html

.. image:: matplot_ex/images/vol_plot.png
   :class: docfig

Volumetric Plot

.. raw:: html

    </div></a>




.. toctree::
   :hidden:

   matplot_ex/vol_plot_rgb.rst

.. raw:: html

    <a href="matplot_ex/vol_plot_rgb.html">
    <div class="docbutton">
    <span class="tooltiptext">Visualization equivalent to xyz voxel plots.</span>

.. only:: html

.. image:: matplot_ex/images/vol_plot_rgb.png
   :class: docfig

Volumetric Plot with RGB

.. raw:: html

    </div></a>