Aperçu des graphiques en courbes

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

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 l’infrastructure CoreWeave, CoreWeave Mission Control surveille votre infrastructure de calcul. En cas d’erreur, W&B ajoute des informations sur l’infrastructure aux graphiques de votre run dans le Workspace de votre projet. Pour en savoir plus, voir Visualiser les alertes d’infrastructure CoreWeave.

​

Ajouter un graphique en courbes

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

Graphique en courbes à métrique unique

Dans un workspace automatique, 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 ... 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.
   2. Pour ajouter des expressions calculées à l’axe x ou 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.

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 ou Bar plots.

6. Cliquez sur Apply.

Graphique en courbes multi-métriques

Cette fonctionnalité est en préversion et disponible sur invitation uniquement. Pour demander à y participer, contactez l’assistance ou votre AISE.

Dans un Workspace automatique, 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 de façon globale, cliquez sur Add panels dans la barre de contrôle, à côté du champ de recherche des panneaux.

   Pour ajouter directement un graphique en courbes à une section, cliquez plutôt sur le menu d’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. Pendant la saisie, l’UI 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.

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 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.

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.

​

Modifier les paramètres du graphique en courbes

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.

​

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.

​

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. Pour plus de détails sur chaque préférence d’affichage, consultez 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 :

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.
   • 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 souhaitez voir la moyenne de leurs valeurs sur un graphique, vous pouvez utiliser la fonctionnalité de regroupement 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 :

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

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

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

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.

Depuis le tableau des runs

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.

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.

​

Visualiser sur différents axes x

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.

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 :

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

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

Désactivez la légende du graphique en courbes avec cette simple 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 rapidement créer une notification de métriques de run 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.