Use this file to discover all available pages before exploring further.
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.
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.
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.
Cliquez sur Créer [NUMBER] panneaux.
Pour ajouter à la place un graphique en courbes personnalisé, cliquez sur Graphique en courbes.
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.
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.
Cette fonctionnalité est en préversion et disponible sur invitation uniquement. Pour demander à y être inscrit, contactez l’assistance ou votre AISE.
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 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.
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 expression régulière JavaScript. 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.
Les graphiques en courbes multi-métriques utilisent des expressions régulières JavaScript 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.
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.
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 :
Un panneau pour les métriques correspondant à layer_0.
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.
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.
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 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 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.
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.
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.
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")})
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.
Accédez à votre Workspace.
Survolez le panneau dont vous souhaitez modifier les paramètres.
Sélectionnez l’icône en forme de crayon qui apparaît.
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 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.
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 :
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.
