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

> Visualisez les métriques, personnalisez les axes et comparez plusieurs courbes sur un graphique

# Aperçu des graphiques en courbes

Les graphiques en courbes s’affichent par défaut pour les métriques enregistrées avec `wandb.Run.log()` au fil du temps. Les graphiques en courbes permettent de tracer plusieurs métriques, de calculer des axes personnalisés, et plus encore.

Cette page explique comment créer, configurer et gérer des graphiques en courbes dans un [Workspace](/fr/models/track/workspaces).

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-1917/CB9tJSsSFnrt6bwh/images/app_ui/line_plot_example.png?fit=max&auto=format&n=CB9tJSsSFnrt6bwh&q=85&s=cd0574c49029a9df56a8595d64a30eda" alt="Exemple de graphique en courbes" width="1838" height="622" data-path="images/app_ui/line_plot_example.png" />
</Frame>

<Tip>
  Pour les [runs](/fr/models/runs) qui s’exécutent sur des clusters [CoreWeave Kubernetes Service (CKS)](https://docs.coreweave.com/products/cks), [CoreWeave Mission Control](https://www.coreweave.com/mission-control) peut surveiller votre infrastructure de calcul lorsque l’intégration est activée. En cas d’erreur, W\&B ajoute des informations sur l’infrastructure aux graphiques de votre run dans le Workspace de votre projet. Pour connaître les prérequis et obtenir plus de détails, voir [Visualiser les alertes d’infrastructure CoreWeave](/fr/models/runs/infrastructure-alerts).
</Tip>

<div id="add-a-line-plot">
  ## Ajouter un graphique en courbes
</div>

Cette section explique comment créer un graphique en courbes pour une métrique unique ou plusieurs métriques.

<Tabs>
  <Tab title="Graphique en courbes à métrique unique">
    Dans un [workspace automatique](/fr/models/app/features/panels#workspace-modes), un graphique en courbes à métrique unique est créé automatiquement pour chaque métrique enregistrée. Suivez ces étapes pour rajouter un graphique en courbes supprimé d’un workspace automatique, ou pour ajouter un graphique en courbes à un workspace manuel.

    1. Accédez à votre Workspace.
    2. Pour ajouter un graphique en courbes globalement, cliquez sur **Add panels** dans la barre de contrôle près du champ de recherche des panneaux.

       Pour ajouter directement un graphique en courbes à une section, cliquez plutôt sur le menu **d’action (<Icon icon="ellipsis" iconType="solid" />)** de la section, puis sur **+ Add panels**.
    3. Pour ajouter un graphique à métrique unique avec les paramètres par défaut, cliquez sur **Quick panel builder**.
       1. Dans l’onglet **Single-key panels**, survolez une métrique, puis cliquez sur **Add**. Répétez cette étape pour chaque panneau que vous souhaitez ajouter.
       2. Cliquez sur **Create \<number> panels**.
    4. Pour ajouter à la place un graphique en courbes personnalisé, cliquez sur **Line plot**.
       1. Configurez les données, le regroupement et les préférences d’affichage du graphique en courbes à l’aide des onglets correspondants. Pour en savoir plus, voir [Edit line plot settings](#edit-line-plot-settings).
       2. Pour ajouter des expressions calculées à l’axe x ou y, cliquez sur **Expressions**. Les [expressions régulières JavaScript](https://www.w3schools.com/js/js_regexp.asp) sont prises en charge.
          Sélectionnez le type de panneau à ajouter, par exemple un graphique. Les détails de configuration du panneau s’affichent avec les valeurs par défaut sélectionnées.
    5. Si vous le souhaitez, personnalisez le panneau et ses préférences d’affichage. Les options de configuration dépendent du type de panneau que vous sélectionnez. Pour en savoir plus sur les options de chaque type de panneau, reportez-vous à la section pertinente ci-dessous, comme [Line plots](/fr/models/app/features/panels/line-plot/) ou [Bar plots](/fr/models/app/features/panels/bar-plot/).
    6. Cliquez sur **Apply**.
  </Tab>

  <Tab title="Graphique en courbes multi-métriques">
    <Note>
      Cette fonctionnalité est en préversion et disponible sur invitation uniquement. Pour demander à y participer, contactez l'[assistance](mailto:support@wandb.com) ou votre AISE.
    </Note>

    Dans un [Workspace automatique](/fr/models/app/features/panels#workspace-modes), un graphique en courbes à métrique unique est créé automatiquement pour chaque métrique enregistrée. Cette section explique comment créer un graphique en courbes unique affichant plusieurs métriques à la fois, définies par une expression régulière JavaScript. Vous pouvez aussi regrouper plusieurs graphiques à métrique unique en un seul graphique à métriques multiples. Cela peut améliorer les performances d'un Workspace contenant de nombreuses métriques enregistrées et vous aider à analyser efficacement les résultats de vos Runs.

    1. Accédez à votre Workspace.
    2. Pour ajouter un graphique en courbes globalement, cliquez sur **Add panels** dans la barre de contrôle près du champ de recherche des panneaux.

       Pour ajouter directement un graphique en courbes à une section, cliquez plutôt sur le menu **d’action (<Icon icon="ellipsis" iconType="solid" />)** de la section, puis sur **+ Add panels**.
    3. Cliquez sur **Quick panel builder**, puis sur l'onglet **Multi-metric panels**.
    4. Dans **Regex**, saisissez une expression au format [expression régulière JavaScript](https://www.w3schools.com/js/js_regexp.asp). Pendant la saisie, l'interface utilisateur se met à jour pour indiquer quelles métriques correspondent à l'expression. Par défaut, le nom du graphique affiche l'expression régulière utilisée. Le graphique inclut des courbes pour toutes les métriques correspondant à l'expression, y compris celles enregistrées ultérieurement.
    5. Pour supprimer facultativement les panneaux à métrique unique en double lors de la création du graphique à métriques multiples, activez **Clean up auto-generated panels**. Un aperçu indique quels panneaux seront supprimés. <Note>Lorsque cette option est activée, aucun graphique à métrique unique n'est créé pour une nouvelle métrique enregistrée qui correspond à l'expression. Elle est incluse uniquement dans ce graphique à métriques multiples.</Note>
    6. Cliquez sur **Create \<number> panels**.

    ### En savoir plus sur les expressions régulières multi-métriques

    Les graphiques en courbes à métriques multiples utilisent des [expressions régulières JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions) pour faire correspondre les noms de métriques. Cette section présente quelques cas d'usage courants et donne plus de détails sur le fonctionnement des expressions régulières, notamment sur la façon dont les groupes de capture influencent les panneaux créés.

    #### Cas d'usage courants

    Cette section présente quelques façons d'utiliser les panneaux multi-métriques pour vous aider à analyser les résultats de vos expériences.

    **Comparer les métriques entre les couches ou les composants du modèle**
    Au lieu de créer des panneaux séparés pour les métriques de chaque couche, vous pouvez les afficher ensemble dans un seul panneau. Par exemple, si vous consignez des métriques avec une convention de nommage cohérente, comme `layer_0_loss`, `layer_1_loss` et `layer_2_loss` dans cet exemple de code Python, vous pouvez utiliser la regex `layer_\d+_loss` pour afficher toutes les pertes des couches sur un seul graphique.

    ```python theme={null}
    with wandb.init(project="multi-layer-model") as run:
        for step in range(100):
            run.log({
                "layer_0_loss": loss_0,
                "layer_1_loss": loss_1,
                "layer_2_loss": loss_2,
                "step": step
            })
    ```

    **Regrouper les métriques liées par préfixe ou suffixe**
    Faites correspondre toutes les métriques qui partagent un schéma de nommage commun. Par exemple :

    * `train_.*` correspond à toutes les métriques d'entraînement, comme `train_loss`, `train_accuracy`, `train_f1_score`
    * `.*_accuracy` correspond aux métriques d'exactitude sur différents jeux de données, comme `train_accuracy`, `val_accuracy`, `test_accuracy`

    **Faire correspondre des variantes de métriques spécifiques**
    Utilisez l'alternance pour ne faire correspondre que les métriques souhaitées. Par exemple, le groupe non capturant `(?:layer_0|layer_10)_loss` correspond uniquement aux pertes des première et dixième couches, en excluant les couches intermédiaires.

    #### Comprendre les groupes de capture

    Les groupes de capture de votre expression régulière déterminent la façon dont les panneaux affichant plusieurs métriques sont créés. Ce comportement peut être déroutant si vous ne vous y attendez pas.

    * **Les groupes de capture créent plusieurs panneaux**
      Lorsque votre expression régulière contient des parenthèses formant un groupe de capture, l’UI crée un panneau distinct pour chaque valeur unique capturée par ce groupe.

      Par exemple, l’expression `(layer_0|layer_10)_loss` contient un groupe de capture et créera deux panneaux distincts :

      1. Un panneau pour les métriques correspondant à `layer_0`.
      2. Un panneau pour les métriques correspondant à `layer_10`.

    * **Les groupes non capturants conservent les métriques ensemble**
      Pour faire correspondre plusieurs alternatives sans créer de panneaux distincts, utilisez un groupe non capturant avec la syntaxe `?:`. L’expression `(?:layer_0|layer_10)_loss` correspond aux mêmes métriques que dans l’exemple précédent, mais les affiche ensemble dans un seul panneau.

    Voici la différence :

    * `(layer_0|layer_10)_loss` - Crée deux panneaux, un pour chaque couche.
    * `(?:layer_0|layer_10)_loss` - Crée un panneau affichant les deux couches ensemble.

    Cela vous permet de choisir l’approche la mieux adaptée à vos besoins d’analyse. Utilisez des groupes de capture lorsque vous souhaitez séparer les métriques dans des panneaux distincts. Utilisez des groupes non capturants lorsque vous souhaitez comparer des métriques ensemble sur un seul graphique.
  </Tab>
</Tabs>

<div id="edit-line-plot-settings">
  ## Modifier les paramètres du graphique en courbes
</div>

Cette section explique comment modifier les paramètres d’un panneau de graphique en courbes donné, de tous les panneaux de graphique en courbes d’une section ou de tous les panneaux de graphique en courbes d’un Workspace. Pour plus de détails sur les paramètres du graphique en courbes, voir [Référence du graphique en courbes](/fr/models/app/features/panels/line-plot/reference).

<div id="individual-line-plot">
  ### Graphique en courbes individuel
</div>

Les paramètres individuels d’un graphique en courbes remplacent ceux définis pour la section ou le Workspace. Pour personnaliser un graphique en courbes :

1. Accédez à votre Workspace.
2. Survolez le panneau avec la souris, puis cliquez sur l’icône d’engrenage.
3. Dans le volet qui s’affiche, sélectionnez un onglet pour modifier ses paramètres.
4. Cliquez sur **Apply**.

Les paramètres du graphique en courbes sont organisés en onglets :

* **Data** : Configurez x-axis, y-axis, la méthode d’échantillonnage, le lissage, les valeurs aberrantes et le type de graphique.
* **Grouping** : Configurez si et comment regrouper et agréger les Runs dans le graphique.
* **Chart** : Indiquez les titres du panneau et des axes, puis configurez la visibilité et la position de la légende.
* **Legend** : Personnalisez l’apparence et le contenu de la légende du panneau.
* **Expressions** : Ajoutez des expressions calculées personnalisées pour les axes.

Pour plus d’informations sur chaque paramètre, voir la [Référence du graphique en courbes](/fr/models/app/features/panels/line-plot/reference).

<div id="all-line-plots-in-a-section">
  ### Tous les graphiques en courbes d’une section
</div>

Pour personnaliser les paramètres par défaut de tous les graphiques en courbes d’une section et remplacer les paramètres du Workspace pour les graphiques en courbes :

1. Accédez à votre Workspace.
2. Cliquez sur l’icône d’engrenage de la section pour ouvrir ses paramètres.
3. Dans le volet qui s’affiche, sélectionnez les onglets **Data** ou **Display preferences** pour configurer les paramètres par défaut de la section. Pour plus de détails sur chaque paramètre **Data**, voir la [référence du graphique en courbes](/fr/models/app/features/panels/line-plot/reference). Pour plus de détails sur chaque préférence d’affichage, consultez [Configurer la mise en page de la section](../#configure-section-layout).

<div id="all-line-plots-in-a-workspace">
  ### Tous les graphiques en courbes d’un Workspace
</div>

Pour personnaliser les paramètres par défaut de tous les graphiques en courbes d’un Workspace :

1. Accédez à votre Workspace.
2. Cliquez sur l’icône des paramètres du Workspace, représentée par un engrenage avec le libellé **Settings**.
3. Cliquez sur **Line plots**.
4. Dans le volet qui s’affiche, sélectionnez les onglets **Data** ou **Display preferences** pour configurer les paramètres par défaut du Workspace.
   * Pour plus de détails sur chaque paramètre de **Data**, voir la [Référence du graphique en courbes](/fr/models/app/features/panels/line-plot/reference).
   * Pour plus de détails sur chaque section de **Display preferences**, voir [Préférences d’affichage du Workspace](../#configure-workspace-layout). Au niveau du Workspace, vous pouvez configurer le comportement **Zooming** par défaut des graphiques en courbes. Ce paramètre détermine si le zoom est synchronisé entre les graphiques en courbes qui ont une même clé d’axe x. Désactivé par défaut.

<div id="visualize-average-values-on-a-plot">
  ## Visualiser des valeurs moyennes sur un graphique
</div>

Si vous avez plusieurs experiments différents et que vous souhaitez voir la moyenne de leurs valeurs sur un graphique, vous pouvez utiliser la fonctionnalité Grouping dans le tableau. Cliquez sur "Group" au-dessus du tableau des runs et sélectionnez "All" pour afficher les valeurs moyennes dans vos graphiques.

Voici à quoi ressemble le graphique avant le calcul de la moyenne :

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-1917/CB9tJSsSFnrt6bwh/images/app_ui/demo_precision_lines.png?fit=max&auto=format&n=CB9tJSsSFnrt6bwh&q=85&s=fe601b7512b8ec6536e57d31f479da94" alt="Courbes de précision individuelles" width="849" height="440" data-path="images/app_ui/demo_precision_lines.png" />
</Frame>

L'image suivante montre un graphique représentant les valeurs moyennes sur plusieurs runs à l'aide de lignes groupées.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-1917/CB9tJSsSFnrt6bwh/images/app_ui/demo_average_precision_lines.png?fit=max&auto=format&n=CB9tJSsSFnrt6bwh&q=85&s=ffb47ba6cb9f85f9d74160685967f025" alt="Courbes de précision moyennées" width="852" height="441" data-path="images/app_ui/demo_average_precision_lines.png" />
</Frame>

<div id="visualize-nan-value-on-a-plot">
  ## Visualiser une valeur NaN dans un graphique
</div>

Vous pouvez également tracer des valeurs `NaN`, y compris des tenseurs PyTorch, dans un graphique en courbes avec `wandb.Run.log()`. Par exemple :

```python theme={null}
with wandb.init() as run:
    # Journaliser une valeur NaN
    run.log({"test": float("nan")})
```

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-1917/J9MWPMly2QejZKBH/images/app_ui/visualize_nan.png?fit=max&auto=format&n=J9MWPMly2QejZKBH&q=85&s=02edd4450d7e9a0f1130b022dbc5a299" alt="Gestion des valeurs NaN" width="936" height="688" data-path="images/app_ui/visualize_nan.png" />
</Frame>

<div id="compare-multiple-metrics-on-one-chart">
  ## Comparer plusieurs métriques sur un même graphique
</div>

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-1917/J9MWPMly2QejZKBH/images/app_ui/visualization_add.gif?s=7a0c042890e1570cb16f85dfca6b69fa" alt="Ajout de panneaux de visualisation" width="3866" height="2574" data-path="images/app_ui/visualization_add.gif" />
</Frame>

1. Accédez à votre Workspace.
2. Sélectionnez le bouton **Add panels** dans le coin supérieur droit de la page.
3. Dans le volet qui s’ouvre, développez le menu déroulant Évaluation.
4. Sélectionnez **Run comparer**

<div id="change-the-colors-of-the-lines">
  ## Modifier les couleurs des lignes
</div>

Il arrive que la couleur par défaut des runs ne facilite pas la comparaison. Pour y remédier, wandb propose deux façons de modifier manuellement les couleurs.

<Tabs>
  <Tab title="Depuis le tableau des runs">
    Chaque run se voit attribuer une couleur aléatoire par défaut lors de l'initialisation.

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541-docs-1917/CB9tJSsSFnrt6bwh/images/app_ui/line_plots_run_table_random_colors.png?fit=max&auto=format&n=CB9tJSsSFnrt6bwh&q=85&s=f6e7b5e134356d76465a04ca353e8543" alt="Couleurs aléatoires attribuées aux runs" width="272" height="174" data-path="images/app_ui/line_plots_run_table_random_colors.png" />
    </Frame>

    Lorsque vous cliquez sur l'une des couleurs, une palette de couleurs s'affiche, dans laquelle vous pouvez choisir manuellement la couleur souhaitée.

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541-docs-1917/CB9tJSsSFnrt6bwh/images/app_ui/line_plots_run_table_color_palette.png?fit=max&auto=format&n=CB9tJSsSFnrt6bwh&q=85&s=b80b7ae0a03acc2d4d1c2a123b5e588d" alt="La palette de couleurs" width="261" height="393" data-path="images/app_ui/line_plots_run_table_color_palette.png" />
    </Frame>
  </Tab>

  <Tab title="Depuis les paramètres de la légende du graphique">
    1. Accédez à votre Workspace.
    2. Survolez le panneau dont vous souhaitez modifier les paramètres.
    3. Sélectionnez l'icône en forme de crayon qui apparaît.
    4. Choisissez l'onglet **Légende**.

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541-docs-1917/J9MWPMly2QejZKBH/images/app_ui/plot_style_line_plot_legend.png?fit=max&auto=format&n=J9MWPMly2QejZKBH&q=85&s=88dd378bd668324b2824df5a54a9a8e8" alt="Paramètres de la légende d'un graphique en courbes" width="2682" height="1166" data-path="images/app_ui/plot_style_line_plot_legend.png" />
    </Frame>
  </Tab>
</Tabs>

<div id="visualize-on-different-x-axes">
  ## Visualiser sur différents axes x
</div>

Si vous souhaitez voir le temps absolu qu’a pris une expérience, ou le jour où elle s’est exécutée, vous pouvez changer d’axe x. Voici un exemple de passage des étapes au temps relatif, puis au temps réel.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-1917/CB9tJSsSFnrt6bwh/images/app_ui/howto_use_relative_time_or_wall_time.gif?s=1c33c3e13753dfcd31a35db6f6c53503" alt="Options de temps de l’axe x" width="3348" height="1880" data-path="images/app_ui/howto_use_relative_time_or_wall_time.gif" />
</Frame>

Pour utiliser un x-axis personnalisé, journalisez la métrique dans le même appel à `wandb.Run.log()` que celui où vous journalisez le y-axis. Par exemple :

```python theme={null}
with wandb.init() as run:
    for i in range(100):
        run.log({"accuracy": acc, "custom_x": i * 10})
```

Pour plus de détails, consultez [Personnaliser les axes du journal](/fr/models/track/log/customize-logging-axes#customize-log-axes).

<div id="zoom">
  ## Zoom
</div>

Cliquez puis faites glisser pour tracer un rectangle afin de zoomer à la fois verticalement et horizontalement. Cela modifie le zoom des axes X et Y.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-1917/J9MWPMly2QejZKBH/images/app_ui/line_plots_zoom.gif?s=7e5bda8b17f9b184169af670fd47885d" alt="Fonction de zoom du graphique" width="1056" height="473" data-path="images/app_ui/line_plots_zoom.gif" />
</Frame>

<div id="hide-chart-legend">
  ## Masquer la légende du graphique
</div>

Désactivez la légende du graphique en courbes avec cette simple option :

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-1917/CB9tJSsSFnrt6bwh/images/app_ui/demo_hide_legend.gif?s=3185d3c0e70c0c61b7c5408e563a6960" alt="Option pour masquer la légende" width="2720" height="1246" data-path="images/app_ui/demo_hide_legend.gif" />
</Frame>

<div id="create-a-run-metrics-notification">
  ## Créer une notification de métriques de run
</div>

Utilisez [Automations](/fr/models/automations/) pour notifier votre équipe lorsqu'une métrique de run satisfait à une condition que vous définissez. Une automatisation peut publier dans un canal Slack ou déclencher un webhook.

Depuis un graphique en courbes, vous pouvez rapidement créer une [notification de métriques de run](/fr/models/automations/automation-events/#run-events) pour la métrique qu'il affiche :

1. Accédez à votre Workspace.
2. Survolez le panneau, puis cliquez sur l'icône en forme de cloche.
3. Configurez l'automatisation à l'aide des options de configuration de base ou avancée. Par exemple, appliquez un filtre de run pour limiter la portée de l'automatisation, ou configurez un seuil absolu.

Pour en savoir plus, consultez [Automations](/fr/models/automations/).