Projects

モデルのバージョンを比較し、試作用のワークスペースで結果を探索し、メモや可視化を保存するためにレポートにエクスポートします

プロジェクトは、結果の可視化、実験の比較、アーティファクトの表示とダウンロード、オートメーションの作成などを行うための中心的な場所です。

各プロジェクトには、そのプロジェクトに誰がアクセスできるかを決定する可視性設定があります。プロジェクトへのアクセス権について詳しくは、Project visibility を参照してください。

各プロジェクトには、次のタブがあります。

• Overview：プロジェクトのスナップショット
• Workspace：個人用の可視化サンドボックス
• Runs：プロジェクト内のすべての run を一覧表示するテーブル
• Automations：プロジェクトで設定されたオートメーション
• Sweeps：自動探索と最適化
• Reports：ノートや run、グラフのスナップショットを保存したもの
• Artifacts：すべての run と、それぞれの run に関連付けられたアーティファクトを含みます

​

Overview タブ

W&B は、run を初期化するときに project フィールドに指定した名前のプロジェクトを作成します。

Overview タブから、プロジェクト名の確認やプロジェクトの管理ができます。

• プロジェクトの名前、説明、またはチームを変更するには、右上の Edit をクリックします。
• 最近削除した run を復元するには、右上の … をクリックしてから Undelete recently deleted runs をクリックします。
• プロジェクトを削除するには、右上の … をクリックしてから Delete project をクリックします。確認ダイアログを読み、指示に従ってください。プロジェクトの削除は元に戻せません。

Overview ページの残りの部分は、Details タブと Project Roles タブに分かれています。

​

詳細

プロジェクトの詳細には次の内容が含まれます:

• プロジェクトの公開範囲: プロジェクトの公開範囲。誰がアクセスできるかを決定する公開範囲の設定です。詳細は Project visibility を参照してください。
• 最終アクティブ日時: このプロジェクトに最後にデータがログされた時刻のタイムスタンプ
• 貢献者: このプロジェクトに貢献しているユーザーの数
• 合計 runs 数: このプロジェクト内の run の合計数
• 合計コンピュート時間: この合計値を得るために、プロジェクト内のすべての run の実行時間を合算します

詳細 タブには、プロジェクトのデータやメトリクスへのアクセスおよびエクスポート方法、スイープから最良のモデルをダウンロードする方法などの手順も含まれています。

ライブのサンプルプロジェクトを表示

Overview タブからプロジェクトの公開範囲を変更するには:

1. W&B アプリで、対象のプロジェクト内の任意のページから、左側のナビゲーションで Overview をクリックします。

2. 右上で Edit をクリックします。

3. Project visibility の新しいオプションを選択します:

   • Team (デフォルト): 自分のチームだけがプロジェクトを閲覧および編集できます。

   • Restricted: 招待されたメンバーだけがプロジェクトにアクセスでき、公開アクセスは無効になります。

   • Open: だれでも run を送信したりレポートを作成できますが、編集できるのは自分のチームだけです。授業、公開ベンチマークコンペティション、その他の永続性を求めない場面での利用にのみ適しています。

   • Public: だれでもプロジェクトを閲覧できますが、編集できるのは自分のチームだけです。

     W&B 管理者が Public の公開設定を無効にしている場合、それを選択することはできません。その代わり、閲覧専用の W&B Report を共有するか、W&B 組織の管理者に問い合わせてください。

4. Save をクリックします。

プロジェクトをより厳しいプライバシー設定に更新した場合、プロジェクトへのアクセス権を復元するために、個々のユーザーを再招待する必要が生じる場合があります。

​

プロジェクトロール

プロジェクトロールタブは、プロジェクトのオーナーとAdminロールを持つメンバーにのみ表示されます。プロジェクトにアクセスできるユーザーを一覧・検索したり、メンバーのロールを変更したりできます。

​

Workspace タブ

プロジェクトの workspace は、実験を比較するための個人用サンドボックスです。プロジェクトを使って、同じ問題に対して異なるアーキテクチャ、ハイパーパラメータ、データセット、前処理などで比較可能なモデルを整理します。

Runs サイドバー: プロジェクト内のすべての run の一覧です。

• ドットメニュー: サイドバー内の行にカーソルを合わせると、左側にメニューが表示されます。このメニューを使って run の名前変更、run の削除、またはアクティブな run の停止ができます。
• 表示アイコン: 目のアイコンをクリックして、グラフ上で run の表示／非表示を切り替えます。
• カラー: run の色を、用意されたプリセットまたはカスタムカラーに変更します。
• 検索: 名前で run を検索します。これはプロット内で表示される run のフィルタにもなります。
• フィルタ: サイドバーのフィルタを使って、表示する run の集合を絞り込みます。
• グループ: 例えばアーキテクチャなどの config 列を選択して、run を動的にグループ化します。グループ化すると、プロットには平均値に沿った線と、グラフ上の点の分散を表すシェーディング領域が表示されます。
• ソート: 例えば損失が最も低い run や精度が最も高い run など、run をソートする基準となる値を選びます。ソートはグラフに表示される run に影響します。
• 展開ボタン: サイドバーを全画面のテーブルに展開します。
• run 数: 上部のかっこ内の数字は、そのプロジェクト内の run の総数です。「(N visualized)」の数字は、目のアイコンがオンになっており、各プロットで可視化可能な run の数です。以下の例では、グラフには 183 件の run のうち最初の 10 件だけが表示されています。グラフを編集して、表示可能な run の最大数を増やしてください。

Runs タブ でカラムの固定、非表示、順序変更を行うと、Runs サイドバーにもそのカスタマイズ内容が反映されます。

Panels レイアウト: このワークスペースを使って結果を探索し、チャートの追加・削除を行い、異なるメトリクスに基づいてモデルのバージョンを比較します。

ライブ例を見る

​

パネルのセクションを追加する

セクションのドロップダウンメニューをクリックし、「Add section」をクリックしてパネル用の新しいセクションを作成します。セクション名を変更したり、ドラッグして並び替えたり、セクションを展開・折りたたみできます。

各セクションの右上には次のオプションがあります:

• Add section: ドロップダウンメニューから現在のセクションの上または下にセクションを追加するか、ページ下部のボタンをクリックして新しいセクションを追加します。
• Rename section: セクションのタイトルを変更します。
• Export section to report: このセクションのパネルを新しいレポートに保存します。
• Delete section: セクション全体とすべてのチャートを削除します。これはページ下部のWorkspaceバーにある元に戻すボタンで取り消すことができます。
• Add panel: ＋ボタンをクリックしてセクションにパネルを追加します。

​

セクション間でパネルを移動する

ドラッグ＆ドロップしてパネルの並び順を変更し、セクションごとに整理できます。パネル右上の「Move」ボタンをクリックして、パネルを移動するセクションを選択することもできます。

​

パネルのサイズ変更

すべてのパネルは同じサイズで、複数ページに分かれて表示されます。 セクションの右下隅にカーソルを合わせて表示されるコーナーアイコンを、クリックしてドラッグするとセクションのサイズを変更できます。

​

メトリクスを検索する

Workspace 内の検索ボックスを使って、パネルを絞り込みます。この検索ではパネルのタイトルが対象となり、タイトルにはデフォルトで可視化されているメトリクスの名前が使われます。

​

Runs タブ

Runs タブを使用して、run をフィルタリング、グループ化、ソートします。

以下のタブでは、Runs タブで実行できる一般的な操作を紹介します。

列のカスタマイズ

Runs タブには、プロジェクト内の run の詳細が表示されます。デフォルトでは多くの列が表示されます。

Runs タブをカスタマイズすると、その内容は Workspace タブ の Runs セレクタにも反映されます。

• すべての表示中の列を確認するには、ページを水平方向にスクロールします。
• 列の順序を変更するには、列を左右にドラッグします。
• 列を固定するには、列名にカーソルを合わせて表示されるアクションメニュー ... をクリックし、Pin column をクリックします。固定された列は、ページ左側の Name 列の直後に表示されます。固定を解除するには、Unpin column を選択します。
• 列を非表示にするには、列名にカーソルを合わせて表示されるアクションメニュー ... をクリックし、Hide column をクリックします。現在非表示になっているすべての列を表示するには、Columns をクリックします。
• 複数の列の表示／非表示、固定／固定解除をまとめて行うには、Columns をクリックします。
  • 非表示の列名をクリックすると、その列が再表示されます。
  • 表示中の列名をクリックすると、その列が非表示になります。
  • 表示中の列の横にあるピンアイコンをクリックすると、その列を固定できます。

ソート

次のいずれかの方法で、指定した列の値に基づいて Table 内のすべての行をソートできます。

1. 任意の列ヘッダーにカーソルを合わせたときに表示されるケバブメニュー（縦に並んだ 3 つの点）をクリックし、その列の値でテーブルをすばやくソートします。
2. Sort ボタンをクリックし、ドロップダウンから目的の列を選択します。このパネルでは、優先順位を付けて複数の列でソートできます。

上の画像は、val_acc という Table 列のソートオプションを表示する方法の例です。

フィルター

ダッシュボード左上の Filter ボタンを使って、式に基づいてすべての行をフィルタリングします。

New filter をクリックして、1 つ以上のフィルターを行に追加します。 フィルターを設定するための 3 つのドロップダウンメニューが表示されます。 左から順に、列名、演算子、フィルター値です。

グループ化

テーブル上部の Group ボタンをクリックすると、特定の列の値ごとにすべての行をグループ化できます。run のグループ化の詳細については、Organize runs into groups を参照してください。

​

Automations タブ

アーティファクトのバージョニングに関する後続アクションを自動化します。オートメーションを作成するには、トリガーとなるイベントと、それに応じて実行するアクションを定義します。アクションには、Webhook の実行や W&B ジョブの起動などが含まれます。詳細は、Automations を参照してください。

​

Sweeps タブ

このプロジェクトから新しい スイープ を開始します。

​

Reports タブ

1 か所で結果のスナップショットをすべて確認し、チームと知見を共有できます。

レポートを表示するには、プロジェクトのサイドバーから Reports タブを選択し、一覧からレポートを選択します。

​

Artifacts タブ

学習用データセットやファインチューニング済みモデル、メトリクスとメディアのテーブルなど、プロジェクトに関連付けられているすべてのartifactsを表示します。

​

メタデータパネル

メタデータパネルでは、アーティファクトのメタデータにアクセスできます。メタデータには、アーティファクトを再構築するために必要な設定用の引数、詳細情報を参照できる URL、アーティファクトをログした run 中に生成されたメトリクスなどが含まれる場合があります。 アーティファクトを生成した run の設定や履歴メトリクスを表示できます。

アーティファクトのメタデータを表示するには:

1. プロジェクトのサイドバーから Artifacts タブを選択します。
2. 一覧からアーティファクトを選択し、そのアーティファクトの最新バージョンの詳細ページを表示します。
3. Metadata タブを選択して、そのアーティファクトに関連付けられているメタデータを表示します。

​

Usage パネル

Usage パネルでは、Web アプリの外部、たとえばローカルマシン上でアーティファクトをダウンロードして利用するためのコードスニペットが表示されます。また、このセクションにはアーティファクトを生成した run と、そのアーティファクトを入力として利用している run が示され、それらへのリンクも表示されます。

アーティファクトを表示するには:

1. プロジェクトサイドバーから Artifacts タブを選択します。
2. 一覧からアーティファクトを 1 つ選択し、そのアーティファクトの最新バージョンの詳細ページを開きます。
3. Usage タブを選択して、コードスニペットと関連する run を表示します。

​

Files パネル

Files パネルには、そのアーティファクトに関連付けられたファイルとフォルダが一覧表示されます。W&B は特定のファイルを run ごとに自動的にアップロードします。たとえば、requirements.txt にはその run が使用した各ライブラリのバージョンが示され、wandb-metadata.json および wandb-summary.json には run に関する情報が含まれます。その他、run の設定に応じて、アーティファクトやメディアなどのファイルがアップロードされる場合があります。

アーティファクトにログされたファイルを表示するには:

1. プロジェクトのサイドバーから Artifacts タブを選択します。
2. 一覧からアーティファクトを選択して、そのアーティファクトの最新バージョンの詳細ページを表示します。
3. Files タブを選択して、そのアーティファクトに関連付けられたすべてのファイルを表示します。

​

Lineage パネル

Lineage パネルでは、プロジェクトに関連付けられているすべてのアーティファクトと、それら同士を結び付ける run を確認できます。run の種類はブロック、アーティファクトは円で表示され、特定の種類の run が特定の種類のアーティファクトを消費または生成する関係を矢印で示します。左側の列で選択したアーティファクトの種類がハイライト表示されます。

Explode トグルをオンにすると、すべての個々のアーティファクトバージョンと、それらを結び付ける特定の run を表示できます。

​

バージョンタブ

バージョンタブには、そのアーティファクトのすべてのバージョンが表示されます。特定のバージョンの詳細を表示するには、そのバージョンのアーティファクトを選択します。

1. プロジェクトのサイドバーから Artifacts タブを選択します。
2. 一覧からアーティファクトを選択して、そのアーティファクトの最新バージョンの詳細ページを表示します。
3. Versions タブを選択して、そのアーティファクトのすべてのバージョンを表示します。
4. ドロップダウン（アーティファクト名の横）から All Versions を選択します。

たとえば、前の画像は、"zoo-wyhak4p0" という名前のモデルアーティファクトに対する、異なるバージョンのモデルアーティファクトを示しています。

​

プロジェクトを作成する

W&B App から作成するか、wandb.init() の呼び出し時に project を指定してプログラムから作成できます。

W&B App

W&B App では、Projects ページまたはチームのランディングページからプロジェクトを作成できます。

Projects ページから:

1. 左上のグローバルナビゲーションアイコンをクリックします。プロジェクトのサイドバーが開きます。
2. ナビゲーションの Projects セクションで View all をクリックして、プロジェクト概要ページを開きます。
3. Create new project をクリックします。
4. Team を、このプロジェクトを所有するチーム名に設定します。
5. Name フィールドで、プロジェクト名を指定します。
6. Project visibility を設定します。デフォルトは Team です。
7. 必要に応じて Description を入力します。
8. Create project をクリックします。

チームのランディングページから:

1. 左上のグローバルナビゲーションアイコンをクリックします。プロジェクトのサイドバーが開きます。
2. ナビゲーションの Teams セクションで、チーム名をクリックしてそのランディングページを開きます。
3. ランディングページで Create new project をクリックします。
4. Team には、表示していたランディングページを所有するチームが自動的に設定されます。必要であればチームを変更します。
5. Name フィールドで、プロジェクト名を指定します。
6. Project visibility を設定します。デフォルトは Team です。
7. 必要に応じて Description を入力します。
8. Create project をクリックします。

Python SDK

プログラムからプロジェクトを作成するには、wandb.init() を呼び出すときに project を指定します。プロジェクトがまだ存在しない場合は自動的に作成され、指定した entity が所有者になります。例えば、次のようにします。

import wandb

with wandb.init(entity="<entity>", project="<project_name>") as run:
    run.log({"accuracy": .95})

wandb.init() の API リファレンスを参照してください。

​

プロジェクトにスターを付ける

プロジェクトにスターを付けて、そのプロジェクトを重要なものとしてマークします。自分やチームがスターで重要とマークしたプロジェクトは、組織のホームページの上部に表示されます。

たとえば、次の画像では zoo_experiment と registry_demo という 2 つのプロジェクトが重要としてマークされています。どちらのプロジェクトも、組織のホームページ上部の Starred projects セクション内に表示されています。

プロジェクトにスターを付ける方法は 2 つあります。プロジェクトの Overview タブから行う方法と、チームのプロフィールページから行う方法です。

Project overview

1. https://wandb.ai/<team>/<project-name> にアクセスして、W&B App 上の対象の W&B プロジェクトに移動します。
2. プロジェクトのサイドバーから Overview タブを選択します。
3. 右上の Edit ボタンの横にあるスターアイコンをクリックします。

Team profile

1. https://wandb.ai/<team>/projects にアクセスして、チームのプロフィールページに移動します。
2. Projects タブを選択します。
3. スターを付けたいプロジェクトの横にマウスカーソルを移動します。表示されるスターアイコンをクリックします。

たとえば、次の画像では “Compare_Zoo_Models” プロジェクトの横にスターアイコンが表示されています。

アプリ左上の組織名をクリックして、対象のプロジェクトが組織のホームページ（ランディングページ）に表示されていることを確認します。

​

プロジェクトを削除する

Overview タブ右側にある三点アイコンをクリックして、プロジェクトを削除できます。

1. W&B の対象プロジェクトを開きます。
2. プロジェクトのサイドバーから Overview タブを選択します。
3. 右上隅の三点アイコン（メニュー）を選択します。
4. ドロップダウンメニューから Delete project を選択します。

プロジェクトを削除しても、W&B はアクティブな sweeps やエージェントを終了しません。

​

プロジェクトにメモを追加する

プロジェクトには、概要説明として、または Workspace 内の Markdown パネルとしてメモを追加できます。

​

プロジェクトに概要説明を追加する

ページに追加した説明は、プロフィールの Overview タブに表示されます。

1. 対象の W&B プロジェクトに移動します
2. プロジェクトのサイドバーから Overview タブを選択します
3. 右上隅の Edit を選択します
4. Description フィールドにメモを追加します
5. Save ボタンを選択します

run を比較する説明用メモを作成するには Reports を使用する

W&B Report を作成して、プロットと Markdown を横に並べて表示することもできます。セクションを分けて異なる run を表示し、取り組んだ内容をストーリーとして伝えられます。

​

run の Workspace にメモを追加する

1. 自分の W&B プロジェクトに移動する
2. プロジェクトのサイドバーから Workspace タブを選択する
3. 画面右上の Add panels ボタンを選択する
4. 表示されるモーダルで TEXT AND CODE ドロップダウンを選択する
5. Markdown を選択する
6. ワークスペースに表示される Markdown パネル内にメモを追加する