メインコンテンツへスキップ
run は、W&B によってログされる 1 回の計算単位です。W&B Run は、プロジェクト全体を構成する最小単位と考えることができます。つまり、各 run は特定の計算の記録であり、たとえばモデルをトレーニングして結果をログしたものや、ハイパーパラメーター sweeps などが該当します。 run を初期化してログする一般的なユースケースには、次のようなものがあります。 W&B run を初期化するには、W&B Python SDK の wandb.init() method を呼び出します。これにより新しい run が開始され、run にメトリクス、Artifacts、そのほかの情報をログするために使用できる wandb.Run object が返されます。run の初期化の詳細は、Initialize runs を参照してください。 各 run object には、run ID と呼ばれる一意の識別子があります。一意の ID を指定することも、W&B にランダムに生成させることもできます。また、各 run object には、人が読める重複可能な run 名 もあります。run に名前を指定することも、W&B にランダムに生成させることもできます。run 名は初期化後に変更できます。 W&B は run をプロジェクトにログします。run を wandb.init(project="") で初期化するときにプロジェクトを指定します。プロジェクトが存在しない場合、W&B は新しいプロジェクトを作成します。プロジェクトがすでに存在する場合、W&B は指定したプロジェクトに run をログします。
プロジェクト名を指定しない場合、W&B は Uncategorized という名前のプロジェクトに run を保存します。
wandb.init() は、ID、名、設定、state などの run のプロパティを含む wandb.Run object を返します。wandb.Run.log()wandb.Run.log_code()wandb.Run.use_artifact() などの methods を使って、run object から run にメトリクス、Artifacts、そのほかの情報をログできます。 各 run には、その run の現在のステータスを表す state があります。利用可能な run state の一覧については、Run states を参照してください。 W&B App の run のプロジェクトワークスペース内で、runs とそのプロパティを表示できます。wandb.Api.Run object を使って、プログラムから run のプロパティにアクセスすることもできます。 例として、W&B run を初期化し、いくつかのメトリクスをログする次のコードスニペットを見てみましょう。
以下のコードスニペットを一緒に試したい場合は、コードスニペット内の entity 変数に W&B entity を指定してください。entity は、W&B のユーザー名またはチーム名です。W&B App ワークスペースの URL で確認できます。たとえば、ワークスペース URL が https://wandb.ai/nico/awesome-project の場合、entity は nico です。
1 行目では W&B Python SDK をインポートします。2 行目では、entity nico 配下のプロジェクト awesome-project で run を初期化します。3 行目では、その run にモデルの精度と損失をログします。 ターミナルでは、W&B は次を返します:
W&B は、ターミナル出力に 2 つの URL を返します。1 つ目の URL は 特定の run の Workspace に移動し、2 つ目の URL は プロジェクト ページに移動します。
単一の run の Workspace
ある 1 時点だけでメトリクスをログしても、あまり有用ではないことがあります。識別モデルのトレーニングでは、一定間隔でメトリクスをログするほうが、より現実的な例です。たとえば、次のコードスニペットを考えてみましょう。
トレーニングスクリプトは wandb.Run.log() を 10 回呼び出します。スクリプトが wandb.Run.log() を呼び出すたびに、W&B はそのエポックの精度と損失をログします。 ターミナルには、次のような出力が表示されるはずです。
W&B は、jolly-haze-4 という 1 つの run 内に、シミュレートされたトレーニングループを記録します。これは、スクリプトが wandb.init() method を 1 回しか呼び出さないためです。 前の出力で W&B が表示した URL をブラウザにコピー&ペーストしてください。その URL を開くと、W&B App UI の 해당 run の Workspace が表示されます。たとえば、次の画像は run jolly-haze-4 の Workspace を示しています。
メトリクスがログされたトレーニング run