コードの保存と比較

コードの保存を有効にし、コード比較を使って W&B runs 間でコードを比較し、Jupyter セッション履歴を取得します。

このページでは、コードの保存を有効にして、W&B runs 間で使用されたコードを比較し、Jupyter セッションで実行されたセルを確認する方法を説明します。コードを保存すると、実験の再現がしやすくなり、トレーニングコードの変更が結果にどのような影響を与えるかを把握しやすくなります。

デフォルトでは、W&B は最新の Git コミット ハッシュのみを保存します。追加のコード機能を有効にすると、UI で実験間のコードを比較できます。

wandb バージョン 0.8.28 以降では、W&B は wandb.init() を呼び出すメインのトレーニング ファイルのコードを保存できます。

​

ライブラリコードを保存

コードの保存を有効にすると、W&B は wandb.init() を呼び出したファイルのコードを保存します。追加のライブラリコードを保存するには、3 つの方法があります。

​

wandb.init の後で log_code を呼び出す

wandb.init() の後で wandb.Run.log_code(".") を呼び出します:

import wandb

with wandb.init() as run:
  run.log_code(".")

​

code_dir を設定した settings オブジェクトを渡す

code_dir を設定した settings オブジェクトを wandb.init() に渡します:

import wandb

wandb.init(settings=wandb.Settings(code_dir="."))

これにより、現在のディレクトリとその配下のすべてのサブディレクトリにある Python のソースコードファイルが、artifact として保存されます。W&B が保存するソースコードファイルのタイプや場所をより細かく指定するには、リファレンスドキュメントを参照してください。

​

UIでコードの保存を設定する

プログラムからコードの保存を設定するだけでなく、UIではチームまたは組織単位でデフォルトを設定することもできます。以下のセクションでは、チームレベルおよび組織レベルの設定について説明します。

​

チーム

デフォルトでは、W&B はすべてのチームでコードの保存を無効にしています。チームでこれを有効にするには、まず組織管理者が組織に対して有効にする必要があります。組織セクションをご覧ください。

チーム管理者は、チームの Settings ページを開き、Privacy セクションに移動して、そのチームの Runs に対する Enable code saving by default を設定できます。このオプションは、組織管理者が組織全体にコードの保存に関する制限を適用していない場合にのみ利用できます。画面の移動手順については、チームのプライバシー設定を構成するをご覧ください。

​

組織

組織管理者は、組織の Settings を開いて Privacy セクションに移動し、Enforce default code saving restrictions を有効にすることで、すべてのチームでコードの保存がデフォルトでオフのままになるよう設定できます。この強制設定が有効な間、チーム管理者はチームに対して Enable code saving by default をオンにできません。組織で利用できる制御項目の一覧については、Enforce privacy settings for all teams を参照してください。

​

コード比較

コード比較パネルには、Workspace 内で異なる W&B runs のコードが並べて表示されます。

異なるW&B runで使用されたコードを比較します。

1. ページの画面右上にある Add panels ボタンを選択します。
2. TEXT AND CODE のドロップダウンを展開し、Code を選択します。

​

Jupyter セッション履歴

W&B は、Jupyter ノートブックのセッションで実行されたコードの履歴を保存します。Jupyter 内で wandb.init() を call すると、W&B はフックを追加し、現在のセッションで実行されたコードの履歴を含む Jupyter ノートブックを自動的に保存します。

run の保存されたノートブック履歴を表示するには:

1. コードを含むプロジェクトのワークスペースにアクセスします。
2. プロジェクトのサイドバーで Artifacts タブを選択します。
3. code artifact を展開します。
4. Files タブを選択します。

これにより、セッション中に実行されたセルと、IPython の display method を call して生成された出力が表示されます。これにより、特定の run で Jupyter 内のどのコードが実行されたかを正確に確認できます。可能な場合、W&B はノートブックの最新バージョンも保存します。これは code ディレクトリ内にあります。