> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/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).
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).
## Ajouter un graphique en courbes
Les sections suivantes expliquent comment créer un graphique en courbes pour une métrique unique ou plusieurs métriques.
Dans un [espace de travail automatique](/fr/models/app/features/panels#workspace-modes), W\&B crée automatiquement un graphique en courbes à métrique unique pour chaque métrique enregistrée. Suivez ces étapes pour rajouter un graphique en courbes supprimé d’un espace de travail automatique, ou pour ajouter un graphique en courbes à un espace de travail manuel.
1. Accédez à votre espace de travail.
2. Pour ajouter un graphique en courbes à l’ensemble de l’espace de travail, cliquez sur **Ajouter des panneaux** dans la barre de contrôle, près du champ de recherche des panneaux.
Pour ajouter un graphique en courbes directement à une section, cliquez plutôt sur le menu **d’action ()** de la section, puis sur **+ Ajouter des panneaux**.
3. Pour ajouter un graphique à métrique unique avec les paramètres par défaut, cliquez sur **Générateur rapide de panneaux**.
1. Dans l’onglet **Panneaux à clé unique**, survolez une métrique, puis cliquez sur **Ajouter**. Répétez cette étape pour chaque panneau que vous souhaitez ajouter.
2. Cliquez sur **Créer \[NUMBER] panneaux**.
4. Pour ajouter à la place un graphique en courbes personnalisé, cliquez sur **Graphique en courbes**.
1. Configurez les préférences de données, de regroupement et d’affichage du graphique en courbes à l’aide des onglets correspondants. Pour plus de détails, voir [Modifier les paramètres du graphique en courbes](#edit-line-plot-settings).
2. Pour ajouter des expressions calculées à l’axe X ou à l’axe Y, cliquez sur **Expressions**. Les [expressions régulières JavaScript](https://www.w3schools.com/js/js_regexp.asp) sont prises en charge.
5. 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.
6. Si vous le souhaitez, personnalisez le panneau et ses préférences d’affichage. Les options de configuration dépendent du type de panneau sélectionné. Pour plus d’informations sur les options de chaque type de panneau, voir [Graphiques en courbes](/fr/models/app/features/panels/line-plot/) ou [Graphiques en barres](/fr/models/app/features/panels/bar-plot/).
7. Cliquez sur **Appliquer**.
Cette fonctionnalité est en préversion et disponible sur invitation uniquement. Pour demander à y être inscrit, contactez [l’assistance](mailto:support@wandb.com) ou votre AISE.
Dans un [espace de travail automatique](/fr/models/app/features/panels#workspace-modes), W\&B crée automatiquement un graphique en courbes à métrique unique 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 également regrouper plusieurs graphiques à métrique unique en un seul graphique multi-métrique. Cela peut améliorer les performances d’un espace de travail comportant de nombreuses métriques enregistrées et vous aider à analyser les résultats de vos runs.
1. Accédez à votre espace de travail.
2. Pour ajouter un graphique en courbes globalement, cliquez sur **Add panels** dans la barre de contrôle, à côté du champ de recherche des panneaux.
Pour ajouter un graphique en courbes directement à une section, cliquez plutôt sur le menu **action ()** 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). Au fur et à mesure de 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 qui correspondent à l’expression, y compris les métriques enregistrées ultérieurement.
5. Pour supprimer éventuellement les panneaux à métrique unique en double lors de la création du graphique multi-métrique, activez **Clean up auto-generated panels**. Un aperçu indique quels panneaux seront supprimés. Lorsque cette option est activée, W\&B ne crée pas de graphique à métrique unique pour une métrique nouvellement enregistrée qui correspond à l’expression. Elle apparaît uniquement dans ce graphique multi-métrique.
6. Cliquez sur **Create \[NUMBER] panels**.
### Expressions régulières multi-métriques
Les graphiques en courbes multi-métriques 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. Les sections suivantes décrivent des cas d’usage courants et donnent plus de détails sur le fonctionnement des expressions régulières, notamment sur la manière dont les groupes de capture affectent les panneaux créés par W\&B.
#### Cas d’usage courants
Les exemples suivants montrent différentes façons d’utiliser des panneaux multi-métriques pour vous aider à analyser les résultats de vos expériences.
**Comparer des métriques entre différentes couches ou différents composants du modèle**
Au lieu de créer des panneaux distincts pour les métriques de chaque couche, vous pouvez les afficher ensemble dans un seul panneau. Par exemple, si vous consignez des métriques selon 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 même 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
})
```
**Regroupez les métriques associées par préfixe ou suffixe**
Faites correspondre toutes les métriques qui partagent un même schéma de nommage. Par exemple :
* `train_.*` correspond à toutes les métriques d’entraînement, comme `train_loss`, `train_accuracy`, `train_f1_score`.
* `.*_accuracy` correspond aux métriques de précision de 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 de la première et de la dixième couche, en excluant les couches intermédiaires.
#### 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ée 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.
## Modifier les paramètres du graphique en courbes
Les sections suivantes expliquent 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 des 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).
### Graphique en courbes individuel
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).
### Tous les graphiques en courbes d’une section
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, voir [Configurer la mise en page de la section](../#configure-section-layout).
### Tous les graphiques en courbes d’un Workspace
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 **graphiques en courbes**.
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.
## Visualiser des valeurs moyennes sur un graphique
Si vous avez plusieurs experiments différents et que vous voulez 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.
L'image suivante montre le graphique avant le calcul de la moyenne, avec une ligne par run :
L'image suivante montre un graphique représentant les valeurs moyennes sur plusieurs runs à l'aide de lignes groupées.
## Visualiser une valeur NaN dans un graphique
Pour suivre des métriques qui peuvent parfois être indéfinies, comme une perte qui renvoie `NaN`, vous pouvez les journaliser, et W\&B les affiche dans le graphique en courbes. 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")})
```
## Comparer plusieurs métriques sur un même graphique
Pour comparer côte à côte plusieurs métriques provenant d’un ou de plusieurs runs, ajoutez un panneau **Run comparer** à votre Workspace.
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**.
## Modifier les couleurs des lignes
Si la couleur par défaut des runs ne facilite pas la comparaison, W\&B propose deux façons de modifier les couleurs : depuis le tableau des runs ou depuis les paramètres de la légende d’un graphique.
Chaque run se voit attribuer une couleur aléatoire par défaut lors de l'initialisation.
Lorsque vous cliquez sur l'une des couleurs, une palette de couleurs s'affiche, dans laquelle vous pouvez choisir manuellement la couleur souhaitée.
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**.
## Visualiser sur différents axes X
Par défaut, les graphiques en courbes utilisent les étapes d’entraînement comme axe X, mais vous pouvez passer à un autre axe X pour afficher vos données sous un autre angle. 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. L’exemple suivant montre le passage des étapes au temps relatif, puis au temps réel.
Pour utiliser un axe X 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).
## Zoom
Pour examiner de plus près une zone spécifique d’un graphique en courbes, vous pouvez zoomer simultanément sur les deux axes. 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.
## Masquer la légende du graphique
Si la légende du graphique occupe de l’espace que vous souhaitez utiliser pour le graphique, vous pouvez la désactiver. Désactivez la légende du graphique en courbes avec cette option :
## Créer une notification de métriques de run
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 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/).