> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-docs-2751.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Tutoriel expliquant comment créer des jobs de sweep à partir d'un projet W&B existant.

# Tutoriel : créer un job de sweep à partir d’un projet

Ce tutoriel explique comment créer des jobs de sweep à partir d'un projet W\&B existant. Il vous guide dans la création d’un projet de référence, la configuration d’un sweep d’hyperparamètres et le lancement d’agents qui exécutent des tâches d’entraînement en parallèle.

Vous utilisez le [jeu de données Fashion MNIST](https://github.com/zalandoresearch/fashion-mnist) pour entraîner un réseau neuronal convolutif PyTorch à classer des images. Le [dépôt W\&B examples (PyTorch CNN Fashion)](https://github.com/wandb/examples/tree/master/examples/pytorch/pytorch-cnn-fashion) fournit le code et le jeu de données requis.

Explorez les résultats dans ce [tableau de bord W\&B](https://app.wandb.ai/carey/pytorch-cnn-fashion).

<div id="create-a-project">
  ## Créer un projet
</div>

Commencez par créer un projet de référence en entraînant le modèle d’exemple au moins une fois. Cette référence fournit au sweep une base de configuration pour les étapes suivantes. Téléchargez le modèle d’exemple PyTorch pour le dataset MNIST depuis le dépôt GitHub W\&B examples. Ensuite, entraînez le modèle. Le script d’entraînement se trouve dans le répertoire `examples/pytorch/pytorch-cnn-fashion`.

Pour télécharger et entraîner le modèle d’exemple :

1. Clonez le dépôt :

   ```bash theme={null}
   git clone https://github.com/wandb/examples.git
   ```

2. Accédez au répertoire de l’exemple :

   ```bash theme={null}
   cd examples/pytorch/pytorch-cnn-fashion
   ```

3. Exécutez manuellement le script d’entraînement :

   ```bash theme={null}
   python train.py
   ```

4. Facultatif : explorez l’exemple dans le tableau de bord de W\&B App. [Voir une page de projet d’exemple](https://app.wandb.ai/carey/pytorch-cnn-fashion).

Une fois cette exécution initiale terminée, vous disposez d’un projet de référence dans W\&B sur lequel le sweep peut s’appuyer.

<div id="create-a-sweep">
  ## Créer un sweep
</div>

Une fois votre projet de référence en place, vous pouvez configurer un sweep à partir de ses runs. Depuis la page de votre projet, ouvrez l’[onglet **Sweep**](/fr/models/sweeps/visualize-sweep-results) dans la barre latérale du projet et sélectionnez **Create Sweep**.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-2751/CvscwAgEQUx8dSjP/images/sweeps/sweep1.png?fit=max&auto=format&n=CvscwAgEQUx8dSjP&q=85&s=1afd82cc003ce89a28435d29b56ec17f" alt="Page de projet W&B avec l’onglet Sweep ouvert et le bouton Create Sweep mis en évidence" width="1589" height="636" data-path="images/sweeps/sweep1.png" />
</Frame>

La configuration générée automatiquement suggère des valeurs à tester pour le sweep en fonction des runs que vous avez déjà effectués. Modifiez la configuration pour spécifier les plages d’hyperparamètres que vous voulez essayer. Lorsque vous lancez le sweep, un nouveau processus démarre sur le serveur de sweep hébergé par W\&B. Ce service centralisé coordonne les agents (les machines qui exécutent les tâches d'entraînement).

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-2751/CvscwAgEQUx8dSjP/images/sweeps/sweep2.png?fit=max&auto=format&n=CvscwAgEQUx8dSjP&q=85&s=5fda7355146dc064a2a8b839301f2fc6" alt="Éditeur de configuration de sweep générée automatiquement affichant des plages d’hyperparamètres" width="2308" height="1768" data-path="images/sweeps/sweep2.png" />
</Frame>

<div id="launch-agents">
  ## Lancez des agents
</div>

Après avoir configuré le sweep, lancez un ou plusieurs agents pour exécuter les runs. Vous pouvez lancer jusqu'à 20 agents en parallèle sur différentes machines pour terminer la tâche de sweep plus rapidement. Chaque agent affiche le prochain ensemble de paramètres à utiliser.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-2751/CvscwAgEQUx8dSjP/images/sweeps/sweep3.png?fit=max&auto=format&n=CvscwAgEQUx8dSjP&q=85&s=1f03057db4e3be71ca633dd909103b50" alt="Sortie du terminal d'un agent de balayage affichant le prochain ensemble d'hyperparamètres" width="2082" height="1046" data-path="images/sweeps/sweep3.png" />
</Frame>

Vous avez maintenant un sweep en cours d'exécution qui coordonne les tâches d'entraînement entre vos agents et transmet les résultats à W\&B. L'image suivante montre le tableau de bord avec la tâche de sweep d'exemple en cours d'exécution.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-2751/CvscwAgEQUx8dSjP/images/sweeps/sweep4.png?fit=max&auto=format&n=CvscwAgEQUx8dSjP&q=85&s=8c20fe5174a8bd90b78876f128476067" alt="Tableau de bord du sweep affichant les métriques de runs d'entraînement parallèles" width="3346" height="1512" data-path="images/sweeps/sweep4.png" />
</Frame>

<div id="seed-a-new-sweep-with-existing-runs">
  ## Amorcer un nouveau sweep avec des runs existants
</div>

Pour réutiliser des résultats antérieurs comme point de départ, lancez un nouveau sweep à l’aide de runs existants que vous avez précédemment enregistrés :

1. Ouvrez le tableau de votre projet.
2. Cliquez sur la case à cocher de la ligne du run pour sélectionner ce run.
3. Dans le menu déroulant, sélectionnez l’option pour créer un nouveau sweep.

Votre sweep est maintenant configuré sur le serveur. Lancez un ou plusieurs agents pour démarrer les runs.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-2751/CvscwAgEQUx8dSjP/images/sweeps/tutorial_sweep_runs.png?fit=max&auto=format&n=CvscwAgEQUx8dSjP&q=85&s=dcff3f8474b4469142d150545c08f180" alt="Tableau des runs du projet avec des lignes sélectionnées et l'option de création d'un sweep dans le menu déroulant" width="1786" height="1086" data-path="images/sweeps/tutorial_sweep_runs.png" />
</Frame>

<Note>
  Si vous démarrez le nouveau sweep en tant que sweep bayésien, les runs sélectionnés servent également à initialiser le processus gaussien.
</Note>
