Examples and API reference
==========================

After the quickstart, there are two main ways to keep learning the library.

Example gallery
---------------

Use the :doc:`/example_gallery/auto_examples/index` when you want:

- tutorial-style examples
- beginner tutorials that introduce one core operation at a time
- longer workflows with plots or rendered outputs
- usage patterns that are easier to understand from complete scripts

The gallery now starts with a basic path through the library:

1. create a ``TensorMesh`` from PyVista
2. compute cell volumes on a volume mesh
3. extract a boundary surface
4. compute enclosed volume on a watertight surface
5. transfer data between points and cells
6. inspect oriented face area vectors

The gallery is also split into two sections:

- ``Basic tutorials`` for this guided path
- ``Advanced examples`` for optimization and richer end-to-end workflows

API reference
-------------

Use the :doc:`/api_reference/index` when you want:

- exact public symbols
- function and class signatures
- docstring-level details for specific methods

Suggested reading order
-----------------------

If you are new to the project, the practical order is:

1. :doc:`quickstart`
2. :doc:`/example_gallery/auto_examples/index`
3. :doc:`/api_reference/index`

Within the gallery, finish ``Basic tutorials`` before moving to
``Advanced examples``. When the gallery answers the "how" but not the "what
exactly", switch to the API reference.