# Tutorials

This section contains step-by-step guides for using the HEST library:

```{eval-rst}
.. toctree::
    :maxdepth: 2
    :hidden:
    :caption: Available Tutorials:

    1. Downloading HEST-1k <tutorials/1-Downloading-HEST-1k.ipynb>
    2. Interacting with HEST-1k <tutorials/2-Interacting-with-HEST-1k.ipynb>
    3. Adding new samples <tutorials/3-Assembling-HEST-Data.ipynb>
    4. Running Benchmark <tutorials/4-Running-HEST-Benchmark.ipynb>
    5. Batch visualization <tutorials/5-Batch-effect-visualization.ipynb>
```

```{eval-rst}
.. grid:: 3
    :gutter: 3

    .. grid-item-card:: 1. Downloading HEST-1k
        :link: tutorials/1-Downloading-HEST-1k
        :link-type: doc

        Download instructions for HEST-1k.

    .. grid-item-card:: 2. Interacting with HEST-1k
        :link: tutorials/2-Interacting-with-HEST-1k
        :link-type: doc

        Instructions for how to interact with HEST-1k samples.

    .. grid-item-card:: 3. Adding new samples to HEST-1k
        :link: tutorials/3-Assembling-HEST-Data
        :link-type: doc

        Instructions for how to add new samples to HEST-1k.

    .. grid-item-card:: 4. HEST-benchmark
        :link: tutorials/4-Running-HEST-Benchmark
        :link-type: doc

        Instructions on how to run HEST-Benchmark (install extras with `pip install -e ".[benchmark]"`).

    .. grid-item-card:: 5. Batch effect visualization
        :link: tutorials/5-Batch-effect-visualization
        :link-type: doc

        Tutorial for batch effect visualization.
```