:orphan:

Tutorials
=========

These tutorials demonstrate how to use the trx-python library
for working with TRX tractography files.

Getting Started
---------------

New to TRX? These tutorials will guide you through:

1. **Reading and Writing TRX Files** - Load, inspect, and save TRX files
2. **Working with Groups** - Organize streamlines into anatomical bundles
3. **Data Per Vertex and Streamline** - Work with metadata

Prerequisites
-------------

To run these tutorials, you need:

- trx-python installed (``pip install trx-python[all]``)
- An internet connection (for downloading test data on first run)

Each tutorial can be run as a Python script or in a Jupyter notebook.



.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This tutorial demonstrates how to read and write TRX files using trx-python. TRX is a tractography file format designed for efficient storage and access of brain fiber tract streamline data.">

.. only:: html

  .. image:: /auto_examples/images/thumb/sphx_glr_plot_read_write_trx_thumb.png
    :alt:

  :doc:`/auto_examples/plot_read_write_trx`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Reading and Writing TRX Files</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This tutorial demonstrates how to work with groups in TRX files. Groups allow you to organize streamlines into meaningful subsets, such as anatomical bundles or clusters.">

.. only:: html

  .. image:: /auto_examples/images/thumb/sphx_glr_plot_groups_thumb.png
    :alt:

  :doc:`/auto_examples/plot_groups`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Working with Groups</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This tutorial demonstrates how to work with metadata in TRX files. TRX supports two types of metadata:">

.. only:: html

  .. image:: /auto_examples/images/thumb/sphx_glr_plot_dps_dpv_thumb.png
    :alt:

  :doc:`/auto_examples/plot_dps_dpv`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Data Per Vertex and Data Per Streamline</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/plot_read_write_trx
   /auto_examples/plot_groups
   /auto_examples/plot_dps_dpv


.. 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: auto_examples_python.zip </auto_examples/auto_examples_python.zip>`

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

      :download:`Download all examples in Jupyter notebooks: auto_examples_jupyter.zip </auto_examples/auto_examples_jupyter.zip>`


.. only:: html

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

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