:orphan:

.. _core-tutorials:

Tutorials
=========

Follow step-by-step tutorials to learn how to use metatensor classes to store
your own data, including complex sparsity patterns and gradients handling.

Once you understand the core concepts, you can explore more advanced tutorials
about creating custom ML models using tools from :ref:`metatensor-learn
<learn-tutorials>`.



.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This tutorial explores how data is stored inside metatensor&#x27;s TensorMap, and how to access the associated metadata. This is a companion to the core classes overview &lt;core-classes-overview&gt; page of this documentation, presenting the same concepts with code examples.">

.. only:: html

  .. image:: /examples/core/images/thumb/sphx_glr_1-first-steps_thumb.png
    :alt:

  :doc:`/examples/core/1-first-steps`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">First steps with metatensor</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The one sentence introduction to metatensor mentions that it is a &quot;self-describing sparse tensor data format&quot;. The previous tutorial &lt;core-tutorial-first-steps&gt; explained the self-describing part of the format, and in this tutorial we will explore what makes metatensor a sparse format; and how to remove this sparsity when required.">

.. only:: html

  .. image:: /examples/core/images/thumb/sphx_glr_2-handling-sparsity_thumb.png
    :alt:

  :doc:`/examples/core/2-handling-sparsity`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Handling sparsity</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Another big difference between metatensor and other more generic data storage formats is its ability to store and manipulate one or more gradients of the data together with the data itself. In this tutorial, we will see how and where gradients are stored, and what one can do with them.">

.. only:: html

  .. image:: /examples/core/images/thumb/sphx_glr_3-managing-gradients_thumb.png
    :alt:

  :doc:`/examples/core/3-managing-gradients`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Managing gradients</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/core/1-first-steps
   /examples/core/2-handling-sparsity
   /examples/core/3-managing-gradients


.. 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: core_python.zip </examples/core/core_python.zip>`

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

      :download:`Download all examples in Jupyter notebooks: core_jupyter.zip </examples/core/core_jupyter.zip>`


.. only:: html

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

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