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.

Pour les runs qui s’exécutent sur des clusters CoreWeave Kubernetes Service (CKS), CoreWeave 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.

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.

Graphique en courbes à métrique unique
Graphique en courbes avec plusieurs métriques

Dans un espace de travail automatique, 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.

Accédez à votre espace de travail.
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.
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.
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.
2. Pour ajouter des expressions calculées à l’axe X ou à l’axe Y, cliquez sur Expressions. Les expressions régulières JavaScript 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.
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 ou Graphiques en barres.
Cliquez sur Appliquer.

Dans un espace de travail automatique, 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 affichant plusieurs métriques sélectionnées à l’aide d’une expression régulière JavaScript. Un graphique en courbes multi-métrique vous permet de comparer des métriques associées dans un même panneau au lieu de les examiner dans plusieurs panneaux.

Accédez à votre espace de travail.
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.
Cliquez sur Quick panel builder, puis sur l’onglet Multi-metric panels.
Dans Regex, saisissez une expression au format RE2 de Google. 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.
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.
Cliquez sur Create [NUMBER] panels.

Expressions régulières multi-métriques

Les graphiques en courbes multi-métriques utilisent la syntaxe RE2 de Google 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.

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.

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 :

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

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

Data : Configurez axe X, 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.
Légende : Personnalisez l’apparence et le contenu de la légende du panneau.
Expressions : Ajoutez des expressions calculées personnalisées pour les axes. Pour la liste complète des opérateurs et des exemples d’expressions, y compris les opérations arithmétiques comme la multiplication, voir Expressions.

Pour plus d’informations sur chaque paramètre, voir la Référence du graphique en courbes.

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 :

Accédez à votre Workspace.
Cliquez sur l’icône d’engrenage de la section pour ouvrir ses paramètres.
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. Pour plus de détails sur chaque préférence d’affichage, voir Configurer la mise en page de la section.

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 :

Accédez à votre Workspace.
Cliquez sur l’icône des paramètres du Workspace, représentée par un engrenage avec le libellé Settings.
Cliquez sur graphiques en courbes.
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.
- Pour plus de détails sur chaque section de Display preferences, voir Préférences d’affichage du Workspace. 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 :

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.

Accédez à votre Workspace.
Sélectionnez le bouton Add panels dans le coin supérieur droit de la page.
Dans le volet qui s’ouvre, développez le menu déroulant Évaluation.
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.

Depuis le tableau des runs
Depuis les paramètres de la légende du 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.

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 :

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.

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 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 pour la métrique qu’il affiche :

Accédez à votre Workspace.
Survolez le panneau, puis cliquez sur l’icône en forme de cloche.
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.

Guides

Intégrations

Référence

Ajouter un graphique en courbes

Expressions régulières multi-métriques

Cas d’usage courants

Groupes de capture

Modifier les paramètres du graphique en courbes

Graphique en courbes individuel

Tous les graphiques en courbes d’une section

Tous les graphiques en courbes d’un Workspace

Visualiser des valeurs moyennes sur un graphique

Visualiser une valeur NaN dans un graphique

Comparer plusieurs métriques sur un même graphique

Modifier les couleurs des lignes

Visualiser sur différents axes X

Zoom

Masquer la légende du graphique

Créer une notification de métriques de run

​Ajouter un graphique en courbes

​Expressions régulières multi-métriques

​Cas d’usage courants

​Groupes de capture

​Modifier les paramètres du graphique en courbes

​Graphique en courbes individuel

​Tous les graphiques en courbes d’une section

​Tous les graphiques en courbes d’un Workspace

​Visualiser des valeurs moyennes sur un graphique

​Visualiser une valeur NaN dans un graphique

​Comparer plusieurs métriques sur un même graphique

​Modifier les couleurs des lignes

​Visualiser sur différents axes X

​Zoom

​Masquer la légende du graphique

​Créer une notification de métriques de run

Ajouter un graphique en courbes

Expressions régulières multi-métriques

Cas d’usage courants

Groupes de capture

Modifier les paramètres du graphique en courbes

Graphique en courbes individuel

Tous les graphiques en courbes d’une section

Tous les graphiques en courbes d’un Workspace

Visualiser des valeurs moyennes sur un graphique

Visualiser une valeur NaN dans un graphique

Comparer plusieurs métriques sur un même graphique

Modifier les couleurs des lignes

Visualiser sur différents axes X

Zoom

Masquer la légende du graphique

Créer une notification de métriques de run