:orphan:

Mesh Generation
===============

`discretize` provides a numerical grid (or "mesh") on which to solve differential
equations. Each mesh type has a similar API to make working with
different meshes relatively simple. Within `discretize`, all meshes are
classes that have properties like the number of cells `nC`, and methods,
like `plotGrid`.

To learn how to create meshes with `discretize`, we have provided a set
of tutorials. These tutorials aim to teach the user:

	- where discrete variables can live on meshes
	- how to construct various types of meshes
	- how to extract useful properties from mesh objects
	- some aspects of plotting and meshes






.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Here we provide an overview of mesh types and define some terminology. Separate tutorials have been provided for each mesh type.">

.. only:: html

  .. image:: /tutorials/mesh_generation/images/thumb/sphx_glr_1_mesh_overview_thumb.png
    :alt:

  :ref:`sphx_glr_tutorials_mesh_generation_1_mesh_overview.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Overview of Mesh Types</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Tensor meshes are the most basic class of meshes that can be created with discretize. They belong to the class (~discretize.TensorMesh). Tensor meshes can be defined in 1, 2 or 3 dimensions. Here we demonstrate:">

.. only:: html

  .. image:: /tutorials/mesh_generation/images/thumb/sphx_glr_2_tensor_mesh_thumb.png
    :alt:

  :ref:`sphx_glr_tutorials_mesh_generation_2_tensor_mesh.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Tensor meshes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Cylindrical meshes (~discretize.CylindricalMesh) are defined in terms of r (radial position), z (vertical position) and phi (azimuthal position). They are a child class of the tensor mesh class. Cylindrical meshes are useful in solving differential equations that possess rotational symmetry. Here we demonstrate:">

.. only:: html

  .. image:: /tutorials/mesh_generation/images/thumb/sphx_glr_3_cylindrical_mesh_thumb.png
    :alt:

  :ref:`sphx_glr_tutorials_mesh_generation_3_cylindrical_mesh.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Cylindrical meshes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Compared to tensor meshes, tree meshes are able to provide higher levels of discretization in certain regions while reducing the total number of cells. Tree meshes belong to the class (~discretize.TreeMesh). Tree meshes can be defined in 2 or 3 dimensions. Here we demonstrate:">

.. only:: html

  .. image:: /tutorials/mesh_generation/images/thumb/sphx_glr_4_tree_mesh_thumb.png
    :alt:

  :ref:`sphx_glr_tutorials_mesh_generation_4_tree_mesh.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Tree Meshes</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /tutorials/mesh_generation/1_mesh_overview
   /tutorials/mesh_generation/2_tensor_mesh
   /tutorials/mesh_generation/3_cylindrical_mesh
   /tutorials/mesh_generation/4_tree_mesh


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download all examples in Python source code: mesh_generation_python.zip </tutorials/mesh_generation/mesh_generation_python.zip>`

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download all examples in Jupyter notebooks: mesh_generation_jupyter.zip </tutorials/mesh_generation/mesh_generation_jupyter.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_