Référence des graphiques en courbes

Cette page présente en détail les paramètres des graphiques en courbes. Pour en savoir plus sur l’utilisation des graphiques en courbes, consultez l’Aperçu des graphiques en courbes.

Paramètres des données

Les paramètres des données déterminent les métriques affichées sur le graphique, ainsi que la manière dont les points de données sont échantillonnés, lissés et agrégés.

Axe X

Définissez la plage de l’axe X à partir de n’importe quelle valeur entière ou à virgule flottante journalisée avec wandb.Run.log(). Options temporelles disponibles pour l’axe X :

étape : s’incrémente à chaque appel de wandb.Run.log(). Correspond au nombre d’étapes d’entraînement journalisées par votre modèle. (Par défaut)
Relative Time (Wall) : temps réel écoulé depuis le démarrage du processus. Si vous démarrez un run, le mettez en pause pendant une journée, puis le reprenez et journalisez des données, le point correspondant apparaît à 24 heures.
Relative Time (Process) : temps écoulé au sein du processus en cours d’exécution. Si vous démarrez un run, l’exécutez pendant 10 secondes, le mettez en pause pendant une journée, puis le reprenez, le point correspondant apparaît à 10 secondes.
Wall Time : minutes écoulées depuis le démarrage du premier run du graphique.
X range : par défaut, de la plus petite à la plus grande valeur de votre axe X. Vous pouvez personnaliser les valeurs minimum et maximum.

Axe Y

Définissez les variables de l’axe Y sur n’importe quelle valeur entière ou flottante journalisée avec wandb.Run.log(). Indiquez une valeur unique, un tableau de valeurs ou un histogramme de valeurs. Si vous avez journalisé plus de 1 500 points pour une variable, W&B sous-échantillonne les données à 1 500 points.

Pour personnaliser la couleur des lignes de l’axe Y, modifiez la couleur du run dans le tableau des runs.

Par défaut, l’option Y range couvre la plage comprise entre la plus petite valeur positive de vos métriques (0 inclus) et la plus grande. Vous pouvez personnaliser les valeurs minimum et maximum.

Méthode d’agrégation des points

Choisissez le mode d’échantillonnage utilisé pour afficher les points de données :

Fidélité totale (par défaut) : voir Fidélité totale.
Échantillonnage aléatoire : voir Échantillonnage aléatoire.

Lissage

Définissez le coefficient de lissage entre 0 et 1, 0 correspondant à l’absence de lissage et 1 au lissage maximum. Méthodes de lissage disponibles :

Time-weighted EMA (par défaut) : technique de moyenne mobile exponentielle (EMA) qui lisse les données de séries temporelles en réduisant de manière exponentielle le poids des points précédents.
Running average : remplace chaque point par la moyenne des points compris dans une fenêtre avant et après la valeur x donnée.
Gaussian : calcule une moyenne pondérée des points, dont les poids suivent une distribution gaussienne ayant pour écart type la valeur du paramètre de lissage.
No smoothing

Pour plus de détails, voir Lisser les graphiques en courbes.

Ignorer les valeurs aberrantes

Remettez le graphique à l’échelle pour exclure les valeurs aberrantes des bornes min et max par défaut du graphique. L’effet de ce paramètre dépend du mode d’échantillonnage du graphique :

Mode d’échantillonnage aléatoire : lorsque les valeurs aberrantes sont ignorées, les points situés en dessous de 5 % et au-dessus de 95 % sont exclus du graphique.
Mode fidélité totale : lorsque les valeurs aberrantes sont ignorées, tous les points sont affichés, condensés à la dernière valeur de chaque bucket, et la zone située en dessous de 5 % et au-dessus de 95 % est ombrée.

Nombre maximal de runs ou de groupes

Par défaut, les graphiques n’incluent que les 10 premiers runs ou groupes de runs de la liste de runs ou du run set. Modifiez l’ordre de tri pour choisir les runs ou les groupes affichés.

Un workspace ne peut pas afficher plus de 1 000 runs, quelle que soit sa configuration.

Regroupement des runs

Lorsque le tableau des runs est groupé, chaque graphique en courbes fusionne les runs d’un même groupe en une seule courbe. Configurez la façon dont ce regroupement s’applique aux graphiques :

Use grouping from the runs table in charts : applique le regroupement du tableau des runs aux graphiques en courbes. Activé par défaut. Désactivez-le pour tracer chaque run séparément, que le tableau des runs soit groupé ou non.
Use only latest run per group : trace un seul run par groupe au lieu de fusionner les runs du groupe. Désactivé par défaut. Disponible uniquement au niveau du workspace.
agrégation : valeur de la courbe fusionnée de chaque groupe. Les options disponibles sont Mean, Min et Max. Indisponible lorsque Use only latest run per group est activé.

Si vous exécutez plusieurs fois une expérience dans le même groupe, activez Use only latest run per group. Chaque graphique n’affiche alors que la tentative la plus récente, tandis que les runs précédents sont conservés dans le projet. Le run le plus récent d’un groupe correspond au premier run de ce groupe dans le sélecteur de runs. Pour tracer un autre run pour chaque groupe, modifiez l’ordre de tri du tableau des runs.

Use only latest run per group ne s’applique que lorsque Méthode d’agrégation des points est défini sur fidélité totale, la valeur par défaut. Ce paramètre est sans effet en mode échantillonnage aléatoire.

Type de graphique

Choisissez le style de graphique :

Graphique en courbes
Graphique en aires
Graphique en aires en pourcentage

Configurez le type de graphique dans l’onglet Data. Référez-vous à la section Graphique en courbes individuel.

Paramètres de Grouping

Agrégez tous les runs en activant le regroupement, ou regroupez-les selon une variable donnée. Lorsque vous activez le regroupement dans le tableau des runs, les groupes s’affichent automatiquement dans le graphique.

Group runs : active le regroupement des runs dans le graphique. Requis pour configurer la plage ombrée du graphique. Pour ne plus agréger les runs en une seule courbe, désactivez cette option : il n’existe pas de commutateur distinct permettant de désactiver l’agrégation tout en conservant le regroupement.
Group by : sélectionnez une colonne (facultatif). Tous les runs qui partagent la même valeur dans cette colonne sont regroupés.
agrégation : valeur représentée par la courbe du graphique. Les options disponibles sont la moyenne, la médiane, le minimum et le maximum du groupe. Ce paramètre ne s’applique que lorsque Group runs est activé.
Range : configure la zone ombrée d’un graphique en courbes en fidélité totale. Les options disponibles sont Min/Max, Std Dev, Std Err ou None.

Paramètres du graphique

Configurez les titres et l’affichage de la légende :

Titre du panneau : titre affiché en haut du panneau.
Titre de l’axe X : libellé de l’axe X.
Titre de l’axe Y : libellé de l’axe Y.
Légende : affichez ou masquez la légende, et configurez sa position.

Paramètres de la légende

Personnalisez la légende pour afficher toute valeur de configuration journalisée ainsi que les métadonnées des runs, comme la date de création ou l’utilisateur qui a créé le run.

Modèle de légende

Définissez un modèle pour le nom de la légende.

Cliquez sur l’icône d’engrenage pour ouvrir les paramètres du graphique.
Accédez à l’onglet Display preferences.
Développez Advanced legend, puis indiquez le modèle de légende.
Cliquez sur Appliquer.

Valeurs propres à chaque point

Définissez des valeurs entre [[ ]] pour afficher les valeurs propres à chaque point dans le réticule lorsque vous survolez un graphique.

Cliquez sur l’icône d’engrenage pour ouvrir les paramètres du graphique.
Accédez à l’onglet Display preferences.
En bas de l’onglet, configurez les valeurs propres à chaque point pour une ou plusieurs métriques du graphique.
Cliquez sur appliquer.

Valeurs prises en charge dans [[ ]] :

Valeur	Signification
`${x}`	Valeur X
`${y}`	Valeur Y (lissage compris)
`${original}`	Valeur Y hors lissage
`${mean}`	Moyenne des runs groupés
`${stddev}`	Écart type des runs groupés
`${min}`	Minimum des runs groupés
`${max}`	Maximum des runs groupés
`${percent}`	Pourcentage du total (pour les graphiques en aires empilées)

Expressions

Rédigez des expressions mathématiques pour créer ou transformer des graphiques en courbes à partir de vos métriques journalisées, de vos valeurs de configuration et de vos statistiques de synthèse. Par exemple, vous pouvez calculer la différence entre deux métriques, mettre une métrique à l’échelle à l’aide d’une valeur de configuration ou tracer le logarithme d’une métrique. Les expressions sont évaluées à chaque étape journalisée. Les sections suivantes expliquent comment référencer des valeurs dans les expressions, et décrivent les opérateurs et les fonctions disponibles dans les expressions personnalisées. Dans un graphique en courbes, vous pouvez utiliser une expression pour l’axe X, pour l’axe Y ou pour les deux. Consultez Exemples d’expressions pour découvrir des cas d’usage courants et des exemples d’expressions.

Créer des graphiques en courbes avec des expressions

Accédez au workspace de votre projet.
Cliquez sur le bouton + Add panel, puis sélectionnez graphique en courbes.
Cliquez sur l’onglet Data. Sélectionnez les données à représenter sur le graphique en courbes, pour l’axe X comme pour l’axe Y.
Cliquez sur l’onglet Expressions.
Saisissez votre expression dans le champ axe Y ou axe X.
Cliquez sur appliquer pour enregistrer vos paramètres et afficher le graphique en courbes.

Transformer des graphiques en courbes existants à l’aide d’expressions

Ouvrez le graphique en courbes à transformer.
Cliquez sur l’icône d’engrenage dans le coin supérieur droit du graphique pour modifier le panneau.
Cliquez sur l’onglet Expressions.
Saisissez votre expression dans le champ axe Y ou axe X.
Cliquez sur appliquer pour enregistrer vos paramètres et afficher le graphique en courbes mis à jour.

Référencer des valeurs

Le tableau suivant indique comment référencer les métriques journalisées, les paramètres de configuration et les statistiques de synthèse dans les expressions des graphiques en courbes.

Type	Syntaxe	Description	Exemples
Métrique	`${metric_name}`	Référence une métrique journalisée par son nom.	`${val/accuracy}`, `${"accuracy"}`
Paramètre de configuration	`${config:param_name}`	Référence des valeurs de configuration à l’aide du préfixe `${config:}`.	`${config:lr}`, `${config:batch_size}`
Statistique de synthèse	`${summary:stat_name}`	Référence des champs de synthèse à l’aide du préfixe `${summary:}`.	`${summary:final_accuracy}`, `${summary:best_loss}`

Utilisez ${...} pour échapper tout nom de métrique, de paramètre de configuration ou de champ de synthèse contenant des caractères spéciaux, comme / ou -, ou des espaces. Par exemple, si vous journalisez une métrique nommée val/accuracy, référencez-la sous la forme ${val/accuracy} pour éviter toute confusion avec l’opérateur de division. Si vous journalisez un paramètre de configuration nommé dropout-rate, référencez-le sous la forme ${config:dropout-rate}. Si vous journalisez un champ de synthèse nommé best loss, référencez-le sous la forme ${summary:best loss}.

Configurations imbriquées

Accédez aux valeurs de configuration imbriquées à l’aide de la notation pointée, selon la syntaxe suivante :

${config:parent.child.grandchild}

Ici, parent, child et grandchild désignent les clés du dictionnaire de configuration imbriqué. Par exemple, supposons que vous journalisiez la configuration suivante, qui contient des dictionnaires imbriqués :

config = {
    "model": {
        "type": "resnet",
        "layers": 50
    },
    "training": {
        "batch_size": 32,
        "learning_rate": 0.001
    }
}

with wandb.init(project="my-project", config=config) as run:
    ...

Vous pouvez faire référence au type de modèle avec ${config:model.type}, et à la taille de lot avec ${config:training.batch_size}. Autre exemple : prenons la configuration suivante, qui contient des dictionnaires imbriqués :

Config parameters

config:
  optimizer:
    value:
      lr: 0.001
      weight_decay: 0.01
  model:
    value:
      hidden_size: 768

Pour référencer le taux d’apprentissage, utilisez ${config:optimizer.value.lr}, pour la dimension cachée du modèle, ${config:model.value.hidden_size}, et pour la décroissance des poids (weight decay), ${config:optimizer.value.weight_decay}.

Opérateurs disponibles

W&B prend en charge les opérateurs suivants dans les expressions des graphiques en courbes :

Catégorie	Opérateurs
Arithmétique	`+`, `-`, ``, `/`, `%` (modulo), `*` (exposant)
Comparaison	`==`, `!=`, `===`, `!==`, `<`, `>`, `<=`, `>=`
Bit à bit	`\|`, `^`, `&`, `<<`, `>>`, `>>>`
Logique	`\|\|` , `&&`

Constantes et fonctions mathématiques

Toutes les fonctions et constantes mathématiques JavaScript sont prises en charge. Pour plus de détails, consultez la documentation MDN sur l’objet Math. Les tableaux suivants récapitulent les fonctions et constantes les plus couramment utilisées dans les expressions des graphiques en courbes.

Constantes mathématiques

Constante	Description
`e`	Nombre d’Euler
`pi`	Pi
`ln2`	Logarithme népérien de 2
`ln10`	Logarithme népérien de 10
`log2e`	Logarithme en base 2 de e
`log10e`	Logarithme en base 10 de e
`sqrt2`	Racine carrée de 2
`sqrt1_2`	Racine carrée de 1/2

Fonctions arithmétiques et statistiques

Le tableau suivant décrit les fonctions arithmétiques et statistiques disponibles :

Fonction	Description
abs(x)	Valeur absolue
ceil(x)	Fonction plafond (arrondit à l’entier supérieur)
floor(x)	Fonction plancher (arrondit à l’entier inférieur)
round(x)	Arrondit à l’entier le plus proche
min(x, y, …)	Valeur minimale
max(x, y, …)	Valeur maximale
sqrt(x)	Racine carrée

Fonctions logarithmiques et exponentielles

Le tableau suivant décrit les fonctions logarithmiques et exponentielles disponibles :

Fonction	Description
log(x)	Logarithme népérien (base e)
log10(x)	Logarithme en base 10
log2(x)	Logarithme en base 2
exp(x)	Fonction exponentielle (e^x)
pow(x, y)	Fonction puissance (x^y)

Fonctions trigonométriques

Le tableau suivant décrit les fonctions trigonométriques disponibles :

Fonction	Description
sin(x)	Sinus
cos(x)	Cosinus
tan(x)	Tangente
asin(x)	Arc sinus (sinus inverse)
acos(x)	Arc cosinus (cosinus inverse)
atan(x)	Arc tangente (tangente inverse)
atan2(y, x)	Arc tangente à deux arguments

Fonctions hyperboliques

Le tableau suivant décrit les fonctions hyperboliques disponibles :

Fonction	Description
sinh(x)	Sinus hyperbolique
cosh(x)	Cosinus hyperbolique
tanh(x)	Tangente hyperbolique

Exemples d’expressions

Voici quelques exemples d’expressions pour les axes d’un graphique en courbes. Ces exemples sont fournis à titre indicatif. Vous pouvez combiner librement les opérateurs et les fonctions décrits dans les sections précédentes pour créer des expressions complexes adaptées à vos besoins. Pour les exemples suivants, supposons que vos métriques de synthèse comprennent accuracy et loss, avec les valeurs suivantes :

Summary metrics

{
  "accuracy": 0.7829240801794489,
  "loss": 0.2194763318905079
}

Supposons également que votre configuration se présente comme suit :

Config parameters

config = {
    "epochs": 100,
    "optimizer": {
        "value": {
            "lr": 0.001,
            "weight_decay": 0.01
        }
    }
}

Décalez verticalement la métrique de précision en lui ajoutant une valeur constante. Dans l’exemple suivant, la précision est décalée de 1 vers le haut :

1 - accuracy

Décaler verticalement une métrique d’une valeur constante, ici le taux d’apprentissage (lr) :

accuracy+${config:optimizer.value.lr}

Calculez le sinus d’une métrique. L’exemple suivant calcule le sinus de la métrique de perte :

sin(loss)

Déphasez une métrique en lui appliquant une fonction sinus. Par exemple, appliquez une fonction sinus à la métrique de perte et déphasez-la de 2 :

sin(loss - 2)

Mettre à l’échelle la métrique de précision en fonction d’un paramètre de configuration nommé batch_size :

${accuracy} / ${config:batch_size}

Calculez le minimum de deux métriques. L’exemple suivant calcule le minimum de la perte et de la précision :

min(loss, accuracy)

Calculez la racine carrée de la somme des carrés de deux métriques. L’exemple suivant calcule la racine carrée de la somme des carrés de la perte et de la précision :

sqrt(loss ** 2 + accuracy ** 2)

Calculez l’exponentielle de la perte. L’exemple suivant calcule l’exponentielle de la métrique de perte :

sqrt(loss*100)+sqrt(loss*100000)

Vous pouvez également vous référer aux valeurs des métriques de synthèse à l’aide de la syntaxe ${summary:metric_name} dans les expressions. Par exemple :

sqrt(${summary:loss}*100)+sqrt(${summary:loss}*100000)

Expressions de panneau multi-métriques

Utilisez une expression régulière pour créer un seul graphique en courbes qui regroupe plusieurs métriques (y compris les métriques correspondantes qui seront journalisées ultérieurement). Pour des instructions détaillées, voir Ajouter un graphique en courbes. Par exemple :

Au lieu de créer un panneau distinct pour les métriques de chaque couche, vous pouvez les afficher ensemble dans un seul panneau. Par exemple, si vous journalisez des métriques nommées de façon cohérente, comme layer_0_loss, layer_1_loss et layer_2_loss, vous pouvez utiliser une regex telle que layer_\d+_loss pour afficher les pertes de toutes les couches sur un même graphique.
Faites correspondre toutes les métriques qui suivent 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 des différents datasets, comme train_accuracy, val_accuracy, test_accuracy
Utilisez l’alternance pour ne cibler que les métriques souhaitées. Par exemple, le groupe non capturant (?:layer_0|layer_10)_loss ne correspond qu’aux pertes de la première et de la dixième couche, à l’exclusion des couches intermédiaires.

Groupes de capture

Les groupes de capture de votre expression régulière déterminent la manière dont les panneaux à plusieurs métriques sont créés. Ce comportement peut surprendre 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’interface 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 regroupent les métriques 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 seul panneau affichant les deux couches ensemble.

Vous pouvez ainsi choisir l’approche la mieux adaptée à vos besoins d’analyse. Utilisez des groupes de capture pour répartir les métriques dans des panneaux distincts, et des groupes non capturants pour comparer les métriques sur un même graphique.

​Paramètres des données

​Axe X

​Axe Y

​Méthode d’agrégation des points

​Lissage

​Ignorer les valeurs aberrantes

​Nombre maximal de runs ou de groupes

​Regroupement des runs

​Type de graphique

​Paramètres de Grouping

​Paramètres du graphique

​Paramètres de la légende

​Modèle de légende

​Valeurs propres à chaque point

​Expressions

​Créer des graphiques en courbes avec des expressions

​Transformer des graphiques en courbes existants à l’aide d’expressions

​Référencer des valeurs

​Configurations imbriquées

​Opérateurs disponibles

​Constantes et fonctions mathématiques

​Constantes mathématiques

​Fonctions arithmétiques et statistiques

​Fonctions logarithmiques et exponentielles

​Fonctions trigonométriques

​Fonctions hyperboliques

​Exemples d’expressions

​Expressions de panneau multi-métriques

​Groupes de capture

Paramètres des données

Axe X

Axe Y

Méthode d’agrégation des points

Lissage

Ignorer les valeurs aberrantes

Nombre maximal de runs ou de groupes

Regroupement des runs

Type de graphique

Paramètres de Grouping

Paramètres du graphique

Paramètres de la légende

Modèle de légende

Valeurs propres à chaque point

Expressions

Créer des graphiques en courbes avec des expressions

Transformer des graphiques en courbes existants à l’aide d’expressions

Référencer des valeurs

Configurations imbriquées

Opérateurs disponibles

Constantes et fonctions mathématiques

Constantes mathématiques

Fonctions arithmétiques et statistiques

Fonctions logarithmiques et exponentielles

Fonctions trigonométriques

Fonctions hyperboliques

Exemples d’expressions

Expressions de panneau multi-métriques

Groupes de capture