> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Nuages de points
> Créez et personnalisez des nuages de points dans W&B pour comparer des runs et visualiser les relations entre les métriques de vos expériences.
Utilisez les nuages de points dans W\&B pour comparer des runs et visualiser les relations entre les métriques de vos expériences. Les nuages de points vous aident à repérer les tendances, les valeurs aberrantes et les compromis parmi de nombreux runs, ce qui s'avère utile pour ajuster des hyperparamètres ou comparer des variantes de modèles.
Cas d’utilisation
Utilisez les nuages de points pour comparer plusieurs runs et visualiser les performances d’une expérience. Un nuage de points vous permet de :
* Tracer des lignes pour les valeurs minimales, maximales et moyennes.
* Personnaliser les info-bulles de métadonnées.
* Contrôler la couleur des points.
* Ajuster les plages des axes.
* Utiliser une échelle logarithmique pour les axes.
* Configurer l’étiquetage et la mise en évidence de la **ligne frontière** et des points associés. Voir [Options d’affichage de la ligne frontière](#frontier-line-display-options).
* Ajouter des **lignes de référence** pour marquer des seuils ou des valeurs cibles sur un axe. Voir [Options d’affichage des lignes de référence](#reference-line-display-options).
Exemple
L’exemple suivant présente un nuage de points qui affiche la précision de validation de différents modèles sur plusieurs semaines d’expérimentation. L’infobulle indique la taille de lot, le dropout et les valeurs des axes. Une ligne représente également la moyenne glissante de la précision de validation.
[Voir un exemple en direct](https://forge.coreweave.com/wandb/l2k2/l2k/reports?view=carey%2FScatter%20Plot)
Créer un nuage de points
Pour créer un nuage de points dans l’interface W\&B :
1. Accédez à l’onglet **Workspaces**.
2. Dans le panneau **Charts**, cliquez sur le menu **action ()**.
3. Dans le menu contextuel, sélectionnez **Add panels**.
4. Dans le menu **Add panels**, sélectionnez **Nuage de points**.
5. Définissez les axes `x` et `y` pour représenter les données à afficher. Vous pouvez également définir des plages minimale et maximale pour vos axes, ou ajouter un axe `z`.
6. Cliquez sur **Apply** pour créer le nuage de points.
Le nouveau nuage de points apparaît dans le panneau **Charts** et affiche les données que vous avez configurées.
Options d’affichage de la ligne frontière
La *ligne frontière* d’un nuage de points relie les valeurs les plus élevées et les plus basses de l’axe Y observées jusqu’ici pour les données du graphique. Pour mettre la frontière en valeur, vous pouvez ajuster l’apparence de la ligne et des points qui l’entourent dans les paramètres du graphique.
Pour configurer les options d’affichage de la ligne frontière :
1. Survolez le panneau du nuage de points, puis cliquez sur l’icône d’engrenage pour ouvrir le volet latéral des paramètres du panneau.
2. Sélectionnez l’onglet **Annotations**.
3. Définissez les options :
* **Show run labels** : active ou désactive l’affichage d’une étiquette indiquant le nom du run ou du groupe.
* **Dim non-frontier points** : active ou désactive l’atténuation visuelle des points situés en dehors de la ligne frontière, afin de faire ressortir la frontière.
4. Cliquez sur **Apply** pour enregistrer vos modifications.
Le nuage de points est mis à jour en fonction de vos choix d’annotation.
Options d’affichage des lignes de référence
Une *ligne de référence* est une ligne pointillée horizontale ou verticale tracée à une valeur numérique fixe sur l’axe X ou Y. Les lignes de référence permettent de marquer des seuils, des points de comparaison ou des valeurs cibles sur un graphique.
Pour configurer des lignes de référence :
1. Survolez le panneau du nuage de points, puis cliquez sur l’icône d’engrenage pour ouvrir le volet latéral des paramètres du panneau.
2. Sélectionnez l’onglet **Lignes de référence**.
3. Cliquez sur **Add ligne de référence**.
4. Configurez la ligne :
* Pour choisir une couleur, cliquez sur l’échantillon de couleur.
* Sélectionnez **X axis** ou **Y axis** dans la liste déroulante.
* Saisissez une valeur numérique pour tracer la ligne à ce point de l’axe.
* Facultatif : saisissez un libellé.
5. Répétez l’opération pour ajouter d’autres lignes. Un compteur à côté de **Add ligne de référence** indique le nombre de lignes utilisées par rapport au maximum autorisé.
6. Cliquez sur **Apply** pour enregistrer vos modifications.
Le nuage de points est mis à jour en fonction de la configuration de vos lignes de référence.
Pour supprimer une ligne de référence, cliquez sur le bouton de fermeture () sur sa ligne.
Les lignes de référence présentent le comportement et les limites suivants :
* Vous pouvez ajouter jusqu’à cinq lignes de référence par graphique, tous axes confondus, et non cinq par axe.
* Seuls les axes numériques prennent en charge les lignes de référence ; ce n’est pas le cas des axes temporels. La liste déroulante des axes ne répertorie que les axes éligibles. Si ni l’axe X ni l’axe Y n’est numérique, l’onglet **Lignes de référence** affiche `Reference lines require a numeric X or Y axis.` et vous ne pouvez pas ajouter de ligne.
* Sur un axe à échelle logarithmique, la valeur d’une ligne de référence doit être strictement supérieure à zéro.
* Chaque ligne s’affiche en pointillés dans la couleur qui lui est attribuée. La couleur par défaut est le sarcelle.
* Le libellé affiché sur le graphique indique la valeur suivie du texte du libellé, par exemple `0.9 - Quality target`. Si vous laissez le libellé vide, le graphique n’affiche que la valeur. Le graphique tronque ce libellé combiné à 35 caractères, mais conserve le libellé complet dans la configuration du panneau.
* Lorsque des lignes sont proches les unes des autres, W\&B décale automatiquement leurs libellés pour éviter qu’ils ne se chevauchent.