.. _uses:

Use Cases
+++++++++

Examples By Category
====================

.. raw:: html

    <div class="tiles">
        <a href="cbook/multiprocessing.html" class="tile_item">
            <h3>Multiprocessing</h3>
            <p>Distributed Python and interactive Jupyter</p>
        </a>
        <a href="cbook/data.html" class="tile_item">
            <h3>Data</h3>
            <p>Easy-to-use and HPC-optimized data exchange between applications</p>
        </a>
        <a href="cbook/telemetry.html" class="tile_item">
            <h3>Telemetry</h3>
            <p>Observability for applications and workflows</p>
        </a>
        <a href="cbook/workflows.html" class="tile_item">
            <h3>Workflow</h3>
            <p>AI/HPC workflows across systems and sites</p>
        </a>
        <a href="cbook/ai.html" class="tile_item">
            <h3>AI</h3>
            <p>Data loading and resilient training and inference</p>
        </a>
    </div>

.. toctree::
    :maxdepth: 2
    :hidden:

    cbook/multiprocessing.rst
    cbook/data.rst
    cbook/telemetry.rst
    cbook/workflows.rst
    cbook/ai.rst
    cbook/core.rst

|

Tutorials
=========

.. raw:: html

    <div class="tiles">
        <a href="uses/data_processing.html" class="tile_item">
            <h3>Data processing</h3>
            <p>Process a large dataset in parallel</p>
        </a>
        <a href="uses/orchestrate_procs.html" class="tile_item">
            <h3>Orchestrating processes</h3>
            <p>Orchestrate executing a serial executable with many different arguments</p>
        </a>
        <a href="uses/orchestrate_mpi.html" class="tile_item">
            <h3>Orchestrating MPI applications</h3>
            <p>Orchestrate a parameter sweep for an MPI application</p>
        </a>
        <a href="uses/distributed_training.html" class="tile_item">
            <h3>Distributed PyTorch</h3>
            <p>Train with PyTorch across many GPUs</p>
        </a>
        <a href="uses/workflow.html" class="tile_item">
            <h3>Workflows</h3>
            <p>Develop a workflow that puts it all together</p>
        </a>
    </div>
    <div class="tiles">
        <a href="uses/multinode.html" class="tile_item">
            <h3>Running across nodes</h3>
            <p>Run on a collection of servers or a supercomputer</p>
        </a>
        <a href="uses/jupyter.html" class="tile_item">
            <h3>Jupyter</h3>
            <p>Use a Jupyter notebook with Dragon</p>
        </a>
        <a href="uses/gpus.html" class="tile_item">
            <h3>Controlling GPU Affinity</h3>
            <p>Running functions and processes that use specific GPUs</p>
        </a>
        <a href="uses/grafana.html" class="tile_item">
            <h3>Telemetry with Grafana</h3>
            <p>Visualize and analyze system and custom metrics</p>
        </a>
        <a href="uses/debugging.html" class="tile_item">
            <h3>Debugging</h3>
            <p>Best practies for debugging</p>
        </a>
    </div>

.. toctree::
    :maxdepth: 2
    :hidden:

    uses/data_processing.rst
    uses/orchestrate_procs.rst
    uses/orchestrate_mpi.rst
    uses/distributed_training.rst
    uses/workflow.rst
    uses/multinode.rst
    uses/jupyter.rst
    uses/gpus.rst
    uses/grafana.rst
    uses/debugging.rst