.. _example:

.. role:: underline
    :class: underline

***************
Examples
***************

These examples demonstrate the various capabilities using S3Dlib.
Similar to image editing, 3D visualizations using S3Dlib are
developed through a **sequence of operations** using object methods.  
Consequently, these examples may be considered tutorials demonstrating how to
use operational sequences rather than using individual methods.

.. raw:: html
   :file: examples_linkgrid.html


.. toctree::
   :maxdepth: 1
   :hidden:

   matplot_ex
   functional
   imagemap
   datagridmap
   colormaps
   3d_lines
   contours
   composite
   ruled
   data_surface
   vectors
   animations
   showcase
   export






Numerous examples use a *rez* with a value from 5 to 7.  Although such higher values
reduce the interactive response time during development, the plots are clearer and more detailed.  This is
particularly the case for surfaces with higher curvatures or mapped images.
Script development is generally done at a lower *rez* value and 
then easily reassigned to a higher value for producing the final static or animated image.
This is useful when developing figures having multiple objects and including
detailed Matplotlib annotation to the figures.  For a few figure examples with multiple axes, multiple surfaces,
and/or high rez, the **REOM** (relative execution-time order of magnitude) is indicated.

Introductory tutorials to get started using S3Dlib are found in the :ref:`tutorial` pages.
More detailed explanations of objects and functions are given in the :ref:`doc_index` pages.

Source data for these examples are found in :ref:`data_reference` page.


.. toctree::
   :hidden:

   referenceData.rst