Enregistrer et comparer le code

Utilisez W&B pour enregistrer votre code, comparer le code d’un run à l’autre, afficher les modifications locales et capturer l’historique de session Jupyter.

Activer l’enregistrement du code

Configurez l’enregistrement du code pour votre équipe ou votre organisation. Les contrôles au niveau de l’équipe et de l’organisation sont décrits dans Configurer les paramètres de confidentialité.

Par défaut, W&B désactive l’enregistrement du code pour toutes les équipes. Pour que vous puissiez l’activer pour une équipe, un administrateur de l’organisation doit laisser l’option Disable default code saving désactivée pour l’organisation. Voir la section Organisation.

Équipe

Pour activer l’enregistrement du code pour une équipe en tant qu’administrateur d’équipe, accédez à la page Settings, puis à la section Privacy, et configurez Enable code saving by default pour les runs de cette équipe. Cette option n’est disponible que si aucun administrateur de l’organisation n’a activé Disable default code saving pour l’ensemble de l’organisation. Pour connaître la marche à suivre, consultez Configurer les paramètres de confidentialité d’une équipe.

Organisation

En tant qu’administrateur de l’organisation, accédez à Settings, sélectionnez Privacy, puis utilisez Disable default code saving dans la section Project and content security pour définir si l’enregistrement du code est désactivé par défaut pour toutes les équipes. Tant que ce paramètre est activé, les administrateurs d’équipe ne peuvent pas activer Enable code saving by default pour leur équipe. Pour consulter la liste complète des contrôles au niveau de l’organisation, voir Appliquer les paramètres de confidentialité à toutes les équipes.

Enregistrer le code

Capturez le code source ayant produit un run sous forme d’artifact. L’artifact de code peut être consulté dans le workspace de votre projet. Il existe deux façons d’enregistrer le code : une approche précise, au cas par cas, et une approche automatique.

Contrôle précis

Utilisez wandb.Run.log_code() pour journaliser des fichiers ou des répertoires spécifiques sous forme d’artifact. Par défaut, W&B parcourt le répertoire courant et journalise tous les fichiers portant l’extension .py. L’exemple suivant montre comment utiliser wandb.Run.log_code() pour journaliser le répertoire courant :

import wandb

with wandb.init() as run:
    # Journaliser le répertoire courant sous forme d’artifact de code
    run.log_code(root=".")

L’exemple suivant montre comment utiliser wandb.Run.log_code() avec les paramètres include_fn= et exclude_fn= pour indiquer les fichiers à inclure et à exclure lors de la journalisation du code :

import wandb

with wandb.init() as run:
    run.log_code(
         root="../",
         include_fn=lambda path: path.endswith(".py") or path.endswith(".ipynb"),
         exclude_fn=lambda path, root: os.path.relpath(path, root).startswith(
             "cache/"
         ),
    )

Pour contrôler plus finement les types et les emplacements des fichiers de code source enregistrés par W&B, consultez la documentation de référence.

Capturer automatiquement le code

Utilisez wandb.init(settings=wandb.Settings(code_dir=)) pour capturer automatiquement tout le code du répertoire courant et de ses sous-répertoires. Par défaut, W&B capture :

Les fichiers portant l’extension .py
requirements.txt
Dockerfile
Tout ce qui se trouve sous wandb/ ou .wandb/ est exclu

L’exemple suivant montre comment capturer tout le code du répertoire courant et de ses sous-répertoires :

import wandb

with wandb.init(settings=wandb.Settings(code_dir=".")) as run:
    # Placez votre code d’entraînement ici

Vous pouvez également indiquer un autre répertoire en remplaçant . par le chemin du répertoire que vous souhaitez capturer.

Afficher les modifications locales

W&B génère des fichiers diff lorsque vous journalisez du code comportant des modifications indexées ou non indexées dans votre dépôt Git. Vous pouvez ensuite consulter ces modifications dans l’interface W&B. W&B nomme les fichiers diff diff.patch ou diff_<sha>.patch. Ces fichiers contiennent les modifications de code locales qui n’ont pas encore été validées dans Git, par rapport à HEAD. Pour afficher les fichiers diff :

Accédez au workspace de votre projet.
Dans la barre latérale gauche, cliquez sur Workspace.
Dans le sélecteur de runs, sélectionnez le run dont vous souhaitez afficher le diff.
Sur la page Overview du run, sélectionnez l’onglet Files.
Dans la liste des fichiers, sélectionnez le fichier diff.patch ou diff_<sha>.patch.
Sélectionnez un fichier dans la liste pour développer son diff.

W&B propose deux modes d’affichage du diff entre les runs : unifié et scindé.

La vue unifiée affiche le diff dans un seul volet :
La vue scindée affiche le diff dans deux volets côte à côte :

Pour basculer entre les deux vues, sélectionnez le bouton Unified ou Split dans le coin supérieur droit de la vue du diff, sous le bouton Download.

Historique de session Jupyter

W&B enregistre l’historique du code exécuté dans votre session de notebook Jupyter. Lorsque vous appelez wandb.init() dans Jupyter, W&B ajoute un hook qui enregistre automatiquement un notebook Jupyter contenant l’historique du code exécuté au cours de votre session actuelle.

Accédez au workspace du projet qui contient votre code.
Sélectionnez l’onglet Artifacts dans la barre latérale du projet.
Développez l’artifact code.
Sélectionnez l’onglet Files.

Cet onglet affiche les cellules exécutées dans votre session, ainsi que toutes les sorties générées par des appels à la méthode display d’IPython. Vous pouvez ainsi voir précisément quel code a été exécuté dans Jupyter pour un run donné. Dans la mesure du possible, W&B enregistre également la version la plus récente du notebook, que vous trouverez elle aussi dans le répertoire code.

Comparer le code entre plusieurs runs

Comparez le code utilisé dans différents runs W&B :

Cliquez sur le bouton Add panels dans le coin supérieur droit de la page.
Développez la liste déroulante TEXT AND CODE, puis sélectionnez Code.

​Activer l’enregistrement du code

​Équipe

​Organisation

​Enregistrer le code

​Contrôle précis

​Capturer automatiquement le code

​Afficher les modifications locales

​Historique de session Jupyter

​Comparer le code entre plusieurs runs

Activer l’enregistrement du code

Équipe

Organisation

Enregistrer le code

Contrôle précis

Capturer automatiquement le code

Afficher les modifications locales

Historique de session Jupyter

Comparer le code entre plusieurs runs