W&B Workspace は、チャートをカスタマイズし、モデルの結果を探索するためのあなただけのサンドボックスです。W&B Workspace は Tables と Panel sections で構成されています。
Tables : プロジェクトにログされたすべての runs が、そのプロジェクトのテーブルに一覧表示されます。runs の表示/非表示を切り替えたり、色を変更したり、テーブルを展開して各 run のメモ、config、サマリー メトリクスを確認したりできます。
Panel sections : 1 つ以上の パネル を含むセクションです。新しいパネルを作成して整理し、Workspace のスナップショットを保存するために Reports へエクスポートできます。
Workspace には大きく分けて Personal workspaces と Saved views の 2 つのカテゴリがあります。
Personal workspaces: モデルと Data Visualization を詳細に分析するためにカスタマイズ可能な workspace です。workspace の所有者だけが編集と変更の保存を行えます。チームメイトは Personal workspace を閲覧できますが、他の人の Personal workspace に変更を加えることはできません。
Saved views: Saved views は workspace の共同作業用スナップショットです。チーム内の誰でも、saved workspace views を閲覧、編集、および変更の保存ができます。Saved workspace views を使うと、experiments や runs などをレビューして議論できます。
次の画像は、Cécile-parker のチームメイトによって作成された複数の Personal workspaces を示しています。このプロジェクトには Saved views はありません。
ニーズに合わせた Workspace ビューで、チームでのコラボレーションを強化しましょう。Saved Views を作成して、好みのチャートやデータのレイアウトを整理しましょう。
新しい保存済み Workspace ビューを作成する
パーソナル Workspace または保存済みビューに移動します。
Workspace を編集します。
Workspace の右上にある action ( ) メニューをクリックします。Save as a new view をクリックします。
新しく保存したビューは、Workspace のナビゲーション メニューに表示されます。
保存すると、保存済みビューの以前の状態は上書きされます。保存していない変更は保持されません。W&B で保存済み Workspace ビューを更新するには、次の手順に従います。
保存済みビューに移動します。
Workspace 内のチャートやデータに対して、必要な変更を行います。
Save ボタンをクリックして、変更を確定します。
Workspace ビューへの更新内容を保存すると、確認ダイアログが表示されます。今後このプロンプトを表示したくない場合は、保存を確定する前に Do not show this modal next time オプションを選択します。
不要になった保存済みビューを削除します。
削除したい保存済みビューに移動します。
ビューの右上にある メニュー ( ) ボタンを選択します。
Delete view を選択します。
削除を確定して、そのビューをワークスペース メニューから削除します。
カスタマイズしたワークスペースの URL をチームと直接共有してください。ワークスペースのプロジェクトにアクセス権を持つすべてのユーザーは、そのワークスペースに保存された Views を表示できます。
既存のワークスペースと同じ設定を使用してワークスペースを作成するには、新しいワークスペースのデフォルト設定 の代わりに Workspace templates を使用します。
W&B では、ワークスペースには次のデフォルト設定が適用されます。
デフォルトでは、W&B では Workspace に空のセクションは表示されません。この設定を変更すると、Workspace に空のセクションを表示できます。
デフォルトでは、W&B はプロットタイトルでパネルをアルファベット順に並べ替えません。設定を変更して、プロットタイトルに基づいてパネルをアルファベット順に並べ替えることができます。
デフォルトでは、W&B はメトリクス名の先頭のプレフィックスに基づいてパネルをセクションにまとめます。たとえば、ワークスペースにメトリクス a/b/c/d と a/e/f が含まれている場合、W&B はこれらのメトリクスを a というセクションにまとめます。ワークスペースにメトリクス a/b/c/d と e/f/g が含まれている場合、W&B はこれらのメトリクスを a と e というセクションにまとめます。
セクションのデフォルトの構成方法を変更して、末尾のプレフィックスでグループ化することもできます。たとえば、ワークスペースにメトリクス a/b/c/d と a/e/f が含まれている場合、W&B はこれらのメトリクスを d と f というセクションにまとめます。ワークスペースにメトリクス a/b/c/d と e/f/g が含まれている場合、W&B はこれらのメトリクスを d と g というセクションにまとめます。
既定では、新しいワークスペースではラインプロットに対して次のデフォルト設定が使用されます:
X axis Default Value Step Log scale false
Y axis Default Log scale false
Smoothing Default Type Time weight EMA Weight 0 Show original after smoothing Off
Max number of runs Default Max runs 10
Data Default Point aggregation Full fidelity
Grouping Default Use grouping in charts On Group aggregation Mean
Display preferences Default Color run names On Display full run name Off Show X range in tooltip Off Tooltip runs Default Sync zoom across charts Off Show highlighted run only Off
任意のワークスペースを開くか、新しいワークスペースを作成します。
ワークスペースの右上にある Settings ボタンをクリックします。
パネルから Workspace layout を選択します。
好みに合わせてワークスペースの設定を行います。
ワークスペースの上部で、Undo と Redo の矢印アイコンの近くにある action ( ) メニューをクリックします。
Save personal workspace template をクリックします。
テンプレートの設定を確認し、Save をクリックします。
新しく作成するワークスペースでは、デフォルト設定ではなく、これらの設定が使用されます。
ワークスペーステンプレートの現在の設定を表示するには、次の手順を実行します。
任意のページの右上にあるユーザーアイコンを選択します。ドロップダウンから User Settings を選択します。
Personal workspace template セクションに移動します。ワークスペーステンプレートを使用している場合は、その設定が表示されます。使用していない場合、このセクションには何も表示されません。
ワークスペース テンプレートを更新するには、次の手順に従います。
任意のワークスペースを開きます。
ワークスペースの設定を変更します。たとえば、含める run の数を 11 に設定します。
変更内容をテンプレートに保存するには、Undo と Redo の矢印アイコン付近にある action ( ) メニューをクリックし、Update personal workspace template をクリックします。
設定を確認し、Update をクリックします。テンプレートが更新され、それを使用しているすべてのワークスペースに再適用されます。
ワークスペース テンプレートを削除してデフォルトの設定に戻すには、次の手順を実行します。
任意のページの右上にある user アイコンを選択し、ドロップダウンから User Settings を選択します。
Personal workspace template セクションに移動します。ワークスペース テンプレートの設定が表示されます。
Settings の横にあるゴミ箱アイコンをクリックします。
Dedicated Cloud と Self-Managed では、v0.70 以降でワークスペース テンプレートの削除がサポートされています。より古い Server バージョンでは、代わりにワークスペース テンプレートが default settings を使用するように更新してください。
wandb-workspaces は、W&B ワークスペースとレポートをプログラムで操作するための Python ライブラリです。
wandb-workspaces を使って、ワークスペースをプログラムで定義できます。wandb-workspaces は、W&B ワークスペースとレポートをプログラムで操作するための Python ライブラリです。
ワークスペースのプロパティとして、次のようなものを定義できます:
パネルのレイアウト、色、セクション順序を設定する。
既定の x 軸、セクション順序、折りたたみ状態などのワークスペース設定を構成する。
セクション内にパネルを追加およびカスタマイズして、ワークスペースビューを整理する。
URL を使って既存のワークスペースを読み込み、変更する。
既存のワークスペースへの変更を保存する、または新しいビューとして保存する。
シンプルな式を使って run をフィルタ、グループ化、ソートする。
色や公開範囲などの設定で run の見た目をカスタマイズする。
あるワークスペースから別のワークスペースへビューをコピーして、インテグレーションや再利用に役立てる。
wandb に加えて、wandb-workspaces もインストールしてあることを確認してください。
pip install wandb wandb-workspaces
Workspace ビューをプログラムから定義して保存する
import wandb_workspaces.reports.v2 as ws
workspace = ws.Workspace( entity = "your-entity" , project = "your-project" , views = [ ... ])
workspace.save()
existing_workspace = ws.Workspace.from_url( "workspace-url" )
existing_workspace.views[ 0 ] = ws.View( name = "my-new-view" , sections = [ ... ])
existing_workspace.save()
Workspace の saved view を別の Workspace にコピーする
old_workspace = ws.Workspace.from_url( "old-workspace-url" )
old_workspace_view = old_workspace.views[ 0 ]
new_workspace = ws.Workspace( entity = "new-entity" , project = "new-project" , views = [old_workspace_view])
new_workspace.save()
ワークスペース API の包括的なサンプルについては、wandb-workspace examples を参照してください。